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
This commit is contained in:
xmz7891
2026-10-07 11:47:12 +08:00
parent c6e2120ca8
commit 49fdec1da8
26 changed files with 1232 additions and 45 deletions
+116
View File
@@ -0,0 +1,116 @@
# -*- coding: utf-8 -*-
r'''把 1.8.0 的三个成品上传到中转的下载目录。
发布规则(用户定的,不能违反):
* Windows 成品必须是**安装包 .exe**,不是 agent zip
(用户要"双击就能装",不能让他去解压)
* 服务端给 zip
* 手表给 APK
* 上一个版本的成品要删掉,别让用户下错
顺手做的事:
给 verify_all.ps1 补 UTF-8 BOM(edit 工具会吃掉 BOM,
PowerShell 按 GBK 读就会中文乱码 + 语法报错)
'''
from __future__ import annotations
import sys
from pathlib import Path
ROOT = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote")
sys.path.insert(0, str(ROOT / "_build"))
from devssh import run, upload # noqa: E402
VERSION = "1.8.0"
OLD_VERSIONS = ["1.7.0", "1.7.1", "1.6.0", "1.6.1", "1.5.0"]
REMOTE_DIR = "/root/lanremote-relay/downloads"
# 顺序就是官网上显示的优先级
UPLOADS = [
(f"dist/ykxmz-setup-{VERSION}.exe", f"{REMOTE_DIR}/ykxmz-setup-{VERSION}.exe"),
(f"dist/ykxmz-server-{VERSION}.zip", f"{REMOTE_DIR}/ykxmz-server-{VERSION}.zip"),
(f"dist/ykxmz-watch-{VERSION}.apk", f"{REMOTE_DIR}/ykxmz-watch-{VERSION}.apk"),
(f"dist/ykxmz-watch-{VERSION}-说明.txt",
f"{REMOTE_DIR}/ykxmz-watch-{VERSION}-说明.txt"),
]
VERIFY = ROOT / "_tests" / "verify_all.ps1"
def fix_bom() -> None:
raw = VERIFY.read_bytes()
if raw.startswith(b"\xef\xbb\xbf"):
print(" verify_all.ps1: BOM 正常")
else:
VERIFY.write_bytes(b"\xef\xbb\xbf" + raw)
print(" verify_all.ps1: 补回了 UTF-8 BOM")
def main() -> int:
fix_bom()
# 本地先确认三个成品都在
print()
print(" 本地成品检查:")
missing = []
for local, _remote in UPLOADS:
src = ROOT / local
if src.is_file():
print(" ✓ %-38s %7.2f MB"
% (src.name, src.stat().st_size / 1024 / 1024))
else:
print(" ✗ %-38s 不存在" % local)
missing.append(local)
if missing:
print()
print(" [失败] 少了 %d 个成品,先构建" % len(missing))
return 1
# 清掉旧版本,免得用户下错
print()
print(" 清理设备上的旧版本:")
run("mkdir -p " + REMOTE_DIR, timeout=30)
for old in OLD_VERSIONS:
_c, out, _e = run(
"ls %s/ 2>/dev/null | grep -F '%s' || true"
% (REMOTE_DIR, old), timeout=30)
for name in (out or "").strip().splitlines():
if not name.strip():
continue
run("rm -f '%s/%s'" % (REMOTE_DIR, name.strip()), timeout=30)
print(" - 删掉 %s" % name.strip())
# 上传
print()
print(" 上传:")
for local, remote in UPLOADS:
src = ROOT / local
try:
upload(str(src), remote, 0o644)
print(" ✓ %s (%.2f MB)"
% (src.name, src.stat().st_size / 1024 / 1024))
except Exception as exc: # noqa: BLE001
print(" ✗ %s: %s" % (src.name, exc))
return 1
# 确认
print()
print(" 设备上现在的下载目录:")
_c, out, _e = run("ls -la %s/" % REMOTE_DIR, timeout=30)
for line in (out or "").strip().splitlines():
print(" " + line)
# 确认中转能列出来
print()
print(" 中转接口返回的下载列表:")
_c, out, _e = run(
"curl -s --max-time 10 http://127.0.0.1:8080/v1/downloads", timeout=60)
print(" " + (out or "").strip()[:600])
return 0
if __name__ == "__main__":
sys.exit(main())