Files
ykxmz/_build/dbg_head.py
T
xmz7891 49fdec1da8 1.8.0:隧道稳定性大修 + 中转管理后台重做
版本号 1.7.1 -> 1.8.0(8 个文件,13 处)。
写了个 bump_180.py 统一处理 —— 版本号散落在
Python / Java manifest / PowerShell / Inno Setup / 测试里,
手动改必漏;而且 .ps1 必须保留 UTF-8 BOM。

==================== 一、隧道稳定性(用户撞上 1033/502/530)====================

1) 4G 链路会**静默断开 TCP 连接**(不发 FIN/RST,双方都以为还活着),
   Linux 默认要 2 小时才发现 -> 改成 keepalive 30 秒 + 每 10 秒探测。
   实测 60 秒内发现并重连。

2) 隧道连接数 2 -> 4。只剩 1 条连接时跨机房回源会失败
   (实测可用率 0/12,提到 4 条后 12/12)。

3) 掉电重启后恢复慢:原来开机 2 分 10 秒公网才可用。
   根因是 systemd-networkd-wait-online 等一个不归它管的网络
   (wlan0 是 NetworkManager 管的),干等 2 分钟超时失败,
   把 network-online.target 一起拖住。
   mask 掉它之后:启动 17.3 秒,掉电重启 24 秒公网可用。

4) 看门狗两次翻车都是我造成的,都修了:
   a) 我先加了"确认故障立刻重启",但隧道重建 4 条连接要 30~60 秒,
      MIN_RESTART_GAP=45 导致**还没建齐就被下一次重启打断**,
      死循环,每 50 秒重启一次 -> 加 150 秒宽限期
   b) 宽限期又带来"链路持续差时什么都不做"的问题
      -> 增加"本次重启后建齐过吗"的判断:
         建齐过又垮 = 真故障,立刻重启
         从没建齐 = 还在努力,继续等

5) 顺手修:看门狗状态文件里的变量在函数定义前被引用,
   set -u 下报 "BUILT: 未绑定的变量"。

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

原来的管理页是几百行内联在 relay.py 的 f-string 里,
改一处样式要在一堆转义花括号里翻。拆成独立模块 relay/admin.py。

新设计(对齐官网那套白色简洁):
  吸顶顶栏 -> 公网地址(最大权重,这是用户最需要复制的)
  -> 四个数字卡 -> 设备表 -> 工具卡(体检 + 下载)
  空状态给图标+引导文案;窄屏表格自动变卡片。
  relay.py 从 2089 行缩到 1500 行左右。

修了三个我自己引入的 bug:
  a) 响应头类型写错,浏览器把整页 HTML 当纯文本显示
     (用户看到的是"一屏源码")。教训:200 不等于页面能看,
     当时只验了状态码和字节数。
  b) 顶栏用了固定 height:62px,装不下"标题+副标题+版本信息"两行,
     内容被顶出容器 -> 标题看不见、徽章压在字上。
  c) do_HEAD 没处理 /download/ 路径,HEAD 一个 APK 返回
     Content-Length: 0 + text/plain,下载器会误判成空文件。
     同时发现 _head_info 里对 bytes 调 .encode() —— 加 _as_bytes() 兜住。

==================== 三、其它 ====================

* 设备记录只增不减:实测一天攒 75 条僵尸,/v1/health 从几 KB 涨到 20KB。
  加 DEVICE_TTL(6 小时)自动清,占用的配对码一起释放
  (管理页曾显示"配对码占用 131"但一台设备都没有)。
* HEAD 请求支持(原来一律 501)。
* 官网新增产品展示:手表界面预览(颜色/布局与真实手表一致)、
  电脑端真实截图、两种连接方式对比图。
* 加了一份 docs/免费托管方案.md(含一个纠错:上一版推荐的
  ClawCloud Run 已在 2026-05-11 关停)。

==================== 验收 ====================

