mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 12:30:44 +00:00
xmz7891
49fdec1da8
版本号 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
74 lines
3.8 KiB
Plaintext
74 lines
3.8 KiB
Plaintext
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
|