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:
@@ -8,15 +8,27 @@ package constant
|
||||
// HY2XS_UI_PORT через systemd, bind — из HY2XS_UI_BIND_HOST, TLS
|
||||
// терминируется на внешнем слое. Панель записывала в SQLite тот же порт,
|
||||
// который ей передали аргументом, и тут же читала его обратно.
|
||||
// Ключей HYSTERIA2_ENABLE, HYSTERIA2_CONFIG, HYSTERIA2_TRAFFIC_TIME и
|
||||
// HYSTERIA2_CONFIG_REMARK здесь больше нет. Все четыре достались от предыдущего
|
||||
// поколения панели и к v1 перестали чем-либо управлять:
|
||||
//
|
||||
// HYSTERIA2_ENABLE — жизненным циклом Hysteria владеет systemd, а
|
||||
// единственным потребителем ключа была строка лога;
|
||||
// HYSTERIA2_CONFIG — второй источник истины рядом с
|
||||
// /etc/hysteria/config.yaml, причём читался ПЕРВЫМ;
|
||||
// HYSTERIA2_TRAFFIC_TIME — настройка в панели без единого потребителя в
|
||||
// рантайме: интервал сбора метрик задан в коде;
|
||||
// HYSTERIA2_CONFIG_REMARK — пустая read-only строка, которую никто не писал.
|
||||
//
|
||||
// Пустой ключ, который нельзя изменить и который ни на что не влияет, — это не
|
||||
// «задел на будущее», а состояние, которое приходится объяснять в документации
|
||||
// и защищать в allowlist. Настоящую замену получил только remark: имя профиля
|
||||
// в share URI теперь выводится из имени пира (см. service/hysteria2_api.go).
|
||||
const (
|
||||
JwtSecret = "JWT_SECRET"
|
||||
PeerSecretKey = "PEER_SECRET_KEY"
|
||||
PeerSecretEncryptionKey = "PEER_SECRET_ENCRYPTION_KEY"
|
||||
Hysteria2TrafficStatsSecret = "HYSTERIA2_TRAFFIC_STATS_SECRET"
|
||||
Hysteria2Enable = "HYSTERIA2_ENABLE"
|
||||
Hysteria2Config = "HYSTERIA2_CONFIG"
|
||||
Hysteria2TrafficTime = "HYSTERIA2_TRAFFIC_TIME"
|
||||
Hysteria2ConfigRemark = "HYSTERIA2_CONFIG_REMARK"
|
||||
ResetTrafficCron = "RESET_TRAFFIC_CRON"
|
||||
)
|
||||
|
||||
@@ -40,20 +52,18 @@ const (
|
||||
var (
|
||||
// publicReadableConfigKeys — настройки, которые панель показывает оператору.
|
||||
publicReadableConfigKeys = map[string]struct{}{
|
||||
Hysteria2TrafficTime: {},
|
||||
ResetTrafficCron: {},
|
||||
Hysteria2ConfigRemark: {},
|
||||
ResetTrafficCron: {},
|
||||
}
|
||||
|
||||
// publicWritableConfigKeys — подмножество читаемых, которые оператор
|
||||
// действительно редактирует в интерфейсе.
|
||||
//
|
||||
// HYSTERIA2_CONFIG_REMARK сюда не входит: панель его только отображает.
|
||||
// Право записи, которым никто не пользуется, — это attack surface без
|
||||
// пользователя.
|
||||
// После очистки мёртвых ключей оба списка совпали: единственная настройка,
|
||||
// которой владеет панель, — расписание сброса счётчиков трафика. Списки
|
||||
// намеренно не схлопнуты в один: читаемое и записываемое — разные права, и
|
||||
// первый же ключ «показываем, но менять нельзя» вернёт разницу.
|
||||
publicWritableConfigKeys = map[string]struct{}{
|
||||
Hysteria2TrafficTime: {},
|
||||
ResetTrafficCron: {},
|
||||
ResetTrafficCron: {},
|
||||
}
|
||||
)
|
||||
|
||||
@@ -89,8 +99,6 @@ func InternalConfigKeys() []string {
|
||||
PeerSecretKey,
|
||||
PeerSecretEncryptionKey,
|
||||
Hysteria2TrafficStatsSecret,
|
||||
Hysteria2Enable,
|
||||
Hysteria2Config,
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -34,29 +34,42 @@ func TestSecretKeysAreListedAsInternal(t *testing.T) {
|
||||
}
|
||||
|
||||
func TestOperatorSettingsRemainAvailable(t *testing.T) {
|
||||
for _, key := range []string{Hysteria2TrafficTime, ResetTrafficCron, Hysteria2ConfigRemark} {
|
||||
if !IsPublicReadableConfigKey(key) {
|
||||
t.Errorf("пользовательская настройка %s недоступна на чтение", key)
|
||||
}
|
||||
if !IsPublicReadableConfigKey(ResetTrafficCron) {
|
||||
t.Errorf("пользовательская настройка %s недоступна на чтение", ResetTrafficCron)
|
||||
}
|
||||
for _, key := range []string{Hysteria2TrafficTime, ResetTrafficCron} {
|
||||
if !IsPublicWritableConfigKey(key) {
|
||||
t.Errorf("пользовательская настройка %s недоступна на запись", key)
|
||||
if !IsPublicWritableConfigKey(ResetTrafficCron) {
|
||||
t.Errorf("пользовательская настройка %s недоступна на запись", ResetTrafficCron)
|
||||
}
|
||||
}
|
||||
|
||||
// Ключи, удалённые как мёртвое состояние, не должны вернуться в API «по
|
||||
// инерции» вместе с восстановлением константы. Проверка идёт по строковым
|
||||
// литералам: соответствующих констант в коде уже нет, и появиться они не
|
||||
// должны.
|
||||
func TestRemovedKeysStayClosed(t *testing.T) {
|
||||
for _, key := range []string{
|
||||
"HYSTERIA2_ENABLE",
|
||||
"HYSTERIA2_CONFIG",
|
||||
"HYSTERIA2_TRAFFIC_TIME",
|
||||
"HYSTERIA2_CONFIG_REMARK",
|
||||
} {
|
||||
if IsPublicReadableConfigKey(key) {
|
||||
t.Errorf("удалённый ключ %s снова доступен на чтение", key)
|
||||
}
|
||||
if IsPublicWritableConfigKey(key) {
|
||||
t.Errorf("удалённый ключ %s снова доступен на запись", key)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Право записи без потребителя — это attack surface без пользователя.
|
||||
// HYSTERIA2_CONFIG_REMARK панель только показывает.
|
||||
// Право записи без права чтения означает настройку, которую оператор может
|
||||
// изменить, но не может увидеть.
|
||||
func TestWritableIsSubsetOfReadable(t *testing.T) {
|
||||
for _, key := range PublicWritableConfigKeys() {
|
||||
if !IsPublicReadableConfigKey(key) {
|
||||
t.Errorf("ключ %s можно записать, но нельзя прочитать", key)
|
||||
}
|
||||
}
|
||||
if IsPublicWritableConfigKey(Hysteria2ConfigRemark) {
|
||||
t.Error("HYSTERIA2_CONFIG_REMARK не редактируется в панели и не должен быть записываемым")
|
||||
}
|
||||
}
|
||||
|
||||
func TestUnknownKeyIsClosedByDefault(t *testing.T) {
|
||||
|
||||
Reference in New Issue
Block a user