672d455467
Hardening-проход перед первой сборкой на Debian. Три из найденного не воспроизводились ни на одном dry-run и проявились бы только на живом сервере. Установка * preflight внутри install вызывался дважды и оба раза проверял clean-host. Ко второму вызову на диске лежал собственный /var/lib/hy2xs/install-state.json, записанный после первого preflight, и опознавался как маркер посторонней установки: КАЖДАЯ чистая установка падала сразу после apt-get с fatal_post_apply и оставляла сервер наполовину настроенным. Чистота хоста — условие входа в операцию, возможности платформы проверяются уже внутри PHASE 1, поэтому checkCleanHost стал отдельным параметром без умолчания. * PHASE 1 начиналась в install.sh: shell сам создавал /usr/local/lib/hy2xs, ставил бинарник, вешал symlink и копировал runtime-пакет, и только потом запускал оркестратор с его собственным preflight. Отказ того preflight объявлялся fatal_pre_apply — «на сервере ничего не изменено» — при уже созданном каталоге оркестратора. Отследить владение мутацией невозможно, пока мутируют двое: install.sh больше не изменяет ничего, раскладку выполняет steps/bootstrap.ts под ownership.bootstrapTouched, пути попали в owned_paths. Как следствие удалено деление clean-host на фазы. * diagnosticsCollect стояла перед rollback обычным await в install и в reconfigure. На заполненном диске она падает сама и отменяла откат целиком. Диагностика — best effort, откат — обязателен. * reconfigure/repair выбирали записываемую фазу отказа регулярным выражением по тексту ошибки. Переведено на ownership-флаги. Секреты * Журнал админки писал RequestURI, то есть путь вместе с query. Hysteria обращается к /internal/hysteria/auth?access_token=<секрет> при каждом подключении пира, поэтому действующий machine token оседал открытым текстом в hy2xs-admin.log, который отдаётся через ExportLog и попадает в diagnostics-бандл. Логируется путь; значения query не пишутся, имена — пишутся. Канала было два: gin.Default() печатает path?query в stdout, оттуда в journald и в тот же бандл, — панель переведена на gin.New() + Recovery(). Журналы внутри бандла и журнал Hysteria из ExportLog теперь проходят санитайз. Сравнение токена — constant time. * Config API позволял прочитать и подменить ключи приложения: getConfig и listConfig принимали произвольный ключ, а проверка записи была denylist'ом из трёх ключей оркестратора. Запрос ?key=PEER_SECRET_ENCRYPTION_KEY отдавал master-key шифрования секретов пиров. Доступ переведён на allowlist, маршрут getConfig удалён целиком — потребителей у него не было ни одного. Пиры * Импорт применялся по одной записи вне транзакции, вопреки собственному контракту. Валидация не знает, что уже лежит в базе: cross-conflict по UNIQUE(name) оставлял часть файла применённой. Применение выполняется одной транзакцией, криптоматериал считается до её открытия. * Файл импорта мог содержать хвостовой JSON-документ, который молча не применялся. После разбора проверяется io.EOF. * Экспорт разделён на «Экспорт настроек» и «Резервная копия» с секретами и подтверждением: обычный экспорт выдаёт пирам новые секреты при импорте, и прежние клиентские ссылки после переноса переставали работать. Сборка * Два stale-грепа в приёмке роняли build.sh в самом конце, внутри verify_archive. Первый искал в smoke.ts исчезнувший литерал URL, второй совпадал с router_test.go, который перечисляет удалённые маршруты, потому что проверяет их отсутствие: добавление регрессионного теста ломало сборку. * verify_archive требовал наличия мутирующей строки в install.sh. Инвариант перевёрнут: их не должно быть ни одной. Очистка * Удалены entity.LegacyAccount, миграции 002/003 и мёртвые хелперы listSQLMigrationFiles и envInt: v1 не мигрирует базу 0.x ни при каком сценарии. Номера оставшихся миграций сохранены. H UI-словарь убран из обычных доков, в docs/14 он остаётся — там это имена объектов для удаления. * Список непубличных IPv4 приведён к IANA Special-Purpose Address Registry: 203.0.113.5 из RFC-примеров считался публичным адресом сервера. Отказ резолвера отделён от отсутствия A-записи. Проверено: bun test 233, go test 71, tsc/vue-tsc, bash -n 11 скриптов, приёмка прогнана против дерева.
133 lines
4.0 KiB
Go
133 lines
4.0 KiB
Go
package cmd
|
||
|
||
import (
|
||
"errors"
|
||
"fmt"
|
||
"github.com/gin-gonic/gin"
|
||
"github.com/sirupsen/logrus"
|
||
"hy2xs-admin/dao"
|
||
"hy2xs-admin/middleware"
|
||
"hy2xs-admin/model/constant"
|
||
"hy2xs-admin/router"
|
||
"hy2xs-admin/service"
|
||
"hy2xs-admin/util"
|
||
"net"
|
||
"net/http"
|
||
"os"
|
||
"path/filepath"
|
||
"strconv"
|
||
"strings"
|
||
)
|
||
|
||
func resolveUiBindHost() (string, error) {
|
||
host := os.Getenv("HY2XS_UI_BIND_HOST")
|
||
if host == "" {
|
||
host = "127.0.0.1"
|
||
}
|
||
ip := net.ParseIP(host)
|
||
if ip == nil || ip.To4() == nil {
|
||
return "", errors.New("HY2XS_UI_BIND_HOST must be IPv4")
|
||
}
|
||
return host, nil
|
||
}
|
||
|
||
// resolveUiPort проверяет порт, полученный из контракта запуска.
|
||
//
|
||
// Источник истины — HY2XS_UI_PORT, который оркестратор подставляет в ExecStart
|
||
// как `-p`. Раньше это значение по дороге записывалось в SQLite и читалось
|
||
// оттуда обратно: круг, в котором база не добавляла ни одного факта, но делала
|
||
// вид, что порт принадлежит ей.
|
||
func resolveUiPort(port string) (int, error) {
|
||
trimmed := strings.TrimSpace(port)
|
||
if trimmed == "" {
|
||
return 0, errors.New("UI port is required: pass -p <port>")
|
||
}
|
||
value, err := strconv.Atoi(trimmed)
|
||
if err != nil || value < 1 || value > 65535 {
|
||
return 0, fmt.Errorf("port: %s is invalid", port)
|
||
}
|
||
return value, nil
|
||
}
|
||
|
||
func runServer(port string) error {
|
||
defer releaseResource()
|
||
|
||
middleware.InitLog()
|
||
|
||
uiPort, err := resolveUiPort(port)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
bindHost, err := resolveUiBindHost()
|
||
if err != nil {
|
||
return err
|
||
}
|
||
|
||
if err := initFile(); err != nil {
|
||
return err
|
||
}
|
||
if err := dao.InitSql(); err != nil {
|
||
return err
|
||
}
|
||
if err := middleware.InitCron(); err != nil {
|
||
return err
|
||
}
|
||
if err := service.InitHysteria2(); err != nil {
|
||
return err
|
||
}
|
||
|
||
// gin.New(), а не gin.Default().
|
||
//
|
||
// gin.Default() подключает gin.Logger(), который печатает в stdout путь
|
||
// ВМЕСТЕ с query string. Для админки это второй, независимый от logrus
|
||
// канал журналирования: stdout юнита уезжает в journald, а diagnostics
|
||
// кладёт `journalctl -u hy2xs-admin` в бандл. Пока он существовал,
|
||
// machine token из /internal/hysteria/auth?access_token=… утекал в
|
||
// журнал даже после того, как из собственного логгера админки query
|
||
// string убрали.
|
||
//
|
||
// HTTP-логгер у продукта ровно один — middleware.LogHandler, и он
|
||
// подключается пофазно в router.Router. Здесь остаётся только Recovery:
|
||
// паника в обработчике не должна ронять сервис.
|
||
r := gin.New()
|
||
r.Use(gin.Recovery())
|
||
router.Router(r)
|
||
|
||
// TLS внутри админки не поддерживается намеренно: панель слушает
|
||
// loopback и публикуется через SSH-туннель или reverse proxy, на котором
|
||
// TLS и заканчивается.
|
||
service.InitServer(fmt.Sprintf("%s:%d", bindHost, uiPort), r)
|
||
if err := service.StartServer(); err != nil && err != http.ErrServerClosed {
|
||
logrus.Errorf("start server err: %v", err)
|
||
return errors.New("start server err")
|
||
}
|
||
return nil
|
||
}
|
||
|
||
func releaseResource() {
|
||
if err := dao.CloseSqliteDB(); err != nil {
|
||
logrus.Errorf(err.Error())
|
||
}
|
||
if err := service.ReleaseHysteria2(); err != nil {
|
||
logrus.Errorf(err.Error())
|
||
}
|
||
}
|
||
|
||
func initFile() error {
|
||
var dirs = []string{
|
||
constant.LogDir,
|
||
constant.SqliteDBDir,
|
||
constant.BinDir,
|
||
filepath.Dir(constant.SqliteDBPath),
|
||
}
|
||
for _, item := range dirs {
|
||
if !util.Exists(item) {
|
||
if err := os.MkdirAll(item, 0o750); err != nil {
|
||
logrus.Errorf("%s create err: %v", item, err)
|
||
return errors.New(fmt.Sprintf("%s create err", item))
|
||
}
|
||
}
|
||
}
|
||
return nil
|
||
}
|