162759c599
Разбор кода на c0a43ae со сверкой с официальной документацией Hysteria 2.
Общая тема: операции, у которых была только одна из двух необходимых половин.
Отзыв доступа. Запись disabled=1 видит лишь выборка в Hysteria2Auth, то есть
закрывает БУДУЩИЕ обращения к HTTP-auth; установленная QUIC-сессия живёт своей
жизнью и сама не разрывается. После «Отключить» пир пользовался доступом сколько
угодно долго, а панель показывала его отключённым. Появился DisconnectPeers —
только официальный Traffic Stats /kick, без записи в базу; прежний Hysteria2Kick
вместе с разрывом проставлял banned_until и потому для отключения не годился.
Порядок «запись, затем разрыв» обратному не подлежит и доказан снимком базы в
момент прихода /kick. Неудача разрыва не откатывает disabled и сообщается кодом
peer_disconnect_failed: обычная ошибка означала бы для оператора вывод, прямо
противоположный истине. KickPeer переведён на тот же примитив — он писал
banned_until дважды и мог ответить чистым отказом уже в применённом состоянии.
Ограничение устройств. Отказ /online обрабатывался возвратом успеха
авторизации, то есть недоступность 127.0.0.1 превращала объявленный лимит в
безлимит. Вторая половина дыры была тише: Hysteria2Online отдавал пустую карту
БЕЗ ошибки, когда systemd отвечал «служба неактивна», — а этот ответ не
отличается от «спросить systemctl не удалось». Пути разделены: терпимый для
отображения, строгий для решения о доступе. Hysteria2IsRunning убран с путей
принятия решений совсем.
Журнал. entry.Info() вызывался без аргумента, и logrus писал "msg":"" для
каждого запроса — пустой столбец на экране был точным отражением файла. Ветка
«файла ещё нет» отвечала голым массивом вместо {records,total}, поэтому на
свежей установке страница системных логов не работала вовсе. Битая строка
вызывала vo.Fail И continue: клиент получал два JSON-документа подряд.
Панель. Общий LogViewer и utils/download.ts (копий скачивания было четыре, две
ставили запрос вне try и глушили причину); меню на command с быстрым
включением/отключением; popper-style у подсказки; kick с подтверждением и
названным сроком; отмена подтверждений перестала быть ошибкой. Отдельно:
skipErrorToast гасил и транспортный отказ, при том что страницы писали
«перехватчик уже показал» и молчали, — обрыв связи не показывал ничего.
Закреплено go-тестами против настоящего HTTP, контрактными тестами панели и
двумя гейтами приёмки. Ручная часть — в
docs/acceptance/2026-09-01-v1.0.0-rc2-preflight-findings.md.
158 lines
6.5 KiB
Go
158 lines
6.5 KiB
Go
package controller
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
"github.com/gin-gonic/gin"
|
|
"hy2xs-admin/model/constant"
|
|
"hy2xs-admin/model/dto"
|
|
"hy2xs-admin/model/vo"
|
|
"hy2xs-admin/service"
|
|
"hy2xs-admin/util"
|
|
"time"
|
|
)
|
|
|
|
func LogSystem(c *gin.Context) {
|
|
logSystemDto, err := validateField(c, dto.LogDto{})
|
|
if err != nil {
|
|
return
|
|
}
|
|
logSystemVos := make([]vo.LogSystemVo, 0)
|
|
|
|
// Форма ответа одна для ВСЕХ веток: {records, total}.
|
|
//
|
|
// Раньше ветка «файла ещё нет» отвечала голым массивом:
|
|
//
|
|
// vo.Success(logSystemVos, c)
|
|
//
|
|
// Панель читает `data.records`, поэтому получала undefined и передавала
|
|
// его в `:data` таблицы. То есть на свежепоставленном хосте — до первой
|
|
// записи в журнал — страница системных логов была сломана целиком, и
|
|
// именно этот сценарий воспроизводится на каждой приёмке чистой установки.
|
|
if !util.Exists(constant.SystemLogPath) {
|
|
vo.Success(vo.LogSystemPage[vo.LogSystemVo]{LogSystemVos: logSystemVos, Total: 0}, c)
|
|
return
|
|
}
|
|
numLine := 0
|
|
if logSystemDto.NumLine != nil && *logSystemDto.NumLine > 0 {
|
|
numLine = *logSystemDto.NumLine
|
|
}
|
|
logLines, total, err := util.ReadLinesFromBottom(constant.SystemLogPath, numLine)
|
|
if err != nil {
|
|
vo.Fail("Unable to read log file", c)
|
|
return
|
|
}
|
|
|
|
for _, line := range logLines {
|
|
if line == "" {
|
|
continue
|
|
}
|
|
logSystemVo := vo.LogSystemVo{}
|
|
// Неразбираемая строка ПРОПУСКАЕТСЯ, а не отказывает запросу.
|
|
//
|
|
// Было так:
|
|
//
|
|
// if err != nil {
|
|
// vo.Fail("Unable to unmarshal log data", c)
|
|
// continue
|
|
// }
|
|
//
|
|
// — ответ записывался в поток и цикл шёл дальше, а в конце
|
|
// безусловно выполнялся vo.Success. Клиент получал два JSON-документа
|
|
// подряд, то есть невалидный ответ, и gin ругался на повторную запись
|
|
// заголовков. Достаточно было ОДНОЙ битой строки, чтобы страница
|
|
// перестала открываться целиком.
|
|
//
|
|
// Строка при этом бьётся штатно: lumberjack ротирует файл, и обрыв
|
|
// последней записи на границе ротации — обычное событие, а не признак
|
|
// повреждения журнала. Отказывать из-за него всей выдаче нечем
|
|
// оправдать: остальные записи прочитаны и полезны.
|
|
if err := json.Unmarshal([]byte(line), &logSystemVo); err != nil {
|
|
continue
|
|
}
|
|
// Собственный журнал санитизируется так же, как чужой.
|
|
//
|
|
// Раньше через SanitizeLogText проходил только журнал Hysteria: он
|
|
// «чужой», а свой мы якобы контролируем. Контроль этот держался на
|
|
// внимательности — ровно до logrus.Warnf с паролем администратора в
|
|
// dao/sqlite.go. Санитайз здесь стоит не вместо аккуратности в местах
|
|
// записи, а на случай следующего такого места.
|
|
logSystemVo.Msg = service.SanitizeLogText(logSystemVo.Msg)
|
|
logSystemVos = append(logSystemVos, logSystemVo)
|
|
}
|
|
vo.Success(vo.LogSystemPage[vo.LogSystemVo]{
|
|
LogSystemVos: logSystemVos,
|
|
Total: int64(total),
|
|
}, c)
|
|
}
|
|
|
|
func LogHysteria2(c *gin.Context) {
|
|
logSystemDto, err := validateField(c, dto.LogDto{})
|
|
if err != nil {
|
|
return
|
|
}
|
|
logHysteria2Vos := make([]vo.LogHysteria2Vo, 0)
|
|
numLine := 0
|
|
if logSystemDto.NumLine != nil && *logSystemDto.NumLine > 0 {
|
|
numLine = *logSystemDto.NumLine
|
|
}
|
|
logHysteria2Vos, total, err := service.ReadHysteriaJournalLogs(numLine)
|
|
if err != nil {
|
|
vo.Fail("Unable to read hysteria journal logs", c)
|
|
return
|
|
}
|
|
|
|
vo.Success(vo.LogSystemPage[vo.LogHysteria2Vo]{
|
|
LogSystemVos: logHysteria2Vos,
|
|
Total: int64(total),
|
|
}, c)
|
|
}
|
|
|
|
func ExportLog(c *gin.Context) {
|
|
logExportDto, err := validateField(c, dto.LogExportDto{})
|
|
if err != nil {
|
|
return
|
|
}
|
|
|
|
var fileName string
|
|
if *logExportDto.Option == 0 {
|
|
fileName = fmt.Sprintf("hy2xs-admin-%s.log", time.Now().Format("20060102150405"))
|
|
|
|
// Журнал админки отдаётся санитизированным, а не файлом «как есть».
|
|
//
|
|
// Раньше здесь стоял 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)
|
|
if exportErr != nil {
|
|
vo.Fail("failed to export hysteria journal logs", 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
|
|
}
|
|
|
|
// Обе ветки выше завершаются return. Сюда попадает только неизвестное
|
|
// значение option, и это отказ, а не отдача пустого файла: раньше здесь
|
|
// оставался путь с пустым filePath, который сводился к тому же сообщению
|
|
// окольной дорогой.
|
|
vo.Fail("unsupported log export option", c)
|
|
}
|