fix(v1): разблокировать сборку, починить жизненный цикл cron и закрыть каналы утечки
Сборка не собиралась: два контракта приёмки роняли её на корректном коде.
verify_api_namespace_contract искал возвращение legacy-пространства имён
через grep по '/hui' и находил router_test.go, который ПЕРЕЧИСЛЯЕТ этот
префикс, чтобы доказать отсутствие маршрута, и сам versions.sh, где строка
стоит в тексте проверки. Падение приходило шестым шагом из четырнадцати, до
резолва Hysteria. За ним прятался второй такой же: проверка транзакционности
импорта пиров брала файл от начала applyPeerImportEntry и до конца, захватывая
объявленные ниже ExistPeerName и UpdatePeerLastConnectionAt.
Обе проверки теперь смотрят на код, а не на упоминания: добавлены помощники
code_without_comments и code_mentions_in, а отсутствие legacy-маршрута
доказывает тест на таблице маршрутов собранного роутера.
Планировщик стал собственностью процесса. InitCron вызывался из runServer и
на каждом вызове создавал новый cron.New(), не сохраняя ссылку; cron.Stop()
не вызывался нигде. Смена RESET_TRAFFIC_CRON выполняла StopServer(), точка
входа крутила for { runServer() } — и каждая правка добавляла целый
дублирующий набор джоб, а старое расписание сброса продолжало работать.
Фиксированные джобы регистрируются один раз, расписание переносится на месте
по EntryID, HTTP-сервер не трогается. Добавлено штатное завершение по SIGTERM.
Выражение проверяется до записи в базу тем же парсером (cron.ParseStandard),
которым его разбирает планировщик: раньше невалидная строка сохранялась, API
отвечал успехом, а сброс трафика молча исчезал.
updateConfigs стал атомарным: полная проверка партии, одна транзакция,
применение к рантайму. Прежний тест ставил запрещённый ключ первым и не
смотрел в базу — поймать частичное применение он был неспособен.
Удалены четыре ключа таблицы config без единого потребителя: HYSTERIA2_ENABLE,
HYSTERIA2_CONFIG (второй источник истины, читался первым), HYSTERIA2_TRAFFIC_TIME
и HYSTERIA2_CONFIG_REMARK. Имя профиля в share URI выводится из имени пира.
Безопасность:
- bootstrap-пароль администратора больше не генерируется и не пишется в журнал,
который отдаётся кнопкой выгрузки; отсутствие env — отказ старта;
- собственный журнал админки санитизируется наравне с чужим;
- golang-jwt/jwt v3 -> v5: GO-2025-3553 не имеет исправленной версии в v3 и
достижима с неаутентифицированного запроса; набор алгоритмов подписи
зафиксирован через WithValidMethods;
- удалён вход по несолёному SHA-224 из предыдущего поколения;
- убран modulo bias в util.RandomString — единственном генераторе секретов;
- пир установщика защищён во всех путях записи, а не только в импорте;
- удалена латентная паника в service.GetToken и недостижимая ветка GetAdminInfo,
проверявшая меньше, чем middleware.
Toolchain: Go 1.21.13 -> 1.26.7, Node 20.19.0 (EOL) -> 24.20.0. На прежнем
графе govulncheck находил 21 вызываемую уязвимость, 17 из них в stdlib,
попадающей в production-бинарь. Сейчас — ноль. Добавлен обязательный шаг
проверки зависимостей (govulncheck + pnpm audit) с записью результата в
metadata пакета.
This commit is contained in:
@@ -280,6 +280,66 @@ Update the DNS A record before using this server.
|
||||
`HY2XS_ADMIN_INITIAL_PASSWORD` и `HY2XS_ADMIN_CON_PASS` используются только как bootstrap-данные при первичной установке.
|
||||
Для ротации существующих credentials нужен отдельный flow на уровне account-management.
|
||||
|
||||
### `hy2xs-admin` не стартует: «HY2XS_ADMIN_INITIAL_PASSWORD не задан»
|
||||
|
||||
Означает, что учётной записи администратора в базе нет, а переменной, из которой
|
||||
её положено создать, — тоже.
|
||||
|
||||
Придумывать пароль самостоятельно админка не будет: такой пароль не знал бы
|
||||
никто, кроме журнала, а раньше именно он туда и попадал открытым текстом.
|
||||
Сообщение говорит о повреждённом контракте запуска.
|
||||
|
||||
Что проверять:
|
||||
|
||||
```bash
|
||||
systemctl cat hy2xs-admin | grep EnvironmentFile
|
||||
grep -c '^HY2XS_ADMIN_INITIAL_PASSWORD=' /etc/hy2xs/hy2xs.env
|
||||
grep -c '^ADMIN_INITIAL_PASSWORD=' /etc/hy2xs/bootstrap-admin.secret
|
||||
```
|
||||
|
||||
Починка — `hy2xs-orchestrator repair --allow-partial-state`: значения принадлежат
|
||||
оркестратору, он же приводит `hy2xs.env` и `bootstrap-admin.secret` в
|
||||
согласованное состояние.
|
||||
|
||||
Аналогичное сообщение про `HY2XS_ADMIN_CON_PASS` относится к пиру установщика.
|
||||
Его секрет продублирован в `bootstrap-admin.secret`, откуда его читает проверка
|
||||
machine-auth, поэтому придуманный секрет разошёлся бы с файлом и первая же
|
||||
проверка подключения провалилась бы.
|
||||
|
||||
### Забыт пароль администратора
|
||||
|
||||
```bash
|
||||
systemctl stop hy2xs-admin
|
||||
set -a; . /etc/hy2xs/hy2xs.env; set +a
|
||||
"$HY2XS_INSTALL_DIR/hy2xs-admin" reset-admin
|
||||
systemctl start hy2xs-admin
|
||||
```
|
||||
|
||||
Runtime env подключается намеренно: из него берутся пути к базе и журналу
|
||||
(`HY2XS_DATA_DIR`, `HY2XS_LOG_DIR`) — те же, с которыми работает юнит.
|
||||
|
||||
Команда печатает новые логин и пароль в консоль и требует смены пароля при
|
||||
первом входе. Работает поверх существующей установки; на машине без базы она
|
||||
осмысленно откажет — это инструмент восстановления, а не установки.
|
||||
|
||||
### Автоматический сброс трафика не срабатывает
|
||||
|
||||
Проверьте сохранённое расписание:
|
||||
|
||||
```bash
|
||||
journalctl -u hy2xs-admin | grep RESET_TRAFFIC_CRON
|
||||
```
|
||||
|
||||
Невалидное выражение теперь отклоняется API до записи в базу, поэтому попасть в
|
||||
это состояние можно только правкой базы в обход продукта. Планировщик в таком
|
||||
случае поднимается без джобы сброса и пишет ERROR — старт сервиса при этом не
|
||||
прерывается намеренно: на панели висит `/internal/hysteria/auth`, и её отказ
|
||||
положил бы подключения пользователей.
|
||||
|
||||
Починка — сохранить корректное значение в разделе настроек панели; оно
|
||||
применяется сразу, без перезапуска сервиса. Пустое значение — легальное и
|
||||
означает «автоматический сброс выключен».
|
||||
|
||||
## Правила эксплуатации
|
||||
|
||||
1. Не править сервер как будто на нём есть builder.
|
||||
|
||||
Reference in New Issue
Block a user