fix(admin): связать отзыв учётных данных с идентичностью сессий и свести адрес control plane к одному

Отзыв секрета не сходился: `auth_id` при смене секрета оставался прежним,
поэтому сессия, установленная по отозванным учётным данным, была неотличима от
законной, и цикл учёта не имел признака, по которому её следовало завершить. У
состояния есть путь без единой неудачи — Hysteria регистрирует соединение в
Traffic Stats API только после возврата backend-auth, поэтому успешный /kick
может пройти мимо. Новое поколение credentials получает новый auth_id, kick идёт
по старому, пережившая сессия становится orphan.

Адрес Traffic Stats API имел два контракта: оркестратор принимал любой IPv4,
админка всегда шла на loopback. Валидная по всем гейтам конфигурация выключала
лимит устройств, учёт трафика и принудительное отключение разом. Адрес
зафиксирован, а расхождение файла с ним админка называет.

Состояние службы стало трёхзначным: util.Exec выбрасывал вывод systemctl при
ненулевом коде, поэтому «остановлена» и «спросить не удалось» приходили одним
значением, а доступность Traffic Stats API выводилась из него же. Журнал
Hysteria разбирается в фактическом формате upstream (time — дробное число),
страница конфигурации показывает файл вместо дефолтов UI и не возит секреты в
браузер, санитайзер выгрузки следует по YAML-якорям.

Разбор: docs/acceptance/2026-09-02-v1.0.0-rc4-preflight-findings.md
This commit is contained in:
2026-09-02 23:24:01 +05:00
parent 8dcb50a07c
commit cb20d8d28f
66 changed files with 4981 additions and 2684 deletions
+34 -2
View File
@@ -18,12 +18,44 @@ type PeerVo struct {
OnlineDevices int64 `json:"onlineDevices"`
}
// PeerOnlineState — известна ли панели картина подключений прямо сейчас.
//
// Признак один на всю страницу, а не поле в каждой строке: недоступность
// Traffic Stats API — свойство ответа целиком, и nullable-флаг в каждой строке
// заставлял бы панель отвечать на этот вопрос заново для каждого пира.
const (
// PeerOnlineStateOk — Traffic Stats API ответил, `online` в строках
// означает то, что написано.
PeerOnlineStateOk = "ok"
// PeerOnlineStateUnavailable — спросить не удалось. `online = false` в
// строках при этом значении не означает НИЧЕГО.
PeerOnlineStateUnavailable = "unavailable"
)
// PeerPageVo — страница списка пиров.
//
// Что было. Список строился так:
//
// onlineUsers, _ := Hysteria2Online()
//
// Ошибка отбрасывалась, пустая карта разъезжалась по строкам как `online =
// false`, и любой сбой control plane превращался для оператора в утверждение
// «все пользователи офлайн» — вместо «состояние подключений сейчас
// неизвестно». Это два разных ответа, и первый из них в аварии ведёт искать
// проблему у пользователей.
type PeerPageVo struct {
Records []PeerVo `json:"records"`
Total int64 `json:"total"`
// OnlineState — ok | unavailable.
OnlineState string `json:"onlineState"`
}
// PeerClientConfigVo — клиентская ссылка пира.
//
// Поля QrCode здесь больше нет. Оно было помечено deprecated и возило в
// браузер PNG, который панель не использует: QR рисуется во frontend из самой
// ссылки (qrcode.vue), и второй его экземпляр в ответе был лишним трафиком и
// вторым способом получить то же самое.
type PeerClientConfigVo struct {
Url string `json:"url"`
QrCode []byte `json:"qrCode,omitempty"` // deprecated: frontend renders SVG QR from Url
Url string `json:"url"`
}