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