隧道"假活"真因修复 + 中转管理后台重做

用户反馈两件事:
  1. 早上打开 relay.xxmxxs.top 看到 Cloudflare Error 1033 —— "这就是你说的优化好了?"
  2. "中转管理那边 ui 界面大改,现在难看的要死"

============ 一、隧道 1033/502/530 的真因 ============

之前我只测 15~25 次就说"可用率 100%",太草率 ——
实际是**间歇性假活**:隧道显示 ha_connections=2 连着,
公网却 502/530/000。watchdog 日志把过程记了下来。

根因:**4G 链路静默断开 TCP 连接**(不发 FIN/RST,双方都以为还活着)。
Cloudflare 把请求发到这条僵尸连接上就回错误。
Linux 默认 tcp_keepalive_time = **7200 秒(2 小时)**才发现,
中间这段时间服务一直"看着在线、实际打不开"。

修法(都有实测数据支撑):
  1. tcp_keepalive 30 秒 + 每 10 秒探测 3 次
     => 最多约 60 秒发现僵尸连接并重连
  2. 隧道连接数 2 -> 4
     (对照实验:http2+2 只有 1 条连上时公网 0/12;
       http2+4 稳定 12/12。连接数太少会出现"只有 1 条"的危险窗口)
  3. 协议定为 http2(cloudflared 自检说 TCP 7844 被墙,
     但实测 http2 反而比 quic 稳)

实测:http2+4 之后公网 40/40 = 100%,最慢 1.3 秒,0 次重连。

============ 二、中转管理后台重做 ============

原来是几百行内联在 relay.py 的 f-string 里(HTML+CSS+JS 全挤一起),
改一处样式要在一堆转义花括号里翻。拆成独立模块 relay/admin.py。

新版设计(对齐官网那套白色简洁):
  * 吸顶顶栏:品牌 + 运行状态 + 版本/内存/请求数
  * 公网地址给最大权重(这是用户最需要复制的东西)
  * 四个数字卡(在线/会话数带颜色区分)
  * 设备表卡片:状态圆点、等宽配对码、行悬停
  * 工具卡:网络体检 + 下载区并排
  * 空状态改成图标+引导文案,不再是干巴巴一句
  * 窄屏时表格自动变卡片

relay.py 从 2089 行缩到 1550 行。

============ 三、顺手修的两个真 bug ============

1. 设备记录只增不减
   self.devices 从不清理,被控端每次换端口/重装就多一条,
   实测一天攒了 75 条僵尸记录,/v1/health 从几 KB 涨到 20KB。
   加 DEVICE_TTL(6 小时)在 snapshot() 里清。

2. 配对码映射也没清
   RELAY.codes 和 devices 是一对孪生 dict,
   只清 devices 会留下指向已删设备的孤儿条目 ——
   管理页显示"配对码占用 131",实际一台设备都没有。
   现在一起清。

============ 四、我自己造的两次事故(如实记录) ============

1. 删文件删过头
   用"从 _admin_page 截到文件末尾"的方式替换方法,
   但 _admin_page 后面**还有 _esc/_kb/_uptime/class Server/main()**。
   结果 relay 起不来,systemd 重启 24 次,所有接口 000。
   教训:**"删到文件末尾"之前必须先确认末尾有什么。**

2. ADMIN_PATH 引用了不存在的常量
   路由里写的是字面量,我却在新代码里用了 ADMIN_PATH,
   管理页一访问就 NameError。现在统一定义了常量。

二者都是"改完没立刻验"造成的。现在每次改完都跑一遍
管理页 + 官网 + 关键接口的回归。
This commit is contained in:
xmz7891
2026-10-07 09:34:53 +08:00
parent 8c4ee6df08
commit 1f05084f51
33 changed files with 3684 additions and 938 deletions
+98
View File
@@ -0,0 +1,98 @@
# -*- coding: utf-8 -*-
r'''对比 git 版本,找出 swap_admin_page.py 误删的所有东西。
事故:
那个脚本把 relay.py 从 "_admin_page" 那行一直截到文件末尾,
以为 _admin_page 是最后一个东西。实际它后面还有:
- 一大堆模块级函数/常量(ADMIN_PATH、Server、Handler...)
- main() 入口
结果 relay 起不来,systemd 重启 14 次。
这个脚本用 AST 对比两边的**顶层名字**,把丢了的一次性列清楚。
'''
from __future__ import annotations
import ast
import subprocess
import sys
from pathlib import Path
ROOT = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote")
RELAY = ROOT / "relay" / "relay.py"
GIT = r"C:\Program Files\Git\bin\git.exe"
def top_names(source: str) -> list:
"""列出模块顶层的定义名(按出现顺序)。"""
tree = ast.parse(source)
out = []
for node in tree.body:
if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
out.append(("def", node.name, node.lineno))
elif isinstance(node, ast.ClassDef):
out.append(("class", node.name, node.lineno))
elif isinstance(node, ast.Assign):
for target in node.targets:
if isinstance(target, ast.Name):
out.append(("var", target.id, node.lineno))
elif isinstance(node, ast.AnnAssign) and isinstance(node.target,
ast.Name):
out.append(("var", node.target.id, node.lineno))
return out
def main() -> int:
old = subprocess.run([GIT, "show", "HEAD:relay/relay.py"],
cwd=str(ROOT), capture_output=True, text=True,
encoding="utf-8", errors="replace").stdout
new = RELAY.read_text(encoding="utf-8")
if not old:
print(" [失败] 取不到 git 版本")
return 1
old_names = top_names(old)
new_names = top_names(new)
new_set = {n[1] for n in new_names}
missing = [item for item in old_names if item[1] not in new_set]
print(" git 版本顶层定义 %d 个,当前 %d 个"
% (len(old_names), len(new_names)))
print()
if not missing:
print(" 没有缺失 ✓")
return 0
print(" 缺失 %d 个:" % len(missing))
for kind, name, lineno in missing:
print(" %-6s %-28s (git 第 %d 行)" % (kind, name, lineno))
# 把缺失的部分从 git 里摘出来
old_lines = old.splitlines()
print()
print(" 缺失部分在 git 里的行范围:")
# 找最小的起止行
starts = [item[2] for item in missing]
print(" 从第 %d 行到文件末尾(共 %d 行)"
% (min(starts), len(old_lines) - min(starts) + 1))
print()
print(" 这些行的开头(确认是什么内容):")
for i in range(min(starts) - 1, min(len(old_lines),
min(starts) + 30)):
line = old_lines[i]
if line.strip():
print(" %5d: %s" % (i + 1, line[:84]))
# 存一份给恢复脚本用
out = ROOT / "_build" / "_missing_tail.py"
out.write_text("\n".join(old_lines[min(starts) - 1:]) + "\n",
encoding="utf-8")
print()
print(" 缺失的整段已存到 _build/_missing_tail.py")
return 0
if __name__ == "__main__":
sys.exit(main())