全量回归            33 个阶段全部通过
安装包完整周期      20/20(静默装入 7 秒、卸载 0.6 秒、无残留)
网页响应头          12/12
公网可用率          26/30 = 86%(底层 4G 丢包 30%,是这个上限)
发布产物            安装包 14.37MB / 服务端 0.20MB / 手表 0.19MB
2026-10-07 11:47:12 +08:00

108 lines
3.7 KiB
Python

# -*- coding: utf-8 -*-
r'''调试:管理页的 HEAD 为什么报告成 text/plain。'''
from __future__ import annotations
import os
import subprocess
import sys
import time
import urllib.request
from pathlib import Path
ROOT = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote")
PORT = 8947
def wait(seconds=12.0) -> bool:
end = time.time() + seconds
while time.time() < end:
try:
with urllib.request.urlopen(
"http://127.0.0.1:%d/v1/health" % PORT, timeout=2):
return True
except Exception: # noqa: BLE001
time.sleep(0.5)
return False
def main() -> int:
# 先看代码里 _head_info 到底长什么样
print(" 代码里的 _head_info 分支顺序:")
src = (ROOT / "relay" / "relay.py").read_text(encoding="utf-8")
start = src.find("def _head_info")
for line in src[start:start + 2600].splitlines():
stripped = line.strip()
if stripped.startswith(("if ", "return ok", "return no",
"def ", "target =", "body =")):
print(" " + stripped[:78])
print()
print(" 直接 import 试调用:")
sys.path.insert(0, str(ROOT / "relay"))
os.environ["RELAY_PORT"] = str(PORT)
data = ROOT / "_build" / "_hdrdbg"
data.mkdir(parents=True, exist_ok=True)
os.environ["RELAY_DATA"] = str(data)
import importlib
import relay as relay_mod
importlib.reload(relay_mod)
handler = relay_mod.Handler
info = handler._head_info(None, relay_mod.ADMIN_PATH)
print(" ADMIN_PATH = %r" % relay_mod.ADMIN_PATH)
print(" 返回: %r" % (info,))
info2 = handler._head_info(None, "/")
print(" '/' 返回: status=%s ctype=%s len=%s"
% (info2["status"], info2["ctype"], info2["length"]))
info3 = handler._head_info(None, "/download/ykxmz-watch-1.8.0.apk")
print(" 下载返回: status=%s ctype=%s len=%s"
% (info3["status"], info3["ctype"], info3["length"]))
print()
print(" 真起一个中转,发 HEAD 看真实响应:")
env = dict(os.environ)
proc = subprocess.Popen([sys.executable, "relay.py"],
cwd=str(ROOT / "relay"), env=env,
stdout=subprocess.DEVNULL,
stderr=subprocess.PIPE)
try:
if not wait():
print(" [失败] 没起来")
err = proc.stderr.read(2000).decode("utf-8", "replace")
print(err[-800:])
return 1
for path in ("/", relay_mod.ADMIN_PATH, "/v1/health",
"/download/ykxmz-watch-1.8.0.apk"):
req = urllib.request.Request(
"http://127.0.0.1:%d%s" % (PORT, path), method="HEAD")
try:
with urllib.request.urlopen(req, timeout=8) as resp:
print(" %-38s %s len=%s type=%s"
% (path, resp.status,
resp.headers.get("Content-Length"),
resp.headers.get("Content-Type")))
except Exception as exc: # noqa: BLE001
print(" %-38s 异常 %s" % (path, exc))
finally:
proc.terminate()
try:
err = proc.stderr.read(3000).decode("utf-8", "replace")
except Exception: # noqa: BLE001
err = ""
try:
proc.wait(timeout=6)
except subprocess.TimeoutExpired:
proc.kill()
if "Traceback" in err:
print()
print(" 中转报错:")
print(" " + err.strip()[-1200:].replace("\n", "\n "))
return 0
if __name__ == "__main__":
sys.exit(main())