Files
ykxmz/_build/CHANGELOG.md
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

4.3 KiB
Raw Blame History

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 命令处理完不返回
  • 中转管理页加上网站图标