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:
+61
-18
@@ -39,13 +39,31 @@ func denyUnknownConfigKey(key string, allowed []string, operation string, c *gin
|
||||
)
|
||||
}
|
||||
|
||||
// UpdateConfigs применяет партию настроек по принципу «всё или ничего».
|
||||
//
|
||||
// Три прохода, и каждый отвечает за своё:
|
||||
//
|
||||
// 1. проверка партии целиком — права на ключ, дубликаты, значения;
|
||||
// 2. одна транзакция базы;
|
||||
// 3. применение к рантайму.
|
||||
//
|
||||
// Раньше проходов не было вовсе: цикл проверял очередной элемент и тут же его
|
||||
// записывал. Партия «разрешённый ключ + запрещённый» применяла первый и
|
||||
// возвращала ошибку на втором — оператор получал отказ на запрос, который
|
||||
// систему уже изменил.
|
||||
//
|
||||
// Второе изменение того же места: смена расписания больше не роняет
|
||||
// HTTP-сервер. Раньше здесь стоял `go service.StopServer()`, а точка входа
|
||||
// крутила runServer в цикле, из-за чего на процессе накапливались планировщики
|
||||
// (см. service/cron_scheduler.go).
|
||||
func UpdateConfigs(c *gin.Context) {
|
||||
configsUpdateDto, err := validateField(c, dto.ConfigsUpdateDto{})
|
||||
if err != nil {
|
||||
return
|
||||
}
|
||||
|
||||
needRestart := false
|
||||
updates := make([]service.ConfigUpdate, 0, len(configsUpdateDto.ConfigUpdateDtos))
|
||||
seen := make(map[string]struct{}, len(configsUpdateDto.ConfigUpdateDtos))
|
||||
|
||||
for _, item := range configsUpdateDto.ConfigUpdateDtos {
|
||||
key := *item.Key
|
||||
@@ -63,42 +81,67 @@ func UpdateConfigs(c *gin.Context) {
|
||||
return
|
||||
}
|
||||
|
||||
if key == constant.ResetTrafficCron {
|
||||
resetTrafficCron, err := service.GetConfig(constant.ResetTrafficCron)
|
||||
if err != nil {
|
||||
vo.Fail(err.Error(), c)
|
||||
return
|
||||
}
|
||||
if *resetTrafficCron.Value != value {
|
||||
needRestart = true
|
||||
}
|
||||
// Один ключ дважды в одной партии — неоднозначный запрос: какое из
|
||||
// двух значений считать намерением оператора, определить нельзя.
|
||||
if _, duplicate := seen[key]; duplicate {
|
||||
vo.Fail(fmt.Sprintf("config key %q appears more than once in the batch", key), c)
|
||||
return
|
||||
}
|
||||
seen[key] = struct{}{}
|
||||
|
||||
if err = service.UpdateConfig(key, value); err != nil {
|
||||
if err = service.ValidateConfigValue(key, value); err != nil {
|
||||
vo.Fail(err.Error(), c)
|
||||
return
|
||||
}
|
||||
|
||||
updates = append(updates, service.ConfigUpdate{Key: key, Value: value})
|
||||
}
|
||||
|
||||
if needRestart {
|
||||
go func() {
|
||||
_ = service.StopServer()
|
||||
}()
|
||||
if err = service.UpdateConfigs(updates); err != nil {
|
||||
vo.Fail(err.Error(), c)
|
||||
return
|
||||
}
|
||||
|
||||
if err = applyRuntimeConfigUpdates(updates); err != nil {
|
||||
vo.Fail(err.Error(), c)
|
||||
return
|
||||
}
|
||||
|
||||
vo.Success(nil, c)
|
||||
}
|
||||
|
||||
// applyRuntimeConfigUpdates доносит уже сохранённые настройки до рантайма.
|
||||
//
|
||||
// Отказ здесь недостижим по построению: значения проверены тем же парсером,
|
||||
// которым планировщик их разбирает, а сам планировщик поднимается в runServer
|
||||
// до старта HTTP-сервера — то есть к моменту обработки запроса он всегда
|
||||
// запущен. Проверка оставлена именно поэтому: если этот инвариант когда-нибудь
|
||||
// сломают, отказ должен быть громким, а не молча пропавшей джобой.
|
||||
func applyRuntimeConfigUpdates(updates []service.ConfigUpdate) error {
|
||||
for _, item := range updates {
|
||||
if item.Key != constant.ResetTrafficCron {
|
||||
continue
|
||||
}
|
||||
if err := service.RescheduleResetTraffic(item.Value); err != nil {
|
||||
return err
|
||||
}
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// isOrchestratorManagedConfigKey — ключи, которыми владеет install-оркестратор.
|
||||
//
|
||||
// Формально они и так не входят в allowlist, но отказ по ним обязан объяснять
|
||||
// ПОЧЕМУ: «этим значением владеет оркестратор» — это другой ответ, чем «такого
|
||||
// ключа в API нет», и он ведёт оператора к `hy2xs-orchestrator reconfigure`.
|
||||
//
|
||||
// HYSTERIA2_ENABLE и HYSTERIA2_CONFIG отсюда убраны вместе с самими ключами:
|
||||
// первым никто не управлял, второй был вторым источником истины рядом с
|
||||
// /etc/hysteria/config.yaml. Serverный конфиг по-прежнему принадлежит
|
||||
// оркестратору — просто теперь он живёт только в файле, а не ещё и в SQLite.
|
||||
func isOrchestratorManagedConfigKey(key string) bool {
|
||||
switch key {
|
||||
case constant.Hysteria2Enable,
|
||||
constant.Hysteria2Config,
|
||||
constant.Hysteria2TrafficStatsSecret:
|
||||
case constant.Hysteria2TrafficStatsSecret:
|
||||
return true
|
||||
default:
|
||||
return false
|
||||
|
||||
@@ -5,11 +5,14 @@ import (
|
||||
"encoding/json"
|
||||
"net/http"
|
||||
"net/http/httptest"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
|
||||
"github.com/gin-gonic/gin"
|
||||
"hy2xs-admin/dao"
|
||||
"hy2xs-admin/model/constant"
|
||||
"hy2xs-admin/service"
|
||||
)
|
||||
|
||||
// Секреты, которые лежат в таблице `config` рядом с пользовательскими
|
||||
@@ -72,7 +75,7 @@ func TestListConfigRefusesInternalKeys(t *testing.T) {
|
||||
// Секретный ключ, спрятанный среди разрешённых, обязан отклонить весь запрос.
|
||||
func TestListConfigRefusesMixedBatch(t *testing.T) {
|
||||
result := postJSON(t, ListConfig, "/config/listConfig", map[string]any{
|
||||
"keys": []string{constant.Hysteria2TrafficTime, constant.PeerSecretEncryptionKey},
|
||||
"keys": []string{constant.ResetTrafficCron, constant.PeerSecretEncryptionKey},
|
||||
})
|
||||
|
||||
if result.Type != "no" {
|
||||
@@ -109,8 +112,6 @@ func TestUpdateConfigsRefusesInternalKeys(t *testing.T) {
|
||||
// такого ключа»: оператор должен понять, что менять их надо через reconfigure.
|
||||
func TestUpdateConfigsPointsAtOrchestratorForItsOwnKeys(t *testing.T) {
|
||||
for _, key := range []string{
|
||||
constant.Hysteria2Enable,
|
||||
constant.Hysteria2Config,
|
||||
constant.Hysteria2TrafficStatsSecret,
|
||||
} {
|
||||
result := postJSON(t, UpdateConfigs, "/config/updateConfigs", map[string]any{
|
||||
@@ -126,6 +127,23 @@ func TestUpdateConfigsPointsAtOrchestratorForItsOwnKeys(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// Удалённые ключи обязаны отклоняться как неизвестные, а не приниматься.
|
||||
func TestUpdateConfigsRefusesRemovedKeys(t *testing.T) {
|
||||
for _, key := range []string{
|
||||
"HYSTERIA2_ENABLE",
|
||||
"HYSTERIA2_CONFIG",
|
||||
"HYSTERIA2_TRAFFIC_TIME",
|
||||
"HYSTERIA2_CONFIG_REMARK",
|
||||
} {
|
||||
result := postJSON(t, UpdateConfigs, "/config/updateConfigs", map[string]any{
|
||||
"configUpdateDtos": []map[string]string{{"key": key, "value": "x"}},
|
||||
})
|
||||
if result.Type != "no" {
|
||||
t.Errorf("удалённый ключ %s принят на запись: %+v", key, result)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
func TestUpdateConfigsRefusesUnknownKey(t *testing.T) {
|
||||
result := postJSON(t, UpdateConfigs, "/config/updateConfigs", map[string]any{
|
||||
"configUpdateDtos": []map[string]string{{"key": "TOTALLY_UNKNOWN_KEY", "value": "x"}},
|
||||
@@ -139,17 +157,146 @@ func TestUpdateConfigsRefusesUnknownKey(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// Отказ на любой записи партии обязан отменить партию целиком: иначе первые
|
||||
// ключи применились бы, а оператор получил бы ошибку.
|
||||
func TestUpdateConfigsRefusesWholeBatchOnFirstForbiddenKey(t *testing.T) {
|
||||
// newConfigTestDB поднимает настоящую SQLite: проверка «партия не применилась
|
||||
// частично» без базы бессмысленна — именно состояние базы и есть предмет
|
||||
// утверждения. Схема поднимается отдельно от InitSql: bootstrap-администратор
|
||||
// и bootstrap-пир здесь не нужны.
|
||||
func newConfigTestDB(t *testing.T) {
|
||||
t.Helper()
|
||||
|
||||
dbPath := filepath.Join(t.TempDir(), "hy2xs-admin-test.db")
|
||||
if err := dao.InitSqliteDBAt(dbPath); err != nil {
|
||||
t.Fatalf("не удалось открыть тестовую базу: %v", err)
|
||||
}
|
||||
if err := dao.RunMigrations(); err != nil {
|
||||
t.Fatalf("не удалось применить миграции: %v", err)
|
||||
}
|
||||
t.Cleanup(func() {
|
||||
_ = dao.CloseSqliteDB()
|
||||
})
|
||||
}
|
||||
|
||||
func storedConfigValue(t *testing.T, key string) string {
|
||||
t.Helper()
|
||||
|
||||
config, err := dao.GetConfig("key = ?", key)
|
||||
if err != nil {
|
||||
t.Fatalf("не удалось прочитать %s: %v", key, err)
|
||||
}
|
||||
if config.Value == nil {
|
||||
return ""
|
||||
}
|
||||
return *config.Value
|
||||
}
|
||||
|
||||
// Отказ на любой записи партии обязан отменить партию ЦЕЛИКОМ.
|
||||
//
|
||||
// Разрешённый ключ стоит ПЕРВЫМ намеренно. Предыдущая версия этого теста
|
||||
// ставила запрещённый ключ первым, поэтому проходила и на реализации, которая
|
||||
// проверяла и записывала настройки в одном цикле: до второго элемента дело не
|
||||
// доходило. Поймать частичное применение такой порядок неспособен по
|
||||
// построению, и состояние базы тест тоже не смотрел.
|
||||
func TestUpdateConfigsRefusesWholeBatchWhenLaterKeyIsForbidden(t *testing.T) {
|
||||
newConfigTestDB(t)
|
||||
|
||||
before := storedConfigValue(t, constant.ResetTrafficCron)
|
||||
|
||||
result := postJSON(t, UpdateConfigs, "/config/updateConfigs", map[string]any{
|
||||
"configUpdateDtos": []map[string]string{
|
||||
{"key": constant.ResetTrafficCron, "value": "@weekly"},
|
||||
{"key": constant.JwtSecret, "value": "attacker-controlled"},
|
||||
{"key": constant.Hysteria2TrafficTime, "value": "10"},
|
||||
},
|
||||
})
|
||||
|
||||
if result.Type != "no" {
|
||||
t.Fatalf("партия с секретом не отклонена: %+v", result)
|
||||
}
|
||||
if after := storedConfigValue(t, constant.ResetTrafficCron); after != before {
|
||||
t.Fatalf("отклонённая партия изменила %s: было %q, стало %q", constant.ResetTrafficCron, before, after)
|
||||
}
|
||||
if secret := storedConfigValue(t, constant.JwtSecret); secret == "attacker-controlled" {
|
||||
t.Fatal("подписывающий ключ перезаписан отклонённой партией")
|
||||
}
|
||||
}
|
||||
|
||||
// Успешная партия обязана и сохраниться, и доехать до рантайма — БЕЗ
|
||||
// перезапуска HTTP-сервера.
|
||||
//
|
||||
// Раньше новое расписание применялось единственным способом: обработчик
|
||||
// вызывал StopServer(), точка входа поднимала runServer заново, и новый
|
||||
// планировщик читал настройку из базы. Тест закрепляет обе половины замены:
|
||||
// значение в базе изменилось, джоба перепланирована, число записей
|
||||
// планировщика не выросло.
|
||||
func TestUpdateConfigsAppliesScheduleWithoutRestart(t *testing.T) {
|
||||
newConfigTestDB(t)
|
||||
|
||||
if err := service.InitCron(); err != nil {
|
||||
t.Fatalf("InitCron: %v", err)
|
||||
}
|
||||
t.Cleanup(service.StopCron)
|
||||
|
||||
before := service.CronEntryCount()
|
||||
|
||||
result := postJSON(t, UpdateConfigs, "/config/updateConfigs", map[string]any{
|
||||
"configUpdateDtos": []map[string]string{
|
||||
{"key": constant.ResetTrafficCron, "value": "@weekly"},
|
||||
},
|
||||
})
|
||||
|
||||
if result.Type != "ok" {
|
||||
t.Fatalf("корректная партия отклонена: %+v", result)
|
||||
}
|
||||
if stored := storedConfigValue(t, constant.ResetTrafficCron); stored != "@weekly" {
|
||||
t.Fatalf("значение не сохранено: %q", stored)
|
||||
}
|
||||
if !service.ResetTrafficScheduled() {
|
||||
t.Fatal("новое расписание не применилось к планировщику")
|
||||
}
|
||||
if after := service.CronEntryCount(); after != before {
|
||||
t.Fatalf("применение расписания добавило джобы: было %d, стало %d", before, after)
|
||||
}
|
||||
}
|
||||
|
||||
// Невалидное значение в партии обязано отменить её так же, как запрещённый
|
||||
// ключ: разница между «нельзя писать сюда» и «нельзя писать это» касается
|
||||
// только текста ошибки, но не последствий для базы.
|
||||
func TestUpdateConfigsRefusesWholeBatchOnInvalidValue(t *testing.T) {
|
||||
newConfigTestDB(t)
|
||||
|
||||
before := storedConfigValue(t, constant.ResetTrafficCron)
|
||||
|
||||
result := postJSON(t, UpdateConfigs, "/config/updateConfigs", map[string]any{
|
||||
"configUpdateDtos": []map[string]string{
|
||||
{"key": constant.ResetTrafficCron, "value": "какая-нибудь ерунда"},
|
||||
},
|
||||
})
|
||||
|
||||
if result.Type != "no" {
|
||||
t.Fatalf("невалидное cron-выражение принято: %+v", result)
|
||||
}
|
||||
if after := storedConfigValue(t, constant.ResetTrafficCron); after != before {
|
||||
t.Fatalf("невалидное значение попало в базу: было %q, стало %q", before, after)
|
||||
}
|
||||
}
|
||||
|
||||
// Один ключ дважды в партии — неоднозначный запрос: какое из двух значений
|
||||
// считать намерением оператора, определить нельзя.
|
||||
func TestUpdateConfigsRefusesDuplicateKeys(t *testing.T) {
|
||||
newConfigTestDB(t)
|
||||
|
||||
before := storedConfigValue(t, constant.ResetTrafficCron)
|
||||
|
||||
result := postJSON(t, UpdateConfigs, "/config/updateConfigs", map[string]any{
|
||||
"configUpdateDtos": []map[string]string{
|
||||
{"key": constant.ResetTrafficCron, "value": "@weekly"},
|
||||
{"key": constant.ResetTrafficCron, "value": "@monthly"},
|
||||
},
|
||||
})
|
||||
|
||||
if result.Type != "no" {
|
||||
t.Fatalf("партия с дубликатом ключа принята: %+v", result)
|
||||
}
|
||||
if after := storedConfigValue(t, constant.ResetTrafficCron); after != before {
|
||||
t.Fatalf("партия с дубликатом изменила базу: было %q, стало %q", before, after)
|
||||
}
|
||||
}
|
||||
|
||||
+31
-10
@@ -43,6 +43,14 @@ func LogSystem(c *gin.Context) {
|
||||
vo.Fail("Unable to unmarshal log data", c)
|
||||
continue
|
||||
}
|
||||
// Собственный журнал санитизируется так же, как чужой.
|
||||
//
|
||||
// Раньше через SanitizeLogText проходил только журнал Hysteria: он
|
||||
// «чужой», а свой мы якобы контролируем. Контроль этот держался на
|
||||
// внимательности — ровно до logrus.Warnf с паролем администратора в
|
||||
// dao/sqlite.go. Санитайз здесь стоит не вместо аккуратности в местах
|
||||
// записи, а на случай следующего такого места.
|
||||
logSystemVo.Msg = service.SanitizeLogText(logSystemVo.Msg)
|
||||
logSystemVos = append(logSystemVos, logSystemVo)
|
||||
}
|
||||
vo.Success(vo.LogSystemPage[vo.LogSystemVo]{
|
||||
@@ -80,10 +88,26 @@ func ExportLog(c *gin.Context) {
|
||||
}
|
||||
|
||||
var fileName string
|
||||
var filePath string
|
||||
if *logExportDto.Option == 0 {
|
||||
fileName = fmt.Sprintf("hy2xs-admin-%s.log", time.Now().Format("20060102150405"))
|
||||
filePath = constant.SystemLogPath
|
||||
|
||||
// Журнал админки отдаётся санитизированным, а не файлом «как есть».
|
||||
//
|
||||
// Раньше здесь стоял c.File(constant.SystemLogPath): оператор скачивал
|
||||
// сырой /var/log/hy2xs/hy2xs-admin.log. Журнал Hysteria при этом
|
||||
// проходил через SanitizeLogText — то есть чужому журналу продукт не
|
||||
// доверял, а своему доверял. Асимметрия ничем не обоснована: файл в
|
||||
// обоих случаях покидает сервер и пересылается в переписке.
|
||||
output, exportErr := service.ExportAdminLog()
|
||||
if exportErr != nil {
|
||||
vo.Fail("log file not exist", c)
|
||||
return
|
||||
}
|
||||
c.Header("Content-Type", "text/plain; charset=utf-8")
|
||||
c.Header("Content-Transfer-Encoding", "binary")
|
||||
c.Header("Content-Disposition", fmt.Sprintf("attachment; filename=%s", fileName))
|
||||
c.Data(200, "text/plain; charset=utf-8", []byte(output))
|
||||
return
|
||||
} else if *logExportDto.Option == 1 {
|
||||
fileName = fmt.Sprintf("hysteria2-%s.log", time.Now().Format("20060102150405"))
|
||||
output, exportErr := service.ExportHysteriaJournalLogs(5000)
|
||||
@@ -98,12 +122,9 @@ func ExportLog(c *gin.Context) {
|
||||
return
|
||||
}
|
||||
|
||||
if !util.Exists(filePath) {
|
||||
vo.Fail("log file not exist", c)
|
||||
return
|
||||
}
|
||||
c.Header("Content-Type", "application/octet-stream")
|
||||
c.Header("Content-Transfer-Encoding", "binary")
|
||||
c.Header("Content-Disposition", fmt.Sprintf("attachment; filename=%s", fileName))
|
||||
c.File(filePath)
|
||||
// Обе ветки выше завершаются return. Сюда попадает только неизвестное
|
||||
// значение option, и это отказ, а не отдача пустого файла: раньше здесь
|
||||
// оставался путь с пустым filePath, который сводился к тому же сообщению
|
||||
// окольной дорогой.
|
||||
vo.Fail("unsupported log export option", c)
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user