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:
@@ -31,9 +31,22 @@ type DashboardSystemVo struct {
|
||||
DiskPercent float64 `json:"diskPercent"`
|
||||
}
|
||||
|
||||
// DashboardHysteriaVo — состояние Hysteria из ДВУХ независимых источников.
|
||||
//
|
||||
// `serviceState` отвечает systemd, `apiReachable` — фактическое обращение к
|
||||
// Traffic Stats API. Раньше второе выводилось из первого: сборщик метрик
|
||||
// получал от общего Hysteria2Online пустую карту без ошибки, когда systemctl
|
||||
// говорил «неактивна», и выставлял `apiReachable = true`, ни разу не сходив в
|
||||
// API. Дашборд показывал «служба остановлена» и «API доступен» одновременно.
|
||||
//
|
||||
// `running` сохранён для совместимости отображения и означает ровно
|
||||
// `serviceState == active`. Решения на нём не строятся: «неизвестно» — это не
|
||||
// «остановлена», и путать их продукту уже дорого обходилось.
|
||||
type DashboardHysteriaVo struct {
|
||||
Version string `json:"version"`
|
||||
Running bool `json:"running"`
|
||||
Version string `json:"version"`
|
||||
Running bool `json:"running"`
|
||||
// ServiceState — active | inactive | unknown.
|
||||
ServiceState string `json:"serviceState"`
|
||||
ApiReachable bool `json:"apiReachable"`
|
||||
LastApiError string `json:"lastApiError,omitempty"`
|
||||
}
|
||||
|
||||
@@ -0,0 +1,132 @@
|
||||
package vo
|
||||
|
||||
// Страница конфигурации показывает ТО, ЧТО НАПИСАНО В ФАЙЛЕ.
|
||||
//
|
||||
// Что было. Панель отдавала браузеру внутреннюю модель серверного конфига
|
||||
// целиком, а frontend накладывал ответ на полный объект значений по умолчанию
|
||||
// (`DeepRequired` + merge). В результате экран отвечал не на вопрос
|
||||
//
|
||||
// что реально написано в /etc/hysteria/config.yaml?
|
||||
//
|
||||
// а на вопрос
|
||||
//
|
||||
// как выглядел бы конфиг, если недостающие куски заполнить дефолтами UI?
|
||||
//
|
||||
// Разница не косметическая. Отсутствующая секция `trafficStats` показывалась
|
||||
// как `:9999`; `speedTest: false` и `disableUDP: false` — валидные явные
|
||||
// значения — считались отсутствующими и прятали свои вкладки;
|
||||
// `ignoreClientBandwidth` (самостоятельная опция верхнего уровня) показывался
|
||||
// только внутри секции bandwidth и при её отсутствии исчезал вместе с ней;
|
||||
// `masquerade.string.statusCode` (число 200..599 у upstream) рисовался
|
||||
// переключателем. То есть экран, существующий ради диагностики расхождений,
|
||||
// эти расхождения скрывал.
|
||||
//
|
||||
// Второе свойство прежнего ответа: он вёз в браузер секреты. `auth` и
|
||||
// `trafficStats.secret` были закрыты `json:"-"`, но пароль обфускации, токены
|
||||
// ACME DNS, учётные данные outbound-прокси и masquerade — нет. Скачиваемый
|
||||
// экспорт того же конфига при этом их вырезает. Читающий экран не имеет права
|
||||
// быть щедрее выгрузки.
|
||||
//
|
||||
// Поэтому ответ описан отдельным типом. Он показывает production-профиль HY2XS
|
||||
// — то, чем реально управляет оркестратор, — и отдельно перечисляет секции,
|
||||
// которых в профиле нет. Полный документ по-прежнему доступен санитизированной
|
||||
// выгрузкой.
|
||||
//
|
||||
// Указатель означает «в файле этого нет». Это единственный способ отличить
|
||||
// отсутствие от значения: `false`, `0` и пустая строка — законные значения.
|
||||
|
||||
// Hysteria2ProfileVo — конфигурация Hysteria в терминах production-профиля.
|
||||
type Hysteria2ProfileVo struct {
|
||||
Listen *string `json:"listen"`
|
||||
Auth *Hysteria2ProfileAuthVo `json:"auth"`
|
||||
Tls *Hysteria2ProfileTlsVo `json:"tls"`
|
||||
Acme *Hysteria2ProfileAcmeVo `json:"acme"`
|
||||
Obfs *Hysteria2ProfileObfsVo `json:"obfs"`
|
||||
Bandwidth *Hysteria2ProfileBandwidthVo `json:"bandwidth"`
|
||||
IgnoreClientBandwidth *bool `json:"ignoreClientBandwidth"`
|
||||
Congestion *Hysteria2ProfileCongestionVo `json:"congestion"`
|
||||
Quic *Hysteria2ProfileQuicVo `json:"quic"`
|
||||
TrafficStats *Hysteria2ProfileTrafficStatsVo `json:"trafficStats"`
|
||||
|
||||
// Drift — секции верхнего уровня, которых production-профиль не описывает.
|
||||
//
|
||||
// Считается по СЫРОМУ YAML, а не по типизированной модели: секция, о
|
||||
// которой HY2XS не знает вовсе, обязана быть замечена именно как
|
||||
// расхождение, а не потеряна при разборе.
|
||||
Drift []string `json:"drift"`
|
||||
}
|
||||
|
||||
// Hysteria2ProfileAuthVo — способ допуска пиров.
|
||||
//
|
||||
// URL показывается санитизированным: это единственный канал допуска, и знать
|
||||
// его порт и путь оператору нужно, а machine token — нет.
|
||||
type Hysteria2ProfileAuthVo struct {
|
||||
Type *string `json:"type"`
|
||||
Url *string `json:"url"`
|
||||
Insecure *bool `json:"insecure"`
|
||||
}
|
||||
|
||||
type Hysteria2ProfileTlsVo struct {
|
||||
Cert *string `json:"cert"`
|
||||
Key *string `json:"key"`
|
||||
SniGuard *string `json:"sniGuard"`
|
||||
ClientCA *string `json:"clientCA"`
|
||||
}
|
||||
|
||||
// Hysteria2ProfileAcmeVo — выпуск сертификата.
|
||||
//
|
||||
// DnsConfigKeys перечисляет ИМЕНА параметров DNS-провайдера без значений: сам
|
||||
// факт «токен задан» диагностичен, а значение — это ключ от DNS-зоны.
|
||||
type Hysteria2ProfileAcmeVo struct {
|
||||
Domains []string `json:"domains"`
|
||||
Email *string `json:"email"`
|
||||
Ca *string `json:"ca"`
|
||||
Dir *string `json:"dir"`
|
||||
ListenHost *string `json:"listenHost"`
|
||||
Type *string `json:"type"`
|
||||
DnsProvider *string `json:"dnsProvider"`
|
||||
DnsConfigKeys []string `json:"dnsConfigKeys"`
|
||||
}
|
||||
|
||||
// Hysteria2ProfileObfsVo — обфускация.
|
||||
//
|
||||
// Пароль не возвращается: он входит в клиентскую ссылку, и оператор получает
|
||||
// его там, где он нужен. Здесь диагностичен только факт, что пароль задан.
|
||||
type Hysteria2ProfileObfsVo struct {
|
||||
Type *string `json:"type"`
|
||||
PasswordSet bool `json:"passwordSet"`
|
||||
MinPacketSize *int `json:"minPacketSize"`
|
||||
MaxPacketSize *int `json:"maxPacketSize"`
|
||||
}
|
||||
|
||||
type Hysteria2ProfileBandwidthVo struct {
|
||||
Up *string `json:"up"`
|
||||
Down *string `json:"down"`
|
||||
DisableLossCompensation *bool `json:"disableLossCompensation"`
|
||||
}
|
||||
|
||||
type Hysteria2ProfileCongestionVo struct {
|
||||
Type *string `json:"type"`
|
||||
BbrProfile *string `json:"bbrProfile"`
|
||||
}
|
||||
|
||||
type Hysteria2ProfileQuicVo struct {
|
||||
InitStreamReceiveWindow *uint64 `json:"initStreamReceiveWindow"`
|
||||
MaxStreamReceiveWindow *uint64 `json:"maxStreamReceiveWindow"`
|
||||
InitConnReceiveWindow *uint64 `json:"initConnReceiveWindow"`
|
||||
MaxConnReceiveWindow *uint64 `json:"maxConnReceiveWindow"`
|
||||
MaxIdleTimeout *string `json:"maxIdleTimeout"`
|
||||
MaxIncomingStreams *int64 `json:"maxIncomingStreams"`
|
||||
DisablePathMTUDiscovery *bool `json:"disablePathMTUDiscovery"`
|
||||
DisableStatelessReset *bool `json:"disableStatelessReset"`
|
||||
}
|
||||
|
||||
// Hysteria2ProfileTrafficStatsVo — внутренний control plane.
|
||||
//
|
||||
// `listen` показывается ровно так, как записан в файле: именно расхождение
|
||||
// этого адреса с loopback выключает лимит устройств, учёт трафика и
|
||||
// принудительное отключение разом, и увидеть его оператор должен здесь.
|
||||
type Hysteria2ProfileTrafficStatsVo struct {
|
||||
Listen *string `json:"listen"`
|
||||
SecretSet bool `json:"secretSet"`
|
||||
}
|
||||
@@ -23,6 +23,14 @@ type LogSystemVo struct {
|
||||
Time string `json:"time"`
|
||||
}
|
||||
|
||||
// LogHysteria2Vo — строка журнала Hysteria в том виде, в каком её показывает
|
||||
// панель.
|
||||
//
|
||||
// Тип НЕ является формой upstream-записи и никогда не разбирается прямым
|
||||
// json.Unmarshal: JSON-логгер Hysteria 2.12.2 пишет `time` числом
|
||||
// (zapcore.EpochMillisTimeEncoder), и попытка сложить его в строковое поле
|
||||
// роняла разбор целиком. Форма провода живёт в service/journal.go, здесь —
|
||||
// только результат.
|
||||
type LogHysteria2Vo struct {
|
||||
Level string `json:"level"`
|
||||
Msg string `json:"msg"`
|
||||
|
||||
+34
-2
@@ -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"`
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user