Files
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

117 lines
3.5 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- 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())