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

用户反馈两件事:
  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
+145
View File
@@ -0,0 +1,145 @@
# -*- coding: utf-8 -*-
r'''重新拍电脑端窗口截图(旧图还写着改名前的"局域网遥控 被控端")。
顺便拍几张不同状态的,官网上能展示"这东西长什么样"。
做法:用 --code 启动(非 --silent,所以会显示窗口),
然后用 Win32 的 PrintWindow 把窗口内容抓下来。
不用截整个屏幕 —— 那样会把桌面上的别的东西也拍进去。
'''
from __future__ import annotations
import ctypes
import os
import subprocess
import sys
import time
from ctypes import wintypes
from pathlib import Path
ROOT = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote")
SHOTS = ROOT / "_build" / "site_shots"
EXE = ROOT / "dist_exe" / "ykxmz" / "ykxmz.exe"
user32 = ctypes.windll.user32
gdi32 = ctypes.windll.gdi32
def find_window(title_part: str) -> int:
"""按标题片段找窗口句柄。"""
found = []
@ctypes.WINFUNCTYPE(ctypes.c_bool, wintypes.HWND, wintypes.LPARAM)
def callback(hwnd, _lparam):
length = user32.GetWindowTextLengthW(hwnd)
if length:
buf = ctypes.create_unicode_buffer(length + 1)
user32.GetWindowTextW(hwnd, buf, length + 1)
if title_part in buf.value and user32.IsWindowVisible(hwnd):
found.append((hwnd, buf.value))
return True
user32.EnumWindows(callback, 0)
return found[0] if found else (0, "")
def capture(hwnd: int, path: Path) -> bool:
"""用 PrintWindow 抓窗口内容(比截屏干净,不带桌面背景)。"""
rect = wintypes.RECT()
user32.GetWindowRect(hwnd, ctypes.byref(rect))
width = rect.right - rect.left
height = rect.bottom - rect.top
if width <= 0 or height <= 0:
return False
hdc_window = user32.GetWindowDC(hwnd)
hdc_mem = gdi32.CreateCompatibleDC(hdc_window)
bitmap = gdi32.CreateCompatibleBitmap(hdc_window, width, height)
gdi32.SelectObject(hdc_mem, bitmap)
# 2 = PW_RENDERFULLCONTENT,win10+ 抓 DWM 合成内容必须用这个
ok = user32.PrintWindow(hwnd, hdc_mem, 2)
class BITMAPINFOHEADER(ctypes.Structure):
_fields_ = [("biSize", wintypes.DWORD),
("biWidth", wintypes.LONG),
("biHeight", wintypes.LONG),
("biPlanes", wintypes.WORD),
("biBitCount", wintypes.WORD),
("biCompression", wintypes.DWORD),
("biSizeImage", wintypes.DWORD),
("biXPelsPerMeter", wintypes.LONG),
("biYPelsPerMeter", wintypes.LONG),
("biClrUsed", wintypes.DWORD),
("biClrImportant", wintypes.DWORD)]
header = BITMAPINFOHEADER()
header.biSize = ctypes.sizeof(BITMAPINFOHEADER)
header.biWidth = width
header.biHeight = -height # 负数 = 自上而下
header.biPlanes = 1
header.biBitCount = 32
header.biCompression = 0
buffer_size = width * height * 4
buffer = ctypes.create_string_buffer(buffer_size)
gdi32.GetDIBits(hdc_mem, bitmap, 0, height, buffer, ctypes.byref(header), 0)
# 用 Pillow 存(项目里本来就有)
from PIL import Image
image = Image.frombuffer("RGBA", (width, height), buffer,
"raw", "BGRA", 0, 1)
image.convert("RGB").save(path)
gdi32.DeleteObject(bitmap)
gdi32.DeleteDC(hdc_mem)
user32.ReleaseDC(hwnd, hdc_window)
return bool(ok)
def main() -> int:
SHOTS.mkdir(parents=True, exist_ok=True)
os.environ["YKXMZ_DATA"] = str(ROOT / "_build" / "_shots_data")
Path(os.environ["YKXMZ_DATA"]).mkdir(parents=True, exist_ok=True)
print(" 启动被控端(会显示窗口)")
env = dict(os.environ)
proc = subprocess.Popen(
[str(EXE), "--code", "789113", "--port", "8899", "--name", "教室电脑"],
cwd=str(ROOT), env=env,
stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
time.sleep(9)
hwnd, title = find_window("ykxmz")
if not hwnd:
print(" [失败] 没找到窗口")
proc.terminate()
return 1
print(" 找到窗口: %r" % title)
# 拉到屏幕内可见位置,保证 PrintWindow 能拿到内容
user32.SetForegroundWindow(hwnd)
user32.MoveWindow(hwnd, 60, 60, 420, 460, True)
time.sleep(2)
out = SHOTS / "pc-main.png"
if capture(hwnd, out):
print(" ✓ 拍了 %s %.1f KB" % (out.name, out.stat().st_size / 1024))
else:
print(" [失败] 抓取失败")
proc.terminate()
try:
proc.wait(timeout=8)
except subprocess.TimeoutExpired:
proc.kill()
print()
print(" 产物:")
for p in sorted(SHOTS.glob("*.png")):
print(" %-24s %6.1f KB" % (p.name, p.stat().st_size / 1024))
return 0
if __name__ == "__main__":
sys.exit(main())