mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 17:10:43 +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
82 lines
4.3 KiB
Markdown
82 lines
4.3 KiB
Markdown
## 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` 命令处理完不返回
|
||
- 中转管理页加上网站图标
|