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:
@@ -59,16 +59,19 @@ HY2XS_TARGET_OS=debian
|
||||
HY2XS_TARGET_OS_VERSION=13
|
||||
HY2XS_TARGET_ARCH=amd64
|
||||
|
||||
GO_VERSION=1.21.13
|
||||
GO_VERSION=1.26.7
|
||||
GO_LINUX_AMD64_SHA256=<sha256>
|
||||
BUN_VERSION=1.3.13
|
||||
BUN_LINUX_X64_SHA256=<sha256>
|
||||
BUN_LINUX_X64_BASELINE_SHA256=<sha256>
|
||||
NODE_VERSION=20.19.0
|
||||
NODE_VERSION=24.20.0
|
||||
NODE_LINUX_X64_SHA256=<sha256>
|
||||
PNPM_VERSION=9.15.9
|
||||
|
||||
HYSTERIA_CHANNEL=stable
|
||||
|
||||
GOVULNCHECK_VERSION=v1.7.0
|
||||
PNPM_AUDIT_LEVEL=high
|
||||
```
|
||||
|
||||
Чего в нём **нет** и быть не должно:
|
||||
@@ -86,6 +89,47 @@ HYSTERIA_CHANNEL=stable
|
||||
выбирает `bun-linux-x64` или `bun-linux-x64-baseline` по наличию AVX2, поэтому
|
||||
одной контрольной суммы архитектурно недостаточно.
|
||||
|
||||
### Почему версии toolchain — это вопрос безопасности, а не удобства
|
||||
|
||||
Go здесь не просто сборщик: им компилируется `hy2xs-admin`, и его stdlib целиком
|
||||
попадает в production-бинарь. Поэтому версия выбирается по политике поддержки Go
|
||||
(major поддерживается, пока не вышли две более новые), а не по тому, на чём
|
||||
собиралось раньше.
|
||||
|
||||
Цифры, ради которых это записано. На `GO_VERSION=1.21.13` — линия, давно вне
|
||||
поддержки — `govulncheck ./...` находил **21 вызываемую уязвимость**, из них 17 в
|
||||
одной только stdlib. После перехода на 1.26.7 и обновления графа зависимостей —
|
||||
**ноль**.
|
||||
|
||||
Node живёт только на build-хосте и в артефакт не попадает, но 20.x достигла EOL,
|
||||
то есть перестала получать security-обновления, а собирает она код, который
|
||||
уезжает в production. Отсюда LTS-линия 24.
|
||||
|
||||
Bun обновляется отдельно от остальных: оркестратор собирается через
|
||||
`bun build --compile`, то есть Bun runtime физически входит в исполняемый файл.
|
||||
Смена его minor-версии — это смена рантайма внутри артефакта, и она требует
|
||||
полного прохода `bun test → tsc → compile → приёмка на Debian`, а не строки в
|
||||
общем патче.
|
||||
|
||||
### Проверка зависимостей на уязвимости
|
||||
|
||||
`tools/build/lib/security.sh` — обязательный шаг сборки между тестами админки и
|
||||
записью metadata:
|
||||
|
||||
| Проверка | Что покрывает | Порог |
|
||||
| --- | --- | --- |
|
||||
| `govulncheck ./...` | Go-граф **и stdlib**, с анализом достижимости: уязвимость считается только при наличии пути вызова из нашего кода | любая вызываемая |
|
||||
| `pnpm audit --prod` | production-зависимости frontend, без анализа достижимости | `PNPM_AUDIT_LEVEL` |
|
||||
|
||||
Версия `govulncheck` пиньтся в `versions.env`, а база уязвимостей подтягивается
|
||||
на каждом запуске: пин инструмента не должен превращаться в пин знаний о мире.
|
||||
|
||||
Аварийный выход — `ALLOW_VULNERABLE_DEPENDENCIES=true`, по той же логике, что и
|
||||
`ALLOW_DIRTY_BUILD`: выпустить релиз, зная об уязвимости, можно, но это решение
|
||||
человека, а не поведение по умолчанию. Результат шага уезжает в
|
||||
`metadata/package.env` полем `dependency_security_gate`, так что по готовому
|
||||
tarball видно, проверялся он или собран с пропущенной проверкой.
|
||||
|
||||
### Проверка, а не генерация
|
||||
|
||||
`profile.ts`, `package/config/hy2xs.env` и `packageManager` в двух `package.json`
|
||||
|
||||
Reference in New Issue
Block a user