版本号 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
4.3 KiB
1.8.0
这一版主要是「修看不见的稳定性问题」+「把中转管理后台重做」。
-
修跨网络老断(Error 1033 / 502 / 530 的真因): 4G 链路会静默断开 TCP 连接(不发 FIN/RST,双方都以为还活着), Cloudflare 把请求发到这种"僵尸连接"上就报错。 而 Linux 默认要 2 小时才发现连接死了 —— 中间这段时间 服务一直"看着在线、实际打不开"。 现在改成 30 秒探测、60 秒内发现并重连
-
修跨网络抖动:隧道连接数从 2 提到 4。 只剩 1 条连接时跨机房回源会失败,实测可用率 0/12; 提到 4 条后稳定 12/12
-
修掉电重启后恢复太慢:原来开机要 2 分 10 秒公网才恢复, 那段时间浏览器看到的就是 Error 1033。 根因是系统里 NetworkManager 和 systemd-networkd 同时在跑, 后者等一个不归它管的网络,干等 2 分钟超时失败, 把启动流程一起拖住了。改完 17 秒就绪,掉电重启后 24 秒公网可用
-
修看门狗自己制造不稳定:它每隔 50 秒重启一次隧道, 但隧道重建 4 条连接要 30~60 秒 —— 每次还没建齐就被下一次打断, 永远停在"只剩 1 条"的状态。现在重启后有 150 秒宽限期
-
中转管理后台完全重做:原来是几百行内联代码, 改一处样式要在一堆转义符里翻。拆成独立模块, 界面重排成:顶栏状态 → 公网地址(最重要,给最大权重)→ 四个数字 → 设备表 → 工具卡。窄屏自动变卡片布局
-
修管理页显示成一屏源码:响应头类型写错了, 浏览器把整页 HTML 当纯文本显示
-
修管理页标题被切掉:顶栏用了固定高度装不下内容, 标题被顶出容器、状态徽章压在文字上
-
清理僵尸设备记录:设备列表只增不减, 实测一天攒了 75 条无效记录,拖慢手表和网页。 现在超过 6 小时没上报的自动清掉,占用的配对码一起释放
-
官网新增产品展示:手表界面预览(颜色和布局与真实手表一致)、 电脑端真实截图、两种连接方式对比图
-
支持
HEAD请求(原来一律返回 501)
1.7.1
- 修卸载卡死:从控制面板卸载时进度条永远走不完。
根因是被控端在无控制台的隐藏进程里调
AllocConsole和 读控制台输入,会永久阻塞 - 修安装回滚:旧版本程序还在后台跑时,安装器关不掉它, 弹「无法关闭所有应用程序」,静默安装会整个回滚 —— 用户看到的是"装了没反应"
- 修卸载残留:开机自启注册表项没删掉、安装目录留个空壳
- 修手表连上后一片白屏:分页初始化函数从没被调用过, 标签栏里只剩一个孤立的指示器
- 修「被控端已关闭新设备配对」把重装手表的人永久挡在外面: 配对码本身就是钥匙,拿着正确的码就该放行
- 手表端应用名改成 ykxmz
- 修跨网络延迟高:隧道退回了 QUIC(
--protocol http2参数丢失), 可用率只有 48%;恢复 HTTP/2 后可用率 100% - 网络调优持久化:TCP 缓冲 4 MB、FastOpen、 空闲后不重置拥塞窗口(长轮询场景关键)
- 手表提示改成自诊断式:连不上时直接打出双方地址, 一眼看出是网段不同还是连错了 WiFi
- 中转站的官网和管理后台分开:
/是官网(公开),/zhongzhuanzhan是管理后台(要登录) - 官网重新设计:导航 / 功能 / 三步上手 / 下载 / 常见问题
- 官网和管理页统一改成白色简洁风格
- 管理入口从官网上移除
1.7.0
- 电脑端改成 Windows 安装包(Inno Setup),双击安装,不再需要解压 zip
- 安装向导里填 6 位配对码,装完手表直接连,不用再跑一次设置
- 安装包支持静默批量部署:
ykxmz-setup-1.7.0.exe /VERYSILENT /CODE=123456 - 三份说明文档合并进安装向导,必须接受才能继续
- 修配置分裂问题:管理员装的配对码,普通用户账号看不到(数据目录改成按安装位置判断)
- 修装到 Program Files 后报「拒绝访问」:ProgramData 数据目录自动授权
- 修安装卡死:
--code命令处理完不返回 - 中转管理页加上网站图标