mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 13:40:45 +00:00
修「经中转几次后永久哑掉」——「按一下没反应」的真因
== 现象 ==
用户报：
* 局域网能搜到电脑，IP/端口/配对码都对，连上后**没有任何反应**
* 走中转「已配对」，但点按钮没反应
局域网那一半已经修过（preferLan）。这次抓到的是**经中转**那一半，
而且比预想的严重得多。
== 证据链（插桩复现出来的）==
被控端日志里直接抛了未捕获异常，线程当场死：
Exception in thread client-relay:
server.py:407 session.send(reply)
relay.py:166 self._link.send_to_client(data)
relay.py:357 self._post("/v1/agent/send", ...)
relay.py:766 raise RelayError(f"请求失败: {last_error}")
lanremote.relay.RelayError: 请求失败: Idle
之后的状态：
* client-relay 线程没了 —— 电脑再也不往手表回任何东西
* relay-link 线程还活着、还在长轮询 —— 中转那边看着「设备在线」
* **手表看到的就是「连上了，但按一下毫无反应」**
写入仓库的测试 _tests/test_relay_local.py 一直是这个形状：
前面几项 PASS、跑到经中转发命令就卡死。之前没人深挖。
== 根因 1：一条 HTTP/1.1 连接被两个线程同时用 ==
_post() 里锁只包住「取连接」那一段：
with self._http_lock:
connection = self._http # 锁到这里就放了
try:
connection.request("POST", ...) # 锁外发请求
于是两个线程会同时用同一条 connection：
* relay-link 线程跑 /v1/agent/poll —— 长轮询，一条请求挂 180 秒
* client-relay 线程同时 POST /v1/agent/send
HTTP/1.1 一条连接同一时刻只能有一个在途请求，第二个线程一进来
就撞上 http.client 状态机，抛 CannotSendRequest("Idle")。
_post 的「重试一次」也救不了：它 _drop_http() 之后，另一个线程
手里还攥着那条旧连接对象在发，照样坏。
修法：
* **发命令用独立连接**（_post 加 dedicated 参数）。
长轮询那条常年被占着，发命令不该去挤它，各走各的。
* 两条连接各自一把锁**锁住整个「发请求 + 读响应」周期**，
不再只锁取连接那一下。
* 普通请求若发现缓存连接正忙（长轮询在途），临时另开一条用完即关。
* _drop_http(dedicated=) 区分清哪条；finally 里一定归还占用
（否则那条连接会被永久标记为忙）。
== 根因 2：回包失败会打死整个会话线程 ==
server.py 的 _client_loop 里：
if reply is not None:
session.send(reply) # <- 不在任何 try 里
...
except OSError: # <- 外层只捕获 OSError
pass
而中转链路上 send 抛的是 RelayError，直接冒出去把线程打死。
**死一次就永久哑**，代价太大。
修法：session.send() 单独兜住所有异常，失败就断开这个会话
（让手表重连），绝不让线程消失。外层也补一个兜底 except。
== 修复效果 ==
修复前：pair OK -> ping OK -> ping 卡死 -> 线程崩溃，永久哑
修复后：pair 21ms -> ping 82ms -> ping 4ms -> ping 6ms，零异常
_tests/test_relay_local.py：**之前完全卡死 -> 现在 21/21 全过**
这个测试之前一直是红的，说明「35 个阶段的回归全绿」这件事
本身就不成立过 —— 某个阶段卡住时看起来像环境问题而不是缺陷。
== 同批修掉验证阶段找到的其它问题 ==
1. **TTL 清理 + 关掉接入开关 = 设备永久锁死**（严重）
register() 用 `device_id in self.devices` 判断老设备，但超时清理
把设备从 devices 和 codes 都删了。电脑关机过夜（必然 > 6 小时）
第二天开机就会被自己的开关挡住，而且**重启也救不回来**
（清 codes 时没落盘，重启后又当孤儿清一遍，自我维系）。
管理员在页面上还看不到这台设备，不知道该放开谁。
修法：状态文件里单独存 knownDevices 设备历史，超时清理绝不动它；
register 改查这份历史；清理后补 _save()；delete_device 才真正忘记。
2. **管理页 JS 语法错误 -> 所有按钮失效**（严重）
admin.py 里 ADMIN_JS 是普通三引号字符串，我在 Python 源码里写的
`\n` 被变成真实换行，拼进 JS 就是字符串里的裸换行 ->
整段 <script> 不执行 -> 改码/删除/批量删除/全选全变幽灵按键。
元凶是我加改码功能那次提交。改成 `\\n`。
3. **--relay / --relay-status 崩溃**（严重）
RelayLink.start(url) 的 url 是必填参数，我把默认地址改空白时
run_agent.py 两处调用没跟着改。一处被 try 吞成「测试失败：missing
1 required positional argument」（用户以为地址填错了），
一处直接报栈。两处都补上 url。
4. 非法 deviceId（控制字符 / 路径分隔符）现在被拒（白名单：
字母数字 + - _ . :）
5. enable_relay() 第二次调用不再谎报成功（加 RelayLink.running 属性，
返回值反映真实运行状态；不再用「对象建过没有」判断）
6. snapshot() 清孤儿码后补 _save()，磁盘和内存不再脱节
== 局域网全面优化（task-2，另一个智能体完成）==
4 个真问题：
* **网段判断写死 /24** —— 在 /16 网络上 10.8.1.5 和 10.8.2.5
被判成不同网络，明明能直连却去走中转还费流量。
改成按网卡真实掩码比较。
* **广播只发一个包** —— 丢一个就整轮搜不到。改成 5 个时间点重发。
* **只探一个网段** —— 多网卡手表搜不到另一网段的电脑。改成全探。
* **走中转之后再也回不到局域网** —— 出门再回家永远挂中转。
新增定期回切（先便宜地 TCP ping，通了才动真格，
不破坏正在工作的中转连接）。
实测：局域网握手 2ms、50/50 = 100%、中位 0ms。
（跨网络那半之前拿不到数字，就是被上面那个线程崩溃挡住的 ——
现已修复。）
顺带：instance.py 单实例锁端口加 YKXMZ_LOCK_PORT 覆盖（默认不变）。
用户自己那台被控端正跑在这台机器上占着 8767/TCP + 8766/UDP，
是这次排查里好几个「测试怎么都不通」的根因。
== 服务端一键部署脚本（task-1，另一个智能体完成）==
relay/deploy.sh + relay/deploy-tune.sh，随服务端 zip 发布：
* 自动检查并安装 cloudflared
* 部署程序、装 4 个 systemd 服务、网络调优、配隧道、自检打公网地址
* **不传 --hostname 且没有 TUNNEL_TOKEN 时明确提示要填**，
不会静默用一个写死的域名（用户明确说过这个中转站是他自己用的，
不对外开放，绝不能把私人域名烧成默认值）
* 重跑 = 升级，已有数据/配对码/管理密码/凭据都不动
顺带修了发布包一直缺 site_shots/ 的老 bug
（package_remote.py 用 iterdir()+is_file() 收文件，目录进不去，
新机器装完官网截图全是 404）。
== 默认中转地址改成空白 ==
用户要求：软件默认不带任何中转地址，由用户自己填。
四处硬编码全部清空（server.py / MainActivity.java / run_agent.py /
relay.py 的注释和文档示例），全仓已无非注释的硬编码地址。
== 文档同步（task-5，另一个智能体完成）==
README / BEFORE-INSTALL / AFTER-INSTALL / 打包模板：
* 新增「软件里不带任何中转地址」告示，讲清跨网络要自己部署
* 修正 Android 版本（写的是 9.0/API28，实际 API 24 / Android 7.0）
* 删掉「地址已经内置好了」（现在是错的）
* AGENT_README 原来把作者自己的中转地址当成「内置地址」发给用户，已重写
* RELAY_README 原来写「两条隧道同时跑会互相争抢」，
和真机/CHANGELOG 矛盾；按实测改成「两种协议同时在跑（故意的）」
This commit is contained in:
xmz7891
+124
-56
@@ -54,30 +54,38 @@ TOP_README = f"""========================================================
|
||||
3-控制端(手表) 装在你的安卓手表上。一个 APK，直接装。
|
||||
|
||||
|
||||
【怎么用】三步
|
||||
【怎么用】四步
|
||||
|
||||
第一步：架服务器端（只做一次）
|
||||
把「2-服务器端」整个文件夹拷到随身 WiFi 上，执行：
|
||||
bash install.sh
|
||||
它会装好中转服务 + Cloudflare 隧道，并打印一个**公网地址**。
|
||||
记下这个地址（形如 https://relay.你的域名）。
|
||||
**先说最要紧的一条：本软件不带任何中转地址，也不提供官方服务器。**
|
||||
只在同一个 WiFi 下用（手表 + 电脑连同一个路由器）的话，
|
||||
跳过第一步和第四步，装完就能连。
|
||||
要跨网络（在办公室管教室），必须自己搭一台中转站。
|
||||
|
||||
小提示：公网地址每次重启会变。忘了地址就打开
|
||||
http://<随身WiFi的IP>:8080/url —— 直接返回当前地址。
|
||||
第一步：架服务器端（只做一次，**跨网络才需要**）
|
||||
把「2-服务器端」整个文件夹拷到那台能上外网的 Linux 小机器上，执行：
|
||||
bash deploy.sh
|
||||
它会装好中转服务 + 网络调优 + Cloudflare 隧道，并打印一个
|
||||
**属于你自己的公网地址**。记下这个地址。
|
||||
（形如 https://你的域名 —— 域名是你自己的，脚本里没有默认域名。）
|
||||
|
||||
小提示：忘了地址就在那台机器上执行 lanremote-url，或者浏览器打开
|
||||
http://<那台机器的IP>:8080/url —— 直接返回当前地址。
|
||||
|
||||
第二步：装被控端（电脑上，只做一次）
|
||||
双击 ykxmz.exe
|
||||
双击安装包
|
||||
→ 输入 6 位配对码（自己定，比如 789113）
|
||||
→ 勾上"开机自启"和"放行防火墙"
|
||||
→ 点确定，会弹一次管理员确认，之后窗口全消失，后台静默运行
|
||||
|
||||
告诉它中转地址（这样才跨网络）：
|
||||
ykxmz.exe --relay https://relay.你的域名
|
||||
|
||||
第三步：装控制端（手表上）
|
||||
装 APK → 首页点「中转设置」→ 填同一个中转地址
|
||||
→ 点「自动搜索电脑」（同局域网）或直接输配对码
|
||||
→ 连上
|
||||
装 APK
|
||||
→ 点「自动搜索电脑」（同一个 WiFi 下用这个，不用填地址）
|
||||
→ 或者点「输入配对码连接」填电脑上那个 6 位码
|
||||
|
||||
第四步：跨网络的话，把中转地址填上（**自己搭的那个**）
|
||||
电脑： ykxmz.exe --relay https://你的域名
|
||||
手表： 首页点「中转设置」→ 填同一个地址
|
||||
然后回首页点「输入配对码连接」，输那 6 位数字，连上。
|
||||
|
||||
|
||||
【关于配对码：单设备单配对码】
|
||||
@@ -134,35 +142,37 @@ AGENT_README = f"""========================================================
|
||||
（没有托盘图标、没有窗口、没有终端）
|
||||
|
||||
|
||||
【开箱即用：一个地址都不用填】
|
||||
【开箱即用：一个地址都不用填（同一个 WiFi 下）】
|
||||
|
||||
程序里**已经内置了中转地址**，双击就能用。
|
||||
手表和这台电脑连**同一个路由器**时，直接就能连上，
|
||||
配对码对上就行 —— 不需要任何服务器、不需要填任何地址。
|
||||
|
||||
内置的是两个，用分号隔开，按顺序尝试：
|
||||
192.168.2.156:8080;https://relay.xxmxxs.top
|
||||
|
||||
电脑和随身 WiFi 在同一个网络 -> 走第一个
|
||||
（局域网直连，几十毫秒，地址永远不变）
|
||||
电脑在外面 -> 第一个连不上，自动切第二个
|
||||
（Cloudflare 隧道，600 毫秒左右）
|
||||
|
||||
想改成别的当然也可以，见下一节。
|
||||
程序会自己往局域网广播找电脑，所以电脑上装了几块虚拟网卡、
|
||||
IP 是多少，都不用管。
|
||||
|
||||
|
||||
【跨网络：告诉它中转地址】
|
||||
【跨网络：必须自己搭一台中转站，然后填地址】
|
||||
|
||||
支持**多个地址**，用分号隔开，按顺序尝试，第一个通的就用它。
|
||||
⚠ **本软件没有内置任何中转地址，作者也不对外提供中转服务。**
|
||||
要跨网络用（比如在办公室管教室），你得自己部署一台中转站：
|
||||
服务端压缩包里有 deploy.sh，一条命令装好，它会打印一个
|
||||
属于你自己的公网地址。然后把这个地址填给被控端：
|
||||
|
||||
推荐这样配（局域网优先，断了自动切隧道）：
|
||||
ykxmz.exe --relay "192.168.2.156:8080;relay.xxmxxs.top"
|
||||
ykxmz.exe --relay https://你的域名
|
||||
|
||||
为什么局域网优先？
|
||||
* 快：局域网几十毫秒，绕隧道要 600 毫秒左右
|
||||
只在同一个 WiFi 下用的话，这一节完全不用管。
|
||||
|
||||
|
||||
【支持多个地址，按顺序试】
|
||||
|
||||
用分号隔开，第一个通的就用它。推荐把局域网地址也写进去：
|
||||
|
||||
ykxmz.exe --relay "192.168.1.50:8080;https://你的域名"
|
||||
|
||||
为什么带上局域网地址？
|
||||
* 快：局域网几十毫秒，绕隧道要一秒多
|
||||
* 稳：不依赖隧道，隧道抽风也不影响
|
||||
* 地址永远不变：不用管隧道地址变来变去
|
||||
|
||||
只走隧道也行：
|
||||
ykxmz.exe --relay https://relay.xxmxxs.top
|
||||
* 那个地址永远不变，不用管公网地址变没变
|
||||
|
||||
地址**不用写 http:// 或 https://**，程序会自己判断：
|
||||
192.168.x.x / 10.x.x.x / *.local -> 按 http 连（局域网是明文）
|
||||
@@ -177,13 +187,15 @@ AGENT_README = f"""========================================================
|
||||
|
||||
【忘了中转地址？】
|
||||
|
||||
如果随身 WiFi 在你身边（同一个网络），浏览器打开：
|
||||
http://<随身WiFi的IP>:8080/url
|
||||
它会告诉你当前的公网地址（纯文本，不用登录）。
|
||||
如果那台小机器在你身边（同一个网络），浏览器打开：
|
||||
http://<它的IP>:8080/url
|
||||
它会直接返回当前的公网地址（纯文本，不用登录）。
|
||||
|
||||
小技巧：把局域网地址也填进 --relay，电脑在家里就走局域网，
|
||||
完全不用管隧道地址变没变：
|
||||
ykxmz.exe --relay "192.168.2.156:8080;relay.xxmxxs.top"
|
||||
或者在那台机器上执行：
|
||||
lanremote-url
|
||||
|
||||
小技巧：把局域网地址也填进 --relay，就永远不用管公网地址变没变：
|
||||
ykxmz.exe --relay "192.168.1.50:8080;https://你的域名"
|
||||
|
||||
|
||||
【配对码被别人占了会弹通知】
|
||||
@@ -264,7 +276,8 @@ RELAY_README = f"""========================================================
|
||||
1. 检查并安装 cloudflared（已经装了就用现成的）
|
||||
2. 把中转程序装到 /root/lanremote-relay/
|
||||
3. 网络调优（keepalive / MSS / MTU / 开机加速）
|
||||
4. 注册并启动 4 个 systemd 服务（开机自启）
|
||||
4. 注册 systemd 服务并设成开机自启
|
||||
（中转、网络调优、两份隧道、看门狗）
|
||||
5. 配好 Cloudflare 隧道
|
||||
6. 自检，然后把**公网地址**打印出来
|
||||
|
||||
@@ -327,6 +340,25 @@ RELAY_README = f"""========================================================
|
||||
能操作：踢会话、抹掉配对码绑定
|
||||
|
||||
|
||||
【下载区：静态文件走 Cloudflare 边缘缓存】
|
||||
|
||||
官网页面上的三个文件（安装包 / 服务端 zip / APK）和产品截图，
|
||||
都由 Cloudflare 的边缘节点**直接发送**，不用回源到这台小机器。
|
||||
|
||||
这不是默认行为 —— relay.py 给这些路径发了
|
||||
`Cache-Control: public, max-age=604800, immutable`
|
||||
（下载文件名带版本号，同一名字内容永不改变，所以能长缓存）。
|
||||
|
||||
为什么重要：这台机器通常在 4G 上，回源吞吐实测只有 3~67 KB/s，
|
||||
15 MB 的安装包根本下不动。走边缘之后实测 695 KB/s，快四十多倍，
|
||||
而且**不消耗这台机器的流量**。
|
||||
|
||||
换了新版本的安装包怎么办？
|
||||
文件名里带版本号（ykxmz-setup-1.8.2.exe），新文件是新 URL，
|
||||
自然就是新的缓存条目，不会拿到旧的。
|
||||
旧版本的条目到期（7 天）后自动消失。
|
||||
|
||||
|
||||
【网络调优：这些参数都是实测调出来的】
|
||||
|
||||
deploy-tune.sh 会做这五件事，改动之前先看它开头的说明：
|
||||
@@ -359,21 +391,43 @@ RELAY_README = f"""========================================================
|
||||
实测：掉电重启后公网恢复 2 分 10 秒 -> 24 秒。
|
||||
|
||||
|
||||
【隧道的两套配置】
|
||||
【隧道：两种协议同时在跑（这是故意的）】
|
||||
|
||||
deploy.sh 会装两份隧道服务，但**只启用一份** ——
|
||||
两条隧道同时跑会互相争抢，实测反而更不稳。
|
||||
deploy.sh 会装**两份**隧道服务，而且**两份都启用**：
|
||||
|
||||
lanremote-tunnel 主用（默认 quic）
|
||||
lanremote-tunnel-h2 备用（http2）
|
||||
lanremote-tunnel QUIC
|
||||
lanremote-tunnel-h2 HTTP/2
|
||||
|
||||
想切换：
|
||||
systemctl disable --now lanremote-tunnel
|
||||
systemctl enable --now lanremote-tunnel-h2
|
||||
它们跑的是**同一个隧道 ID**，Cloudflare 会把请求分摊到两个实例
|
||||
注册上来的全部连接上（合计 10 条，横跨两种协议）。
|
||||
|
||||
为什么默认 quic：尾部延迟好得多（实测 P99 2.99 秒 vs 13.9 秒）。
|
||||
什么时候换 http2：这条线路对 UDP 特别不友好的时候
|
||||
（日志里大量 "Failed to dial a quic connection"）。
|
||||
为什么要这么干 —— 两种协议各有各的病，实测：
|
||||
|
||||
QUIC 尾部延迟好（P90 约 2.5 秒），
|
||||
但建连会 "no recent network activity" 超时，偶发失败
|
||||
HTTP/2 建连可靠（走 TCP，受 MSS 钳制保护），
|
||||
但尾部延迟差（P90 约 14 秒）——
|
||||
TCP 队头阻塞：一条连接上丢一个包，所有流一起卡
|
||||
|
||||
两个同时跑 = 协议级故障隔离。QUIC 那半边犯病时 HTTP/2 还在服务，
|
||||
反过来也一样。实测连续 25 分钟可用率 100%（单协议时是 96~98%）。
|
||||
|
||||
所以**不要**为了"省内存"随手停掉其中一个 —— 停了就退化成单协议了。
|
||||
|
||||
真想只留一种（比如这台机器的线路对 UDP 特别不友好，
|
||||
日志里大量 "Failed to dial a quic connection"）：
|
||||
|
||||
systemctl disable --now lanremote-tunnel-h2 # 只留 QUIC
|
||||
systemctl disable --now lanremote-tunnel # 只留 HTTP/2
|
||||
|
||||
|
||||
【改端口 / 改协议 / 换域名】
|
||||
|
||||
重跑 deploy.sh，带上参数就行（幂等，不会冲掉已有数据）：
|
||||
|
||||
bash deploy.sh --protocol http2 # 主实例换成 http2
|
||||
bash deploy.sh --port 9090 # 换监听端口
|
||||
bash deploy.sh --hostname relay.你的域名
|
||||
|
||||
|
||||
【省内存】
|
||||
@@ -398,18 +452,32 @@ WATCH_README = f"""========================================================
|
||||
【连】
|
||||
|
||||
1) 打开 App，首页有四个东西：
|
||||
中转设置（跨网络用） 填服务器端给的地址
|
||||
中转设置（跨网络用） **填你自己搭的那台中转站的地址**
|
||||
局域网连接（同一个WiFi）同一个 WiFi 时走这条，最快
|
||||
输入配对码连接 经中转连
|
||||
服务器：还没测 点右边「检查服务器」看延迟
|
||||
|
||||
2) 电脑和手表在同一个 WiFi -> 点「局域网连接」，自动搜到电脑，点一下就连
|
||||
电脑在外面 -> 点「输入配对码连接」，填电脑上那个 6 位码
|
||||
电脑在外面 -> 先点「中转设置」填地址（见下），
|
||||
再点「输入配对码连接」，填电脑上那个 6 位码
|
||||
|
||||
3) 连上后是 10 个标签页：
|
||||
媒体 屏幕 文件 语音 电脑 网络 系统 教室 效率 娱乐
|
||||
|
||||
|
||||
【中转地址要自己填】
|
||||
|
||||
⚠ **App 里没有内置任何中转地址，作者也不对外提供中转服务。**
|
||||
|
||||
只在同一个 WiFi 下用的话，不用填任何地址 —— 点「局域网连接」就行。
|
||||
|
||||
要跨网络，你必须先自己部署一台中转站（服务端 zip 里有 deploy.sh
|
||||
一键脚本），拿到它打印的公网地址，填进「中转设置」。
|
||||
电脑那边也要填同一个地址：ykxmz.exe --relay https://你的域名
|
||||
|
||||
两个地址填得不一样是连不上的 —— 这是最常见的坑。
|
||||
|
||||
|
||||
【连不上时看这个】
|
||||
|
||||
App 会把错误翻译成人话：
|
||||
|
||||
Reference in New Issue
Block a user