Files
founder cb20d8d28f 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
2026-09-02 23:24:01 +05:00

62 lines
2.9 KiB
Go

package vo
type PeerVo struct {
BaseVo
Name string `json:"name"`
Remark string `json:"remark"`
AuthId string `json:"authId"`
QuotaBytes int64 `json:"quotaBytes"`
DownloadBytes int64 `json:"downloadBytes"`
UploadBytes int64 `json:"uploadBytes"`
ExpiresAt int64 `json:"expiresAt"`
MaxDevices int64 `json:"maxDevices"`
Disabled int64 `json:"disabled"`
BannedUntil int64 `json:"bannedUntil"`
LastConnectionAt int64 `json:"lastConnectionAt"`
Online bool `json:"online"`
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"`
}