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
parent 8dcb50a07c
commit cb20d8d28f
66 changed files with 4981 additions and 2684 deletions
@@ -177,3 +177,59 @@ describe("остальные production-инварианты", () => {
    expect(() => baselineConfig({ HY2XS_ACME_TYPE: "dns" })).toThrow(/not supported in production profile/);
  });
 });
+
+/**
+ * Адрес Traffic Stats API — внутренний контракт двух компонентов, а не
+ * настройка.
+ *
+ * Проверка существует потому, что прежняя валидация была не просто мягкой, а
+ * согласованно неверной: env принимал любой IPv4, шаблон честно его
+ * подставлял, а `assertHysteriaConfigMatchesProfile` сверял конфиг с тем же
+ * значением. Все гейты проходили, а продукт при этом переставал работать —
+ * админка читает из `trafficStats.listen` только порт и всегда обращается на
+ * loopback, поэтому расхождение адресов выключает лимит устройств, учёт
+ * трафика и принудительное отключение разом (fail-closed: пиры не проходят
+ * авторизацию вовсе).
+ */
+describe("адрес Traffic Stats API", () => {
+  test("канонический 127.0.0.1 принимается", () => {
+    expect(baselineConfig().hysteriaTrafficStatsHost).toBe("127.0.0.1");
+  });
+
+  test("значение по умолчанию не зависит от наличия ключа", () => {
+    expect(baselineConfig({ HY2XS_HYSTERIA_TRAFFIC_STATS_HOST: null }).hysteriaTrafficStatsHost).toBe("127.0.0.1");
+  });
+
+  // Wildcard достижим по loopback, поэтому связь компонентов он не ломает —
+  // но публикует внутренний control plane на всех интерфейсах, и при
+  // HY2XS_FIREWALL_MODE=external|off его не прикрывает ничто.
+  test("0.0.0.0 отклоняется", () => {
+    expect(() => baselineConfig({ HY2XS_HYSTERIA_TRAFFIC_STATS_HOST: "0.0.0.0" })).toThrow(
+      /TRAFFIC_STATS_HOST is fixed/
+    );
+  });
+
+  test("другой адрес loopback отклоняется", () => {
+    expect(() => baselineConfig({ HY2XS_HYSTERIA_TRAFFIC_STATS_HOST: "127.0.0.2" })).toThrow(
+      /TRAFFIC_STATS_HOST is fixed/
+    );
+  });
+
+  test("адрес LAN отклоняется", () => {
+    expect(() => baselineConfig({ HY2XS_HYSTERIA_TRAFFIC_STATS_HOST: "192.168.1.10" })).toThrow(
+      /TRAFFIC_STATS_HOST is fixed/
+    );
+  });
+
+  test("публичный адрес отклоняется", () => {
+    expect(() => baselineConfig({ HY2XS_HYSTERIA_TRAFFIC_STATS_HOST: "203.0.113.10" })).toThrow(
+      /TRAFFIC_STATS_HOST is fixed/
+    );
+  });
+
+  // Порт настройкой остаётся: обе половины продукта берут его из одного и того
+  // же `trafficStats.listen`, поэтому разойтись по нему они не могут.
+  test("порт остаётся настраиваемым", () => {
+    expect(baselineConfig({ HY2XS_HYSTERIA_TRAFFIC_STATS_PORT: "34712" }).hysteriaTrafficStatsPort).toBe(34712);
+  });
+});