From facb156acafaf995a0a703b32a00ce91c0f8d965 Mon Sep 17 00:00:00 2001 From: xmz7891 Date: Wed, 7 Oct 2026 17:28:09 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9C=8D=E5=8A=A1=E7=AB=AF=20zip=20=E5=8A=A0?= =?UTF-8?q?=E4=B8=80=E9=94=AE=E9=83=A8=E7=BD=B2=E8=84=9A=E6=9C=AC=EF=BC=88?= =?UTF-8?q?cloudflared=20=E5=AE=89=E8=A3=85=20+=20=E9=83=A8=E7=BD=B2=20+?= =?UTF-8?q?=20=E5=85=AC=E7=BD=91=EF=BC=8C=E5=85=A8=E8=87=AA=E5=8A=A8?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户要求：服务器端文件里放一个 .sh，双击就能检查 cloudflared 装没装、 自动部署、配好公网，以后全自动。 == 新增 == relay/deploy.sh 一键部署主脚本，7 步全自动： 环境检查 -> 装 cloudflared -> 部署程序 -> 网络调优 -> 写 4 个 systemd 服务 -> 配隧道 -> 启动自检打公网地址 relay/deploy-tune.sh 网络调优，可单独重跑： keepalive 30/10/3 + 路径 MTU 探测 + MSS 1360 + 接口 MTU 1400 + mask networkd-wait-online 每一项都写明了实测依据 用法： bash deploy.sh 复用已有凭据，全自动 TUNNEL_TOKEN=eyJh... bash deploy.sh Token 模式 bash deploy.sh --hostname relay.你的域名 换域名 bash deploy.sh --skip-tunnel 只装中转 bash deploy.sh --help 全部参数 重跑 = 升级；已有数据/配对码/管理密码/凭据/手改过的 config.yml 都不动。 == 自动化到什么程度 == * cloudflared 不在就自动下载装上（并校验能执行） * 隧道支持两种模式：已有凭据文件、或 TUNNEL_TOKEN * **不传 --hostname 且没有 Token 时明确提示要填**，不会静默用一个写死的值 （用户明确说过：这个中转站是他自己用的，不对外开放， 绝不能把私人域名烧成默认值） * deploy-tune.sh 的 MTU 取 1400：路径 MTU 实测 1472， 而 MSS 钳制只管 TCP、QUIC 走 UDP 完全不受保护； 接口 MTU 降到 1400 后 QUIC 建齐 10 条连接从 28 秒缩到 12 秒 == 顺带修掉两个真 bug == 1. write_tunnel_unit 写的文件名漏了 .service 后缀 —— 文件写下去了但 systemd 完全看不见，enable 还会安静地失败。 2. 发布包一直缺 site_shots/（老 bug）： package_remote.py 用 iterdir() + is_file() 收文件，目录进不去。 新机器装完官网截图全是 404。只有从 zip 解压真跑一遍才暴露。 同时把 deploy.sh 里 site_shots 的检查降级成警告（缺截图不该让部署失败）。 另外给 deploy-tune.sh 清旧 MSS 规则的循环加了 10 次上限 —— 原写法在 -D 报成功但规则仍在时会死循环把整个部署卡死。 == 验证 == * _build/test_deploy_sh.sh 沙箱 65 项，全通过 * _build/test_zip_deploy.sh 从发布 zip 解压再跑，30 项，全通过 * _build/test_deploy_real.sh **真机 Debian 上实测**（新增）： zip 解出 17 个文件 -> 语法/LF/无 BOM 通过 --help 退出码 0 且无副作用、未知参数退出码 2 沙箱安装成功、幂等重跑哨兵不被冲 现有三个中转服务全程 active，自检 200 --- _build/CHANGELOG.md | 27 ++ _build/fix_sh_format.py | 82 ++++ _build/package_remote.py | 144 ++++-- _build/patch_relay_readme.py | 204 +++++++++ _build/test_deploy_real.sh | 97 ++++ _build/test_deploy_sh.sh | 494 +++++++++++++++++++++ _build/test_zip_deploy.sh | 221 ++++++++++ relay/deploy-tune.sh | 149 +++++++ relay/deploy.sh | 831 +++++++++++++++++++++++++++++++++++ relay/net-tune.sh | 171 +++++-- 10 files changed, 2331 insertions(+), 89 deletions(-) create mode 100644 _build/fix_sh_format.py create mode 100644 _build/patch_relay_readme.py create mode 100644 _build/test_deploy_real.sh create mode 100644 _build/test_deploy_sh.sh create mode 100644 _build/test_zip_deploy.sh create mode 100644 relay/deploy-tune.sh create mode 100644 relay/deploy.sh diff --git a/_build/CHANGELOG.md b/_build/CHANGELOG.md index d4a966a..1d8b18e 100644 --- a/_build/CHANGELOG.md +++ b/_build/CHANGELOG.md @@ -1,3 +1,30 @@ +## 1.8.2 + +- **下载快了几十倍**：安装包和 APK 改成由 Cloudflare 的边缘节点直接发送。 + 原来每次下载都要穿过隧道回到那台 4G 小机器上取文件，实测吞吐只有 + 3~67 KB/s，15 MB 的安装包根本下不动（还会中途断掉）。 + 现在改走边缘缓存：同一个文件实测从 **17 KB/s 提到 695 KB/s**， + APK 从 3 KB/s 提到 101 KB/s，并且不再消耗 4G 流量。 + +- **跨网络连接更稳**：隧道改成**两种协议同时跑** + （QUIC 5 条 + HTTP/2 5 条，共 10 条连接）。 + 两种协议各有各的毛病 —— QUIC 尾部延迟好但建连容易超时， + HTTP/2 建连可靠但丢包时容易卡住。同时跑就是互相兜底： + 一边犯病另一边还在服务。 + 实测 25 分钟连续可用率 **50/50 = 100%**（改之前是 96~98%）。 + +- 修**网卡 MTU 和 QUIC 不匹配**：之前只给 TCP 做了 MSS 钳制， + 而 QUIC 走 UDP 完全不受保护，包一大就被中间设备悄悄丢掉。 + 把网卡 MTU 降到 1400 之后，QUIC 建齐 10 条连接的时间从 + **28 秒缩到 12 秒**。 + +- 修**响应头不一致**：下载接口之前对 GET 和 HEAD 报的缓存信息不一样， + 部分下载工具（IDM、迅雷）探测时会把文件误判成不可缓存甚至空文件。 + +- 修**偶尔闪一下"已断开"**：原来只要有一次请求失败就立刻显示离线， + 而 4G 链路上本来就有 2~4% 的偶发失败、一两秒就自己恢复。 + 现在改成**连续失败 3 次**才判离线 —— 真的断了仍然如实显示。 + ## 1.8.1 - 修**局域网连接被中转劫持**（重要）： diff --git a/_build/fix_sh_format.py b/_build/fix_sh_format.py new file mode 100644 index 0000000..bc37fab --- /dev/null +++ b/_build/fix_sh_format.py @@ -0,0 +1,82 @@ +# -*- coding: utf-8 -*- +r'''把新增的 .sh 规范化成「LF + UTF-8 无 BOM」，并做静态检查。 + +为什么必须检查： + 仓库里所有 .sh 都是 LF + 无 BOM。一旦混进 CRLF， + 在 Linux 上跑会报 `bash: $'\r': command not found`， + 而且报错位置会很莫名（通常是 `#!/bin/bash\r` 那一行）。 + .bat 才用 GBK+CRLF，别搞混。 + +用法: + python _build/fix_sh_format.py # 检查并修 + python _build/fix_sh_format.py --check # 只检查不改 +''' +from __future__ import annotations + +import subprocess +import sys +from pathlib import Path + +ROOT = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote") +TARGETS = [ + ROOT / "relay" / "deploy.sh", + ROOT / "relay" / "deploy-tune.sh", +] +BASH = r"C:\Program Files\Git\bin\bash.exe" + + +def main() -> int: + check_only = "--check" in sys.argv + bad = 0 + + for path in TARGETS: + if not path.is_file(): + print(" [缺] %s" % path.name) + bad += 1 + continue + raw = path.read_bytes() + crlf = raw.count(b"\r\n") + lone_cr = raw.count(b"\r") - crlf + bom = raw.startswith(b"\xef\xbb\xbf") + print(" %-18s CRLF=%-4d 单独CR=%-3d BOM=%s" + % (path.name, crlf, lone_cr, "有" if bom else "无")) + + if crlf or lone_cr or bom: + if check_only: + print(" -> 需要修") + bad += 1 + else: + data = raw.replace(b"\r\n", b"\n").replace(b"\r", b"\n") + if bom: + data = data[3:] + path.write_bytes(data) + print(" -> 已修成 LF + 无 BOM") + else: + print(" -> 格式正确") + + print() + print(" 语法检查（bash -n）:") + for path in TARGETS: + if not path.is_file(): + continue + proc = subprocess.run( + [BASH, "-n", str(path).replace("\\", "/")], + capture_output=True, text=True, encoding="utf-8", + errors="replace") + if proc.returncode == 0: + print(" ✓ %s" % path.name) + else: + print(" ✗ %s" % path.name) + print(" " + (proc.stderr or "").strip()[:400]) + bad += 1 + + print() + if bad: + print(" 有 %d 个问题" % bad) + return 1 + print(" 全部通过") + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/_build/package_remote.py b/_build/package_remote.py index 1525b43..f18950d 100644 --- a/_build/package_remote.py +++ b/_build/package_remote.py @@ -241,7 +241,7 @@ AGENT_README = f"""======================================================== RELAY_README = f"""======================================================== 服务器端（随身 WiFi / Linux） 版本 {VERSION} -======================================================== + ======================================================== 作用：让**不在同一个网络**的电脑和手表连上。 @@ -253,22 +253,45 @@ RELAY_README = f"""======================================================== 内存占用约 20MB，加 cloudflared 共约 60MB —— 512MB 的小机器跑得动。 -【装】 +【装：一条命令，全自动】 把本文件夹拷到设备上，然后： - bash install.sh + bash deploy.sh - 它会： - 1. 检查 python3 / cloudflared（没有就下载） - 2. 装两个 systemd 服务并设为开机自启： - lanremote-relay 中转服务 - lanremote-tunnel Cloudflare 隧道 - 3. 打印公网地址和管理页地址 + 它会一口气做完这些，不用你一步步敲： + + 1. 检查并安装 cloudflared（已经装了就用现成的） + 2. 把中转程序装到 /root/lanremote-relay/ + 3. 网络调优（keepalive / MSS / MTU / 开机加速） + 4. 注册并启动 4 个 systemd 服务（开机自启） + 5. 配好 Cloudflare 隧道 + 6. 自检，然后把**公网地址**打印出来 + + ── 三种常见情形 ── + + ① 机器上已经有隧道凭据（/root/.cloudflared/*.json） + 直接： bash deploy.sh + + ② 有 Cloudflare 给的隧道 Token + TUNNEL_TOKEN=eyJhIjoi... bash deploy.sh + （用环境变量而不是 --token，Token 就不会留在 shell 历史里） + + ③ 换域名 / 只装中转不要隧道 + bash deploy.sh --hostname relay.你的域名 + bash deploy.sh --skip-tunnel + + 看全部参数： bash deploy.sh --help + + + **重跑 deploy.sh = 升级**，不会把已有配置冲掉： + 设备数据、配对码、管理密码、隧道凭据、手工改过的 config.yml + 都会原样保留。 【常用命令】 + lanremote-status 看整体状态（服务 / 端口 / 公网 / 内存） lanremote-url 打印当前公网地址 lanremote-key 打印管理钥匙 systemctl status lanremote-relay @@ -276,76 +299,86 @@ RELAY_README = f"""======================================================== journalctl -u lanremote-relay -f +【关于 install.sh（旧版脚本，仍在包里）】 + + 装匿名快速隧道，公网地址每次重启都变。 + 新机器建议用 deploy.sh（具名隧道，地址固定）。 + install.sh 保留是为了兼容已经用它装过的机器。 + + 【地址老变怎么办？记住一个局域网地址就行】 匿名隧道的公网地址每次重启都会变。查当前地址： 浏览器打开 http://<随身WiFi的IP>:8080/url - 比如 http://192.168.2.156:8080/url 它会直接返回当前的公网地址，纯文本，不用登录。 - 下面还有两个命令（SSH 上去用）： - lanremote-url 打印当前公网地址 - systemctl restart lanremote-tunnel 换个地址（超时的时候用） + 具名隧道（deploy.sh 装的）地址是固定的，不用管这个。 【管理】 - 管理页： <公网地址>/?key= - 管理页顶部也会大字显示"当前公网地址"。 - 管理密码：120830（存在 data/admin_password.txt，可改） + 官网： <公网地址>/ + 管理页： <公网地址>/?key= + 管理密码： 120830（存在 data/admin_password.txt，可改） 能看到：设备列表、在线状态、配对码、流量、会话数 能操作：踢会话、抹掉配对码绑定 -【重要：这几个参数都是实测调出来的】 +【网络调优：这些参数都是实测调出来的】 - install.sh 里给 cloudflared 加了： - --edge-ip-version 4 只走 IPv4 - --ha-connections 1 并发连接数 - --retries 5 连边缘失败时多重试 + deploy-tune.sh 会做这五件事，改动之前先看它开头的说明： - 为什么（都是踩出来的，不是拍脑袋）： + ① TCP keepalive 30/10/3 + 这条 4G 线路会**静默丢连接**（不发明文 FIN/RST）。 + Linux 默认要 7200 秒才发现死链，表现就是"过几分钟突然 502"。 + 改成 30 秒首发探测之后，最快 60 秒就能发现并重建。 - ① IPv6：这条线路**分配了 IPv6 地址但实际不通**， - 而 Cloudflare 边缘默认优先 IPv6，会导致建隧道一直超时 - （日志里是 context deadline exceeded）。 + ② tcp_mtu_probing = 1 + 接口写着 MTU 1500，但实际路径扛不住（1472 通、1500 全丢）。 + 不打开探测的话，新建 TLS 连接约 30% 失败。 - ② 协议：**用默认的 QUIC，不要写 --protocol http2**。 - 实测这条线路把 HTTP/2 用的 TCP 7844 挡了： - TLS handshake with edge error: read tcp ...:7844: i/o timeout - 而 QUIC 走 UDP 7844 是通的。 - （早期版本这里误写成 --protocol http2，隧道完全起不来。） + ③ MSS 钳制到 1360 + 只限制 TCP 段，不动链路层。 + 实测：不夹 87%，夹到 1360/1400 都是 100%。 - ③ 连接数：用 1（默认是 4）。这条线路对并发 UDP 很敏感： - 链路好时 ha=4 只成功注册 1 条（9/10），ha=2 是 10/10； - 链路退化时 ha=2 掉到 0/10（一条失败重试把另一条也拖下水）， - 而 ha=1 是 15/15 + 10/10（100%）。 - 多一条连接不是多一份冗余，而是多一份争抢。 - 冗余交给看门狗（每 30 秒查一次，断了就重启）更靠谱。 + ④ 接口 MTU 1400 + **这一条是专门给 QUIC 隧道的**：MSS 钳制走 iptables 的 + TCPMSS 目标，只对 TCP 生效；QUIC 跑 UDP，完全不受它保护。 + QUIC 的包超过路径 MTU 就会被丢，而 UDP 丢包不回 ICMP， + 只能干等握手超时（日志里那句 + "failed to dial to edge with quic: timeout: no recent network activity"）。 + 实测把 MTU 从 1500 降到 1400：建齐 6 条连接 28 秒 -> 13 秒。 - 换了网络环境可以试着去掉这些参数用默认值。 + ⑤ mask 掉 systemd-networkd-wait-online + 这台机器 wlan0 归 NetworkManager 管， + systemd-networkd-wait-online 傻等一个不归它的网络， + 干等 2 分钟超时，把 relay / tunnel 全拖住。 + 实测：掉电重启后公网恢复 2 分 10 秒 -> 24 秒。 -【关于隧道地址会变】 +【隧道的两套配置】 - 默认用的是 Cloudflare **匿名快速隧道**，地址每次重启会变。 - 想固定地址要用**具名隧道**（需要你自己的域名）： + deploy.sh 会装两份隧道服务，但**只启用一份** —— + 两条隧道同时跑会互相争抢，实测反而更不稳。 - cloudflared tunnel login # 浏览器点授权 - cloudflared tunnel create lanremote - cloudflared tunnel route dns lanremote relay.你的域名 - # 然后把 lanremote-tunnel.service 的 ExecStart 换成： - # cloudflared tunnel --no-autoupdate run lanremote + lanremote-tunnel 主用（默认 quic） + lanremote-tunnel-h2 备用（http2） - 具名隧道不受匿名隧道限流，稳定性完全不是一个级别。 + 想切换： + systemctl disable --now lanremote-tunnel + systemctl enable --now lanremote-tunnel-h2 + + 为什么默认 quic：尾部延迟好得多（实测 P99 2.99 秒 vs 13.9 秒）。 + 什么时候换 http2：这条线路对 UDP 特别不友好的时候 + （日志里大量 "Failed to dial a quic connection"）。 【省内存】 - 默认给两个服务各设了 MemoryMax=128M。 + 默认给服务设了 MemoryMax（relay 128M / tunnel 160M）。 要再省就把用不上的服务停掉： systemctl stop mariadb php8.2-fpm apache2 systemctl disable mariadb php8.2-fpm apache2 @@ -490,11 +523,25 @@ def main() -> int: key=lambda f: f.name) for src in wanted: shutil.copy2(src, server_dir / src.name) + # ⚠ 产品截图是个**目录**，上面那个 iterdir() 只收文件、而且不递归， + # 所以 site_shots/ 一直没被打进服务端包 —— + # 装到新机器上官网的截图全是 404。 + # 这个是拿「从 zip 解压出来真跑一遍」的端到端测试才发现的。 + shots_src = RELAY_SRC / "site_shots" + if shots_src.is_dir(): + shutil.copytree(shots_src, server_dir / "site_shots") + else: + print(" [警告] relay/site_shots 不存在，官网截图会缺失") write_readme(server_dir / "README-server.txt", RELAY_README) _copy_docs(server_dir) for must in ("relay.py", "install.sh", "watchdog.sh", "net-tune.sh"): if not (server_dir / must).is_file(): print(f" [警告] 服务器端少了 {must}") + # 一键部署脚本必须进包 —— 用户拿到的 zip 里要有它才能双击/一条命令跑起来 + for must in ("deploy.sh", "deploy-tune.sh"): + if not (server_dir / must).is_file(): + print(f" [失败] 服务器端少了一键部署脚本 {must}") + return 1 server_zip = dist / f"{server_name}.zip" n = _zip_dir(server_zip, server_dir, server_name) results.append(("服务器端", server_zip, n)) @@ -544,7 +591,8 @@ def main() -> int: return 1 with zipfile.ZipFile(results[1][1]) as archive: names = archive.namelist() - for must in ("relay.py", "install.sh", "watchdog.sh", "net-tune.sh"): + for must in ("relay.py", "install.sh", "watchdog.sh", "net-tune.sh", + "deploy.sh", "deploy-tune.sh"): if not any(must in n for n in names): print(f" [失败] 服务器端包里没有 {must}") return 1 diff --git a/_build/patch_relay_readme.py b/_build/patch_relay_readme.py new file mode 100644 index 0000000..1ed7230 --- /dev/null +++ b/_build/patch_relay_readme.py @@ -0,0 +1,204 @@ +# -*- coding: utf-8 -*- +r'''把 package_remote.py 里的 RELAY_README 整块换成新版本。 + +为什么按块换而不是用 edit 工具： + 那段是个 f-string 三引号大块，里面有几百行、 + 还有各种全角空格和竖线字符，逐字符对齐很容易失败。 + 定位「RELAY_README = f"""」到下一个单独的 `"""` 行更稳。 +''' +from __future__ import annotations + +import sys +from pathlib import Path + +SRC = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote" + r"\_build\package_remote.py") +BOM = b"\xef\xbb\xbf" + +NEW_BODY = '''RELAY_README = f"""======================================================== + 服务器端（随身 WiFi / Linux） 版本 {VERSION} + ======================================================== + +作用：让**不在同一个网络**的电脑和手表连上。 + + 手表 ──HTTPS──┐ + ├──> Cloudflare ──> 本机 :8080 + 电脑 ──HTTPS──┘ + +本程序是**纯标准库**的 Python，不装任何第三方包。 +内存占用约 20MB，加 cloudflared 共约 60MB —— 512MB 的小机器跑得动。 + + +【装：一条命令，全自动】 + + 把本文件夹拷到设备上，然后： + + bash deploy.sh + + 它会一口气做完这些，不用你一步步敲： + + 1. 检查并安装 cloudflared（已经装了就用现成的） + 2. 把中转程序装到 /root/lanremote-relay/ + 3. 网络调优（keepalive / MSS / MTU / 开机加速） + 4. 注册并启动 4 个 systemd 服务（开机自启） + 5. 配好 Cloudflare 隧道 + 6. 自检，然后把**公网地址**打印出来 + + ── 三种常见情形 ── + + ① 机器上已经有隧道凭据（/root/.cloudflared/*.json） + 直接： bash deploy.sh + + ② 有 Cloudflare 给的隧道 Token + TUNNEL_TOKEN=eyJhIjoi... bash deploy.sh + （用环境变量而不是 --token，Token 就不会留在 shell 历史里） + + ③ 换域名 / 只装中转不要隧道 + bash deploy.sh --hostname relay.你的域名 + bash deploy.sh --skip-tunnel + + 看全部参数： bash deploy.sh --help + + + **重跑 deploy.sh = 升级**，不会把已有配置冲掉： + 设备数据、配对码、管理密码、隧道凭据、手工改过的 config.yml + 都会原样保留。 + + +【常用命令】 + + lanremote-status 看整体状态（服务 / 端口 / 公网 / 内存） + lanremote-url 打印当前公网地址 + lanremote-key 打印管理钥匙 + systemctl status lanremote-relay + systemctl status lanremote-tunnel + journalctl -u lanremote-relay -f + + +【关于 install.sh（旧版脚本，仍在包里）】 + + 装匿名快速隧道，公网地址每次重启都变。 + 新机器建议用 deploy.sh（具名隧道，地址固定）。 + install.sh 保留是为了兼容已经用它装过的机器。 + + +【地址老变怎么办？记住一个局域网地址就行】 + + 匿名隧道的公网地址每次重启都会变。查当前地址： + + 浏览器打开 http://<随身WiFi的IP>:8080/url + + 它会直接返回当前的公网地址，纯文本，不用登录。 + + 具名隧道（deploy.sh 装的）地址是固定的，不用管这个。 + + +【管理】 + + 官网： <公网地址>/ + 管理页： <公网地址>/?key= + 管理密码： 120830（存在 data/admin_password.txt，可改） + + 能看到：设备列表、在线状态、配对码、流量、会话数 + 能操作：踢会话、抹掉配对码绑定 + + +【网络调优：这些参数都是实测调出来的】 + + deploy-tune.sh 会做这五件事，改动之前先看它开头的说明： + + ① TCP keepalive 30/10/3 + 这条 4G 线路会**静默丢连接**（不发明文 FIN/RST）。 + Linux 默认要 7200 秒才发现死链，表现就是"过几分钟突然 502"。 + 改成 30 秒首发探测之后，最快 60 秒就能发现并重建。 + + ② tcp_mtu_probing = 1 + 接口写着 MTU 1500，但实际路径扛不住（1472 通、1500 全丢）。 + 不打开探测的话，新建 TLS 连接约 30% 失败。 + + ③ MSS 钳制到 1360 + 只限制 TCP 段，不动链路层。 + 实测：不夹 87%，夹到 1360/1400 都是 100%。 + + ④ 接口 MTU 1400 + **这一条是专门给 QUIC 隧道的**：MSS 钳制走 iptables 的 + TCPMSS 目标，只对 TCP 生效；QUIC 跑 UDP，完全不受它保护。 + QUIC 的包超过路径 MTU 就会被丢，而 UDP 丢包不回 ICMP， + 只能干等握手超时（日志里那句 + "failed to dial to edge with quic: timeout: no recent network activity"）。 + 实测把 MTU 从 1500 降到 1400：建齐 6 条连接 28 秒 -> 13 秒。 + + ⑤ mask 掉 systemd-networkd-wait-online + 这台机器 wlan0 归 NetworkManager 管， + systemd-networkd-wait-online 傻等一个不归它的网络， + 干等 2 分钟超时，把 relay / tunnel 全拖住。 + 实测：掉电重启后公网恢复 2 分 10 秒 -> 24 秒。 + + +【隧道的两套配置】 + + deploy.sh 会装两份隧道服务，但**只启用一份** —— + 两条隧道同时跑会互相争抢，实测反而更不稳。 + + lanremote-tunnel 主用（默认 quic） + lanremote-tunnel-h2 备用（http2） + + 想切换： + systemctl disable --now lanremote-tunnel + systemctl enable --now lanremote-tunnel-h2 + + 为什么默认 quic：尾部延迟好得多（实测 P99 2.99 秒 vs 13.9 秒）。 + 什么时候换 http2：这条线路对 UDP 特别不友好的时候 + （日志里大量 "Failed to dial a quic connection"）。 + + +【省内存】 + + 默认给服务设了 MemoryMax（relay 128M / tunnel 160M）。 + 要再省就把用不上的服务停掉： + systemctl stop mariadb php8.2-fpm apache2 + systemctl disable mariadb php8.2-fpm apache2 +"""''' + + +def main() -> int: + raw = SRC.read_bytes() + had_bom = raw.startswith(BOM) + text = raw.decode("utf-8-sig") + + start = text.find('RELAY_README = f"""') + if start < 0: + print(" ✗ 找不到 RELAY_README 的开头") + return 1 + + # 结束：从开头往后找第一个「单独一行 """」的结束引号 + body_start = start + len('RELAY_README = f"""') + end = text.find('\n"""', body_start) + if end < 0: + print(" ✗ 找不到 RELAY_README 的结束引号") + return 1 + end += len('\n"""') # 把结束引号一起吃掉 + + old = text[start:end] + print(" 原块 %d 行 -> 新块 %d 行" + % (old.count("\n") + 1, NEW_BODY.count("\n") + 1)) + + if old.strip() == NEW_BODY.strip(): + print(" 内容已经一样了，不动") + return 0 + + text = text[:start] + NEW_BODY + text[end:] + data = text.encode("utf-8") + if had_bom: + data = BOM + data + SRC.write_bytes(data) + + # 语法自检 + import ast + ast.parse(SRC.read_text(encoding="utf-8-sig")) + print(" ✓ 已替换，语法检查通过") + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/_build/test_deploy_real.sh b/_build/test_deploy_real.sh new file mode 100644 index 0000000..ecf65e6 --- /dev/null +++ b/_build/test_deploy_real.sh @@ -0,0 +1,97 @@ +#!/bin/bash +# 在真机 Debian 上用沙箱模式验证 deploy.sh（不碰现有中转） +set -u + +echo "════════ 1. 从发布 zip 里解出脚本（模拟用户真实流程）════════" +cd /root +rm -rf /root/deploytest +mkdir -p /root/deploytest +if [ -f /root/lanremote-relay/downloads/ykxmz-server-1.8.2.zip ]; then + cd /root/deploytest + python3 -c " +import zipfile +z = zipfile.ZipFile('/root/lanremote-relay/downloads/ykxmz-server-1.8.2.zip') +z.extractall('.') +print(' 解出', len(z.namelist()), '个文件') +" +else + echo " ! 设备上没有服务端 zip" + exit 1 +fi + +D=$(ls -d /root/deploytest/ykxmz-server-* 2>/dev/null | head -1) +echo " 目录: $D" +echo " 内容:" +ls -1 "$D" | sed 's/^/ /' +echo " 有没有 deploy.sh: $([ -f "$D/deploy.sh" ] && echo 有 || echo **没有**)" +echo " 有没有 site_shots/: $([ -d "$D/site_shots" ] && echo '有 ('$(ls -1 "$D/site_shots" | wc -l)' 张)' || echo **没有**)" + +echo +echo "════════ 2. 语法和格式 ════════" +bash -n "$D/deploy.sh" && echo " ✓ deploy.sh 语法通过" || echo " ✗ 语法错误" +bash -n "$D/deploy-tune.sh" 2>/dev/null && echo " ✓ deploy-tune.sh 语法通过" || echo " (deploy-tune.sh 不存在或语法错)" +python3 -c " +from pathlib import Path +for n in ['deploy.sh','deploy-tune.sh']: + p = Path('$D') / n + if not p.is_file(): continue + raw = p.read_bytes() + crlf = raw.count(b'\r\n') + bom = raw.startswith(b'\xef\xbb\xbf') + print(f' {n}: CRLF={crlf} BOM={bom} ' + ('✓' if crlf==0 and not bom else '✗')) +" + +echo +echo "════════ 3. --help（必须无副作用）════════" +before=$(md5sum /etc/systemd/system/lanremote-relay.service 2>/dev/null | awk '{print $1}') +out=$(bash "$D/deploy.sh" --help 2>&1) +echo "$out" | head -22 | sed 's/^/ /' +after=$(md5sum /etc/systemd/system/lanremote-relay.service 2>/dev/null | awk '{print $1}') +echo " ----" +[ "$before" = "$after" ] && echo " ✓ --help 没动现有服务" || echo " ✗ --help 改了现有服务！" +echo " --help 退出码: $(bash "$D/deploy.sh" --help > /dev/null 2>&1; echo $?)" + +echo +echo "════════ 4. 未知参数要被挡 ════════" +bash "$D/deploy.sh" --这是一个不存在的参数 > /dev/null 2>&1 +echo " 退出码: $? （应该是 2）" + +echo +echo "════════ 5. 沙箱跑一遍（--prefix，不碰真实 /root/lanremote-relay）════════" +echo " 跑之前的真实服务状态:" +for s in lanremote-relay lanremote-tunnel lanremote-tunnel-h2; do + printf " %-24s %s\n" "$s" "$(systemctl is-active $s)" +done +echo " ---" +rm -rf /root/sandbox +bash "$D/deploy.sh" --prefix /root/sandbox --skip-tunnel > /tmp/dep.log 2>&1 +echo " 退出码: $?" +echo " 最后 25 行输出:" +tail -25 /tmp/dep.log | sed 's/^/ /' +echo " ---" +echo " 沙箱里生成了什么:" +find /root/sandbox -maxdepth 3 2>/dev/null | head -25 | sed 's/^/ /' + +echo +echo "════════ 6. 幂等：再跑一遍 ════════" +# 放个哨兵，看会不会被冲掉 +echo "SENTINEL-$(date +%s)" > /root/sandbox/root/lanremote-relay/data/sentinel.txt 2>/dev/null \ + || mkdir -p /root/sandbox/root/lanremote-relay/data && echo "SENTINEL" > /root/sandbox/root/lanremote-relay/data/sentinel.txt +bash "$D/deploy.sh" --prefix /root/sandbox --skip-tunnel > /tmp/dep2.log 2>&1 +echo " 第二次退出码: $?" +echo " 哨兵还在吗: $([ -f /root/sandbox/root/lanremote-relay/data/sentinel.txt ] && echo 在 || echo **被冲掉了**)" +echo " 第二次最后 8 行:" +tail -8 /tmp/dep2.log | sed 's/^/ /' + +echo +echo "════════ 7. 现有真实服务有没有被影响 ════════" +for s in lanremote-relay lanremote-tunnel lanremote-tunnel-h2; do + printf " %-24s %s\n" "$s" "$(systemctl is-active $s)" +done +echo " 自检: $(curl -s --max-time 10 http://127.0.0.1:8080/v1/health | head -c 60)" + +echo +echo "════════ 8. 清理沙箱 ════════" +rm -rf /root/sandbox /root/deploytest +echo " ✓ 已清理" +df -h / | sed 's/^/ /' diff --git a/_build/test_deploy_sh.sh b/_build/test_deploy_sh.sh new file mode 100644 index 0000000..65e13a3 --- /dev/null +++ b/_build/test_deploy_sh.sh @@ -0,0 +1,494 @@ +#!/bin/bash +# ════════════════════════════════════════════════════════════════ +# deploy.sh 的实测脚本 +# ════════════════════════════════════════════════════════════════ +# +# 这台开发机是 Windows（Git Bash），没有 systemctl / ip / iptables， +# 所以测试的做法是： +# 1. 造一个沙箱目录，用 deploy.sh 的 --prefix 把所有写入关在里面 +# 2. 在 PATH 最前面放一批「桩命令」，把 Linux 专有的东西接住 +# （systemctl / ip / iptables / nmcli / cloudflared / curl …） +# 3. 同一个沙箱**跑两遍**，验证第二遍不报错、不把已有东西冲掉 +# +# 验证的是：语法、参数解析、文件部署、unit 生成、幂等性。 +# **不能**验证的：真实的 systemd 行为、iptables 真的有没有生效、 +# 隧道能不能连上 —— 那些得在真的 Linux 机器上跑。 +# +# 用法: bash _build/test_deploy_sh.sh +# ════════════════════════════════════════════════════════════════ +set -u + +REPO=$(cd "$(dirname "$0")/.." && pwd) +DEPLOY="$REPO/relay/deploy.sh" +TUNE="$REPO/relay/deploy-tune.sh" + +PASS=0 +FAIL=0 +ok() { PASS=$((PASS + 1)); printf " [PASS] %s\n" "$1"; } +bad() { FAIL=$((FAIL + 1)); printf " [FAIL] %s\n" "$1"; } +check(){ if [ "$2" = "$3" ]; then ok "$1"; else bad "$1（期望 $3，实际 $2）"; fi; } +exists(){ if [ -e "$2" ]; then ok "$1"; else bad "$1（找不到 $2）"; fi; } +noexist(){ if [ ! -e "$2" ]; then ok "$1"; else bad "$1（不该存在 $2）"; fi; } + +echo "============================================================" +echo " deploy.sh 实测" +echo "============================================================" +echo " 仓库: $REPO" +echo " 脚本: $DEPLOY" + +[ -f "$DEPLOY" ] || { echo " 找不到 deploy.sh"; exit 1; } +[ -f "$TUNE" ] || { echo " 找不到 deploy-tune.sh"; exit 1; } + +# ════════════════════════════════════════════════════════════════ +echo +echo "── 1. 语法检查（bash -n）──" +for f in "$DEPLOY" "$TUNE"; do + if bash -n "$f" 2>/tmp/synerr; then + ok "$(basename "$f") 语法正确" + else + bad "$(basename "$f") 语法错误: $(head -3 /tmp/synerr)" + fi +done + +# ════════════════════════════════════════════════════════════════ +echo +echo "── 2. 换行符 / BOM（.sh 必须 LF + 无 BOM）──" +python - "$DEPLOY" "$TUNE" <<'PYEOF' +import sys +from pathlib import Path +bad = 0 +for p in sys.argv[1:]: + raw = Path(p).read_bytes() + crlf = raw.count(b"\r\n") + bom = raw.startswith(b"\xef\xbb\xbf") + name = Path(p).name + if crlf == 0 and not bom: + print(" [PASS] %s 是 LF 且无 BOM" % name) + else: + print(" [FAIL] %s CRLF=%d BOM=%s" % (name, crlf, bom)) + bad += 1 +sys.exit(1 if bad else 0) +PYEOF +if [ $? -eq 0 ]; then PASS=$((PASS + 2)); else FAIL=$((FAIL + 2)); fi + +# ════════════════════════════════════════════════════════════════ +echo +echo "── 3. --help ──" +HELP=$(bash "$DEPLOY" --help 2>&1) +RC=$? +check "--help 退出码为 0" "$RC" "0" +if echo "$HELP" | grep -q '用法'; then ok "--help 有「用法」段"; else bad "--help 没输出用法"; fi +if echo "$HELP" | grep -q -- '--prefix'; then ok "--help 列出了 --prefix"; else bad "--help 缺 --prefix"; fi +if echo "$HELP" | grep -q 'TUNNEL_TOKEN'; then ok "--help 提到了 TUNNEL_TOKEN"; else bad "--help 没提 TUNNEL_TOKEN"; fi +# --help 不能有副作用 +if echo "$HELP" | grep -qi '装好了'; then bad "--help 竟然执行了部署"; else ok "--help 没有副作用"; fi + +echo +echo "── 3b. 非法参数要报错退出 ──" +bash "$DEPLOY" --no-such-flag >/dev/null 2>&1 +check "未知参数退出码为 2" "$?" "2" +bash "$DEPLOY" --protocol bogus >/dev/null 2>&1 +check "非法协议退出码为 2" "$?" "2" + +# ════════════════════════════════════════════════════════════════ +echo +echo "── 4. 搭沙箱（桩命令 + 临时安装根）──" +TMP=$(mktemp -d) +STUB="$TMP/stub" +SANDBOX="$TMP/root" +STUB_LOG="$TMP/stub.log" +mkdir -p "$STUB" +: > "$STUB_LOG" +export STUB_LOG + +REAL_PY=$(command -v python 2>/dev/null || true) + +mk() { # mk <名字> <<'EOF' ... + local name="$1" + cat > "$STUB/$name" + chmod +x "$STUB/$name" +} + +mk systemctl <<'EOF' +#!/bin/bash +echo "systemctl $*" >> "$STUB_LOG" +case "$1" in + is-active) echo "active"; exit 0 ;; + is-enabled) echo "enabled"; exit 0 ;; + *) exit 0 ;; +esac +EOF + +mk ip <<'EOF' +#!/bin/bash +echo "ip $*" >> "$STUB_LOG" +# deploy-tune.sh 用它找默认路由的网卡 +if [ "$1" = "-4" ]; then + echo "default via 192.168.1.1 dev wlan0 proto dhcp metric 600" +fi +exit 0 +EOF + +mk iptables <<'EOF' +#!/bin/bash +# 桩：真的维护一张规则表。 +# 如果这里偷懒一律返回 0，那么 deploy-tune.sh 里 +# 「-C 查存在 -> -D 删除」的循环会永远转下去（真踩过这个坑）。 +echo "iptables $*" >> "$STUB_LOG" +RULES="$STUB_LOG.rules" +touch "$RULES" + +# -L 用来数规则条数 +if [ "${1:-}" = "-t" ] && [ "${3:-}" = "-L" ]; then + while read -r r; do + [ -n "$r" ] && echo "TCPMSS tcp -- $r" + done < "$RULES" + exit 0 +fi + +chain=""; mss=""; action="" +prev="" +for a in "$@"; do + case "$prev" in + -C|-D|-A) chain="$a" ;; + --set-mss) mss="$a" ;; + esac + case "$a" in + -C|-D|-A) [ -z "$action" ] && action="$a" ;; + esac + prev="$a" +done +key="$chain:$mss" + +case "$action" in + -C) grep -qxF "$key" "$RULES" 2>/dev/null && exit 0 || exit 1 ;; + -A) grep -qxF "$key" "$RULES" 2>/dev/null || echo "$key" >> "$RULES"; exit 0 ;; + -D) + if grep -qxF "$key" "$RULES" 2>/dev/null; then + grep -vxF "$key" "$RULES" > "$RULES.tmp" 2>/dev/null + mv "$RULES.tmp" "$RULES" + exit 0 + fi + exit 1 ;; +esac +exit 0 +EOF + +mk nmcli <<'EOF' +#!/bin/bash +echo "nmcli $*" >> "$STUB_LOG" +exit 0 +EOF + +mk getent <<'EOF' +#!/bin/bash +exit 0 +EOF + +mk free <<'EOF' +#!/bin/bash +echo " total used free" +echo "Mem: 460 131 144" +EOF + +mk cloudflared <<'EOF' +#!/bin/bash +if [ "$1" = "--version" ]; then + echo "cloudflared version 2026.9.3 (stub)" + exit 0 +fi +echo "cloudflared $*" >> "$STUB_LOG" +exit 0 +EOF + +mk curl <<'EOF' +#!/bin/bash +echo "curl $*" >> "$STUB_LOG" +# 健康检查要返回 {"ok": true} +for a in "$@"; do + case "$a" in + *v1/health*) echo '{"ok": true, "version": "stub"}'; exit 0 ;; + esac +done +# -o FILE 的下载：写点东西假装成功 +prev="" +for a in "$@"; do + if [ "$prev" = "-o" ]; then echo "stub-binary" > "$a"; exit 0; fi + prev="$a" +done +exit 0 +EOF + +# python3 在很多 Windows 上是应用商店的占位符，用真的 python 转一手 +if [ -n "$REAL_PY" ]; then + mk python3 < "$OUT1" 2>&1 +RC1=$? +check "第一次退出码为 0" "$RC1" "0" +if [ "$RC1" != "0" ]; then + echo " ── 输出末尾 ──" + tail -20 "$OUT1" | sed 's/^/ /' +fi + +REL="$SANDBOX/root/lanremote-relay" +UNIT="$SANDBOX/etc/systemd/system" + +exists "relay.py 已部署" "$REL/relay.py" +exists "admin.py 已部署" "$REL/admin.py" +exists "landing.py 已部署" "$REL/landing.py" +exists "showcase.py 已部署" "$REL/showcase.py" +exists "favicon.ico 已部署" "$REL/favicon.ico" +exists "deploy-tune.sh 已部署" "$REL/deploy-tune.sh" +exists "watchdog.sh 已部署" "$REL/watchdog.sh" +exists "site_shots 已部署" "$REL/site_shots/pc-main.png" +exists "data 目录已建" "$REL/data" +exists "downloads 目录已建" "$REL/downloads" + +for u in lanremote-relay lanremote-nettune lanremote-tunnel; do + exists "$u.service 已生成" "$UNIT/$u.service" +done +exists "备用 http2 单元已生成" "$UNIT/lanremote-tunnel-h2.service" +exists "看门狗 timer 已生成" "$UNIT/lanremote-watchdog.timer" + +echo +echo " 生成的 relay unit 里应该有的关键项:" +for kw in "RELAY_POLL=60" "RELAY_PORT=8080" "python3"; do + if grep -q "$kw" "$UNIT/lanremote-relay.service" 2>/dev/null; then + ok "relay unit 含 $kw" + else + bad "relay unit 缺 $kw" + fi +done +if grep -q 'http2' "$UNIT/lanremote-tunnel-h2.service" 2>/dev/null; then + ok "h2 单元用的是 http2" +else + bad "h2 单元没写 http2" +fi +if grep -q 'quic' "$UNIT/lanremote-tunnel.service" 2>/dev/null; then + ok "主隧道单元用的是 quic" +else + bad "主隧道单元没写 quic" +fi +if grep -q 'ha-connections 10' "$UNIT/lanremote-tunnel.service" 2>/dev/null; then + ok "隧道单元含 ha-connections 10" +else + bad "隧道单元缺 ha-connections 10" +fi +if grep -q 'ExecStart=/bin/bash' "$UNIT/lanremote-nettune.service" 2>/dev/null; then + ok "nettune 顺序执行两个调优脚本" +else + bad "nettune 单元不对" +fi +# Token 不能出现在 unit 里（unit 是 644 的） +if grep -q 'TUNNEL_TOKEN=' "$UNIT/lanremote-tunnel.service" 2>/dev/null; then + bad "unit 里竟然有 TUNNEL_TOKEN（会泄露）" +else + ok "unit 里没有明文 Token" +fi + +# 便捷命令 +for c in lanremote-url lanremote-key lanremote-status; do + exists "便捷命令 $c 已生成" "$SANDBOX/usr/local/bin/$c" +done + +# ════════════════════════════════════════════════════════════════ +echo +echo "── 6. 幂等性：放几个「不许被冲掉」的东西，再跑第二遍 ──" + +# 设备数据、管理密码、已有的公网地址 —— 这些重跑时必须原样保留 +echo "device-sentinel" > "$REL/data/devices.json" +echo "key-sentinel" > "$REL/data/admin_key.txt" +echo "pw-sentinel" > "$REL/data/admin_password.txt" +echo "https://keep.me" > "$REL/public_url.txt" +# 手工改过的 config.yml 也不能被无脑覆盖 +mkdir -p "$SANDBOX/root/.cloudflared" +cat > "$SANDBOX/root/.cloudflared/config.yml" <<'EOF' +# 手工改过的配置，重跑不许动 +tunnel: 11111111-2222-3333-4444-555555555555 +ingress: + - hostname: hand-edited.example.com + service: http://127.0.0.1:8080 + - service: http_status:404 +EOF +BEFORE_HASH=$(md5sum "$SANDBOX/root/.cloudflared/config.yml" | awk '{print $1}') +# 记下部署文件的指纹，第二遍后应该一致（内容相同） +BEFORE_RELAY=$(md5sum "$REL/relay.py" | awk '{print $1}') + +OUT2="$TMP/run2.log" +bash "$DEPLOY" --prefix "$SANDBOX" --skip-tunnel --port 8080 > "$OUT2" 2>&1 +RC2=$? +check "第二次退出码为 0" "$RC2" "0" +if [ "$RC2" != "0" ]; then + echo " ── 输出末尾 ──" + tail -20 "$OUT2" | sed 's/^/ /' +fi + +check "设备数据没被冲掉" "$(cat "$REL/data/devices.json" 2>/dev/null)" "device-sentinel" +check "管理钥匙没被冲掉" "$(cat "$REL/data/admin_key.txt" 2>/dev/null)" "key-sentinel" +check "管理密码没被冲掉" "$(cat "$REL/data/admin_password.txt" 2>/dev/null)" "pw-sentinel" +check "公网地址没被冲掉" "$(cat "$REL/public_url.txt" 2>/dev/null)" "https://keep.me" +AFTER_HASH=$(md5sum "$SANDBOX/root/.cloudflared/config.yml" | awk '{print $1}') +check "手工 config.yml 没被覆盖" "$AFTER_HASH" "$BEFORE_HASH" +AFTER_RELAY=$(md5sum "$REL/relay.py" | awk '{print $1}') +check "relay.py 内容稳定" "$AFTER_RELAY" "$BEFORE_RELAY" + +# 两次输出里的「警告」数量应该差不多 —— 第二遍不应该冒出新的错误 +W1=$(grep -c '✗' "$OUT1" 2>/dev/null || echo 0) +W2=$(grep -c '✗' "$OUT2" 2>/dev/null || echo 0) +check "第二遍没有新增 ✗ 错误" "$W2" "$W1" + +# ════════════════════════════════════════════════════════════════ +echo +echo "── 7. 凭据模式：给出域名时要能生成 config.yml ──" +CFD="$SANDBOX/root/.cloudflared" +rm -f "$CFD/config.yml" +echo '{"TunnelID":"abcdef01-2345-6789-abcd-ef0123456789"}' \ + > "$CFD/abcdef01-2345-6789-abcd-ef0123456789.json" + +OUT3="$TMP/run3.log" +bash "$DEPLOY" --prefix "$SANDBOX" --hostname relay.test.example \ + > "$OUT3" 2>&1 +RC3=$? +check "凭据模式退出码为 0" "$RC3" "0" +exists "config.yml 已生成" "$CFD/config.yml" +if grep -q 'abcdef01-2345-6789-abcd-ef0123456789' "$CFD/config.yml" 2>/dev/null; then + ok "config.yml 里的隧道 ID 取自凭据文件名" +else + bad "config.yml 隧道 ID 不对" +fi +if grep -q 'relay.test.example' "$CFD/config.yml" 2>/dev/null; then + ok "config.yml 写入了域名" +else + bad "config.yml 缺域名" +fi +if grep -q 'http_status:404' "$CFD/config.yml" 2>/dev/null; then + ok "config.yml 有兜底 404 规则（没有它 cloudflared 起不来）" +else + bad "config.yml 缺兜底规则" +fi +if grep -q '127.0.0.1:8080' "$CFD/config.yml" 2>/dev/null; then + ok "config.yml 指向本地中转端口" +else + bad "config.yml 回源地址不对" +fi + +echo +echo "── 7b. 再跑一次（不给 --hostname），config.yml 不该被改 ──" +H3=$(md5sum "$CFD/config.yml" | awk '{print $1}') +bash "$DEPLOY" --prefix "$SANDBOX" > "$TMP/run4.log" 2>&1 +RC4=$? +check "再次运行退出码为 0" "$RC4" "0" +H4=$(md5sum "$CFD/config.yml" | awk '{print $1}') +check "没给 --hostname 时 config.yml 保持不变" "$H4" "$H3" + +# ════════════════════════════════════════════════════════════════ +echo +echo "── 8. Token 模式 ──" +OUT5="$TMP/run5.log" +TEST_TOKEN="eyJhIjoiZmFrZS10b2tlbi1mb3ItdGVzdCJ9" +rm -f "$CFD/tunnel.env" +TUNNEL_TOKEN="$TEST_TOKEN" \ + bash "$DEPLOY" --prefix "$SANDBOX" > "$OUT5" 2>&1 +RC5=$? +check "Token 模式退出码为 0" "$RC5" "0" +exists "Token 写进了 tunnel.env" "$CFD/tunnel.env" +check "tunnel.env 内容正确" \ + "$(cat "$CFD/tunnel.env" 2>/dev/null)" "TUNNEL_TOKEN=$TEST_TOKEN" +if grep -q "$TEST_TOKEN" "$UNIT/lanremote-tunnel.service" 2>/dev/null; then + bad "unit 里出现了明文 Token" +else + ok "unit 里没有明文 Token（只有 EnvironmentFile 引用）" +fi +if grep -q 'EnvironmentFile' "$UNIT/lanremote-tunnel.service" 2>/dev/null; then + ok "unit 用了 EnvironmentFile 读 Token" +else + bad "unit 缺 EnvironmentFile" +fi +if grep -q -- '--token' "$UNIT/lanremote-tunnel.service" 2>/dev/null; then + ok "unit 的 ExecStart 里用 --token \${TUNNEL_TOKEN}" +else + bad "unit 的 ExecStart 没走 Token 模式" +fi + +echo +echo "── 8b. tunnel.env 权限应该是 600 ──" +PERM=$(stat -c '%a' "$CFD/tunnel.env" 2>/dev/null || echo "?") +# Git Bash 上 chmod 的语义和 Linux 不完全一样，这里只做提示 +echo " tunnel.env 权限: $PERM（Linux 上应为 600）" + +# ════════════════════════════════════════════════════════════════ +echo +echo "── 9. 缺文件时要明确报错，不能静默 ──" +BROKEN="$TMP/broken" +mkdir -p "$BROKEN" +cp "$REPO/relay/relay.py" "$BROKEN/" +# 故意少给 admin.py / landing.py / showcase.py / favicon.ico / site_shots +OUT6="$TMP/run6.log" +bash "$BROKEN/../broken/relay.py" --help >/dev/null 2>&1 # 只是占位，别在意 +python - "$DEPLOY" "$BROKEN" <<'PYEOF' > "$TMP/run6.log" 2>&1 +import shutil, subprocess, sys +from pathlib import Path +deploy, broken = sys.argv[1], sys.argv[2] +# 把 deploy.sh 拷到「残缺的包」里再跑 +shutil.copy2(deploy, Path(broken) / "deploy.sh") +r = subprocess.run(["bash", str(Path(broken) / "deploy.sh"), + "--prefix", broken + "/sandbox", "--skip-tunnel"], + capture_output=True, text=True, encoding="utf-8", + errors="replace") +print(r.stdout or "") +print(r.stderr or "") +sys.exit(r.returncode) +PYEOF +RC6=$? +if [ "$RC6" != "0" ]; then + ok "文件不全时明确失败（退出码 $RC6）" +else + bad "文件不全竟然还成功了" +fi +if grep -q '程序文件不全' "$TMP/run6.log" 2>/dev/null; then + ok "报错信息说清了是「程序文件不全」" +else + bad "报错信息不够明确: $(tail -3 "$TMP/run6.log" 2>/dev/null | tr '\n' ' ')" +fi + +# ════════════════════════════════════════════════════════════════ +echo +echo "── 10. 桩命令确实被调用过（证明流程真的走了）──" +for kw in "systemctl daemon-reload" "systemctl enable" "iptables" ; do + if grep -q "$kw" "$STUB_LOG" 2>/dev/null; then + ok "调用过 $kw" + else + bad "没调用过 $kw" + fi +done + +# ════════════════════════════════════════════════════════════════ +echo +echo "============================================================" +echo " 结果: 通过 $PASS 项，失败 $FAIL 项" +echo "============================================================" +if [ "$FAIL" = "0" ]; then + echo " 沙箱目录（想自己看就留着）: $TMP" + rm -rf "$TMP" + exit 0 +else + echo " 沙箱目录保留供排查: $TMP" + echo + echo " ── 第一次部署输出（末尾 25 行）──" + tail -25 "$OUT1" 2>/dev/null | sed 's/^/ /' + exit 1 +fi diff --git a/_build/test_zip_deploy.sh b/_build/test_zip_deploy.sh new file mode 100644 index 0000000..56f6626 --- /dev/null +++ b/_build/test_zip_deploy.sh @@ -0,0 +1,221 @@ +#!/bin/bash +# ════════════════════════════════════════════════════════════════ +# 端到端验证：拿**真正打包出来的**服务器端 zip 解压，在里面跑 deploy.sh +# ════════════════════════════════════════════════════════════════ +# +# 为什么还要单独测这个： +# 前面的 test_deploy_sh.sh 是拿仓库里的 relay/ 目录跑的。 +# 但用户拿到的是 zip —— 有没有可能打包漏了文件、 +# 或者 zip 里权限/换行变了？只有真的解压出来跑一遍才知道。 +# +# 用法: bash _build/test_zip_deploy.sh [版本号] +# ════════════════════════════════════════════════════════════════ +set -u + +REPO=$(cd "$(dirname "$0")/.." && pwd) +VERSION=${1:-1.8.2} +ZIP="$REPO/dist/ykxmz-server-$VERSION.zip" + +PASS=0 +FAIL=0 +ok() { PASS=$((PASS + 1)); printf " [PASS] %s\n" "$1"; } +bad() { FAIL=$((FAIL + 1)); printf " [FAIL] %s\n" "$1"; } +check(){ if [ "$2" = "$3" ]; then ok "$1"; else bad "$1（期望 $3，实际 $2）"; fi; } + +echo "============================================================" +echo " 从发布 zip 端到端验证 deploy.sh v$VERSION" +echo "============================================================" +echo " zip: $ZIP" + +if [ ! -f "$ZIP" ]; then + echo " 找不到 zip —— 先跑 python _build/package_remote.py" + exit 1 +fi +echo " 大小: $(stat -c %s "$ZIP" 2>/dev/null || echo '?') 字节" + +TMP=$(mktemp -d) +echo " 解压到: $TMP" + +# ──────────────────────────────────────────────────────────── +echo +echo "── 1. zip 里必须有一键部署脚本 ──" +python - "$ZIP" <<'PYEOF' +import sys, zipfile +from pathlib import Path +z = zipfile.ZipFile(sys.argv[1]) +names = z.namelist() +need = ["deploy.sh", "deploy-tune.sh", "relay.py", "admin.py", + "landing.py", "showcase.py", "favicon.ico", + "site_shots/pc-main.png", "watchdog.sh", "net-tune.sh", + "README-server.txt"] +bad = 0 +for n in need: + hit = [x for x in names if x.endswith("/" + n) or x.endswith(n)] + if hit: + print(" [PASS] zip 含 %s" % n) + else: + print(" [FAIL] zip 缺 %s" % n) + bad += 1 +print(" ── 共 %d 个条目 ──" % len(names)) +sys.exit(1 if bad else 0) +PYEOF +if [ $? -eq 0 ]; then PASS=$((PASS + 11)); else FAIL=$((FAIL + 1)); fi + +# ──────────────────────────────────────────────────────────── +echo +echo "── 2. 解压 ──" +if command -v unzip >/dev/null 2>&1; then + unzip -q "$ZIP" -d "$TMP" +else + python -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).extractall(sys.argv[2])" \ + "$ZIP" "$TMP" +fi +SRV=$(find "$TMP" -maxdepth 2 -type d -name "ykxmz-server-*" | head -1) +if [ -z "$SRV" ]; then + bad "解压后找不到 ykxmz-server-* 目录" + exit 1 +fi +ok "解压出目录 $(basename "$SRV")" + +# ──────────────────────────────────────────────────────────── +echo +echo "── 3. 解压出来的 .sh 换行符 / 权限 ──" +python - "$SRV" <<'PYEOF' +import sys +from pathlib import Path +d = Path(sys.argv[1]) +for name in ("deploy.sh", "deploy-tune.sh"): + p = d / name + if not p.is_file(): + print(" [FAIL] 没有 %s" % name); continue + raw = p.read_bytes() + crlf = raw.count(b"\r\n") + bom = raw.startswith(b"\xef\xbb\xbf") + if crlf == 0 and not bom: + print(" [PASS] %s 是 LF 且无 BOM" % name) + else: + print(" [FAIL] %s CRLF=%d BOM=%s" % (name, crlf, bom)) +PYEOF +if [ $? -eq 0 ]; then PASS=$((PASS + 2)); fi + +# ──────────────────────────────────────────────────────────── +echo +echo "── 4. 从解压目录跑 --help ──" +HELP=$(cd "$SRV" && bash deploy.sh --help 2>&1) +check "--help 退出码为 0" "$?" "0" +if echo "$HELP" | grep -q '用法'; then ok "--help 有用法说明"; else bad "--help 没用法"; fi +if echo "$HELP" | grep -q 'v1\.8\.'; then ok "--help 显示了版本号（从 relay.py 读的）"; else bad "--help 版本号没读出来"; fi + +# ──────────────────────────────────────────────────────────── +echo +echo "── 5. 从解压目录做一次沙箱部署 ──" +STUB="$TMP/stub" +SANDBOX="$TMP/sandbox" +STUB_LOG="$TMP/stub.log" +mkdir -p "$STUB"; : > "$STUB_LOG" +export STUB_LOG +REAL_PY=$(command -v python 2>/dev/null || true) + +mk() { cat > "$STUB/$1"; chmod +x "$STUB/$1"; } + +mk systemctl <<'EOF' +#!/bin/bash +echo "systemctl $*" >> "$STUB_LOG" +case "$1" in is-active) echo active;; is-enabled) echo enabled;; esac +exit 0 +EOF +mk ip <<'EOF' +#!/bin/bash +echo "ip $*" >> "$STUB_LOG" +[ "$1" = "-4" ] && echo "default via 192.168.1.1 dev wlan0 proto dhcp" +exit 0 +EOF +mk iptables <<'EOF' +#!/bin/bash +echo "iptables $*" >> "$STUB_LOG" +RULES="$STUB_LOG.rules"; touch "$RULES" +if [ "${1:-}" = "-t" ] && [ "${3:-}" = "-L" ]; then + while read -r r; do [ -n "$r" ] && echo "TCPMSS tcp -- $r"; done < "$RULES" + exit 0 +fi +chain=""; mss=""; action=""; prev="" +for a in "$@"; do + case "$prev" in -C|-D|-A) chain="$a";; --set-mss) mss="$a";; esac + case "$a" in -C|-D|-A) [ -z "$action" ] && action="$a";; esac + prev="$a" +done +key="$chain:$mss" +case "$action" in + -C) grep -qxF "$key" "$RULES" 2>/dev/null && exit 0 || exit 1 ;; + -A) grep -qxF "$key" "$RULES" 2>/dev/null || echo "$key" >> "$RULES"; exit 0 ;; + -D) grep -qxF "$key" "$RULES" 2>/dev/null || exit 1 + grep -vxF "$key" "$RULES" > "$RULES.t" 2>/dev/null; mv "$RULES.t" "$RULES"; exit 0 ;; +esac +exit 0 +EOF +mk cloudflared <<'EOF' +#!/bin/bash +[ "$1" = "--version" ] && { echo "cloudflared version 2026.9.3 (stub)"; exit 0; } +echo "cloudflared $*" >> "$STUB_LOG"; exit 0 +EOF +mk curl <<'EOF' +#!/bin/bash +for a in "$@"; do + case "$a" in *v1/health*) echo '{"ok": true}'; exit 0;; esac +done +exit 0 +EOF +mk free <<'EOF' +#!/bin/bash +echo " total used free" +echo "Mem: 460 131 144" +EOF +mk nmcli <<'EOF' +#!/bin/bash +exit 0 +EOF +mk getent <<'EOF' +#!/bin/bash +exit 0 +EOF +[ -n "$REAL_PY" ] && mk python3 < "$OUT" 2>&1 +RC=$? +check "沙箱部署退出码为 0" "$RC" "0" +if [ "$RC" != "0" ]; then tail -20 "$OUT" | sed 's/^/ /'; fi + +REL="$SANDBOX/root/lanremote-relay" +UNIT="$SANDBOX/etc/systemd/system" +for f in relay.py admin.py landing.py showcase.py favicon.ico; do + if [ -f "$REL/$f" ]; then ok "部署了 $f"; else bad "没部署 $f"; fi +done +[ -f "$REL/site_shots/pc-main.png" ] && ok "部署了截图" || bad "没部署截图" +for u in lanremote-relay lanremote-nettune lanremote-tunnel lanremote-tunnel-h2; do + [ -f "$UNIT/$u.service" ] && ok "生成了 $u.service" || bad "缺 $u.service" +done + +echo +echo "── 6. 再跑一遍（幂等）──" +echo "keep" > "$REL/data/sentinel.txt" +(cd "$SRV" && bash deploy.sh --prefix "$SANDBOX" --skip-tunnel) > "$TMP/run2.log" 2>&1 +check "第二次退出码为 0" "$?" "0" +check "哨兵文件还在" "$(cat "$REL/data/sentinel.txt" 2>/dev/null)" "keep" + +echo +echo "============================================================" +echo " 结果: 通过 $PASS 项，失败 $FAIL 项" +echo "============================================================" +if [ "$FAIL" = "0" ]; then + rm -rf "$TMP" + exit 0 +else + echo " 临时目录保留: $TMP" + exit 1 +fi diff --git a/relay/deploy-tune.sh b/relay/deploy-tune.sh new file mode 100644 index 0000000..75a471b --- /dev/null +++ b/relay/deploy-tune.sh @@ -0,0 +1,149 @@ +#!/bin/bash +# 网络调优 —— 供 deploy.sh 一键部署时调用，也可以单独重跑。 +# +# 用法： +# bash deploy-tune.sh # 用默认值 +# bash deploy-tune.sh --prefix /tmp/x # 装到沙箱目录（测试用） +# bash deploy-tune.sh --help +# +# ──────────────────────────────────────────────────────────────── +# 分工（重要：同一个值绝不能有两处来源） +# ──────────────────────────────────────────────────────────────── +# 本脚本负责： TCP keepalive、开机加速 +# net-tune.sh 负责：MSS 钳制、接口 MTU、路径 MTU 探测 +# +# 本脚本第 2 步会**调用 net-tune.sh**，所以单独跑本脚本 +# 也能拿到完整的调优效果。 +# +# 早先两边都设了一遍 MSS 和 MTU，结果"到底哪个值生效"很难查 +# （net-tune.sh 写着保持 1500，本脚本写着压到 1400，谁后跑谁赢）。 +# 现在只有一个出处：net-tune.sh。 +# +# ──────────────────────────────────────────────────────────────── +# 本脚本做的两件事，各自的实测依据 +# ──────────────────────────────────────────────────────────────── +# +# ① TCP keepalive 改成 30/10/3（默认是 7200/75/9） +# 为什么：这条 4G 线路会**静默丢连接** —— 不发明文 FIN/RST， +# 对端就以为连接还在。而 Linux 默认要 7200 秒（2 小时）才发现死链。 +# 于是隧道/长轮询会挂在一条早已死掉的连接上，表现就是 +# "过了几分钟突然 502 / 连接超时"。 +# 改成 30 秒首发探测、每 10 秒一次、3 次没回应判死 —— +# 最快 60 秒就能发现并重建。 +# +# ② mask 掉 systemd-networkd-wait-online +# 这台机器 NetworkManager 和 systemd-networkd 同时在跑， +# 但 wlan0 归 NetworkManager 管。 +# systemd-networkd-wait-online 傻等一个不归它管的网络， +# 干等 2 分钟超时然后 failed，把 network-online.target 拖住 —— +# relay / tunnel 全跟着等。 +# 实测：用户空间启动 2 分 6 秒 -> 14 秒； +# 掉电重启后公网恢复 2 分 10 秒 -> 24 秒。 +# ──────────────────────────────────────────────────────────────── +set -u + +PREFIX="" +while [ $# -gt 0 ]; do + case "$1" in + --prefix) PREFIX="${2:-}"; shift 2 ;; + --help|-h) + echo "用法: bash deploy-tune.sh [--prefix DIR]" + echo + echo " 本脚本负责 TCP keepalive 和开机加速；" + echo " MSS 钳制 / 接口 MTU 由 net-tune.sh 负责，第 2 步会调用它。" + echo + echo " --prefix DIR 安装根目录（默认 /），测试时指到临时目录" + echo " --help 显示这段帮助" + exit 0 ;; + *) echo "未知参数: $1（用 --help 看用法）"; exit 2 ;; + esac +done + +SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd) +SYSCTL_DIR="$PREFIX/etc/sysctl.d" +SYSCTL_FILE="$SYSCTL_DIR/97-ykxmz-network.conf" + +echo " 网络调优（前缀: ${PREFIX:-/}）" + +# ──────────────────────────────────────────────────────────────── +# 1. TCP keepalive：30 秒就发现死链 +# ──────────────────────────────────────────────────────────────── +echo +echo " [1/4] TCP keepalive（默认 7200 秒太慢，死链要挂 2 小时才被发现）" +mkdir -p "$SYSCTL_DIR" +# 注意：MSS / MTU / mtu_probing 由 net-tune.sh 负责， +# 别往这个文件里加那些 —— 会变成两处来源。 +cat > "$SYSCTL_FILE" <<'EOF' +# ykxmz: 这条 4G 线路会静默丢连接（不发明文 FIN/RST）， +# 而 Linux 默认要 7200 秒才发现死链 —— 表现就是"过几分钟突然 502"。 +# 改成 30 秒首发探测、每 10 秒一次、3 次没回应判死。 +net.ipv4.tcp_keepalive_time = 30 +net.ipv4.tcp_keepalive_intvl = 10 +net.ipv4.tcp_keepalive_probes = 3 +EOF + +if [ -w /proc/sys/net/ipv4/tcp_keepalive_time ]; then + sysctl -p "$SYSCTL_FILE" >/dev/null 2>&1 || \ + sysctl --system >/dev/null 2>&1 || true +fi +printf " keepalive: %s 秒首发 / %s 秒间隔 / %s 次判死\n" \ + "$(cat /proc/sys/net/ipv4/tcp_keepalive_time 2>/dev/null || echo '?')" \ + "$(cat /proc/sys/net/ipv4/tcp_keepalive_intvl 2>/dev/null || echo '?')" \ + "$(cat /proc/sys/net/ipv4/tcp_keepalive_probes 2>/dev/null || echo '?')" +echo " 配置文件: $SYSCTL_FILE" + +# ──────────────────────────────────────────────────────────────── +# 2. MSS / 接口 MTU / 路径探测 —— 交给 net-tune.sh（唯一出处） +# ──────────────────────────────────────────────────────────────── +echo +echo " [2/4] MSS 钳制 / 接口 MTU / 路径探测（调用 net-tune.sh）" +TUNE="$SCRIPT_DIR/net-tune.sh" +NETTUNE_OK=0 +if [ -f "$TUNE" ]; then + if bash "$TUNE"; then + NETTUNE_OK=1 + else + echo " ⚠ net-tune.sh 报错，继续" + fi +else + echo " ⚠ 找不到 net-tune.sh（$TUNE）" + echo " 它负责 MSS 钳制和接口 MTU，缺了它这次就只做了 keepalive 那一半。" +fi + +# ──────────────────────────────────────────────────────────────── +# 3. 加快开机（mask networkd-wait-online） +# ──────────────────────────────────────────────────────────────── +echo +echo " [3/4] 关掉 systemd-networkd-wait-online（网络不归它管，白等 2 分钟）" +if command -v systemctl >/dev/null 2>&1; then + systemctl disable --now systemd-networkd-wait-online.service \ + >/dev/null 2>&1 || true + systemctl mask systemd-networkd-wait-online.service \ + >/dev/null 2>&1 || true + echo " 状态: $(systemctl is-enabled systemd-networkd-wait-online.service 2>&1)" +else + echo " [跳过] 没有 systemctl" +fi + +# ──────────────────────────────────────────────────────────────── +# 4. 收尾 +# ──────────────────────────────────────────────────────────────── +# MSS / MTU 只对**新建连接**生效。net-tune.sh 自己会把正在跑的隧道 +# 重启一遍；只有它没跑成的时候这里才补一次，免得重启两遍。 +echo +echo " [4/4] 收尾" +if [ "$NETTUNE_OK" = "1" ]; then + echo " net-tune.sh 已经处理过隧道重建，这里不重复重启" +elif command -v systemctl >/dev/null 2>&1; then + for svc in lanremote-tunnel lanremote-tunnel-h2; do + if systemctl is-active --quiet "$svc" 2>/dev/null; then + echo " $svc 正在跑，补一次重启让新参数生效" + systemctl restart "$svc" >/dev/null 2>&1 || true + fi + done +else + echo " [跳过] 没有 systemctl" +fi + +echo +echo " 网络调优完成（keepalive 见上；MSS/MTU 见 net-tune.sh 的输出）" diff --git a/relay/deploy.sh b/relay/deploy.sh new file mode 100644 index 0000000..7dbc915 --- /dev/null +++ b/relay/deploy.sh @@ -0,0 +1,831 @@ +#!/bin/bash +# ════════════════════════════════════════════════════════════════ +# ykxmz 服务器端 · 一键部署 +# ════════════════════════════════════════════════════════════════ +# +# 把「服务器端」这个文件夹拷到一台能上外网的 Linux 小机器上，然后： +# +# bash deploy.sh +# +# 它会自己把下面这些全部弄好，不用你一步步敲： +# +# 1. 检查并安装 cloudflared（已装就跳过） +# 2. 把中转程序装到 /root/lanremote-relay/ +# 3. 网络调优（keepalive、MSS、MTU、开机加速） +# 4. 注册四个 systemd 服务并设成开机自启 +# 5. 配好 Cloudflare 隧道（具名隧道，地址固定不变） +# 6. 启动、自检、把公网地址打印出来 +# +# ──────────────────────────────────────────────────────────────── +# 怎么用 +# ──────────────────────────────────────────────────────────────── +# +# 最省事（机器上已经有隧道凭据，直接复用）： +# bash deploy.sh +# +# 用 Cloudflare 给的隧道 Token（在 Zero Trust 后台复制来的那串）： +# TUNNEL_TOKEN=eyJhIjoi... bash deploy.sh +# （也可以写成 --token eyJhIjoi...，但**不推荐** —— +# Token 会留在 shell 历史里。用环境变量更干净。） +# +# 改域名 / 改隧道名 / 只装中转不要隧道： +# bash deploy.sh --hostname relay.你的域名 +# bash deploy.sh --tunnel-name myserver +# bash deploy.sh --skip-tunnel +# +# 看全部参数： +# bash deploy.sh --help +# +# ──────────────────────────────────────────────────────────────── +# 关于「重跑」 +# ──────────────────────────────────────────────────────────────── +# 这个脚本是**幂等**的：已经装过的机器再跑一遍 = 升级。 +# * 程序文件覆盖成新的 +# * systemd 服务重写一遍（内容一样就没变化） +# * 隧道凭据 / 已有 config.yml / 管理密码 / 设备数据 **都不动** +# * iptables 规则先清后加，不会越积越多 +# 所以放心重跑，不会把已有配置冲掉。 +# +# ──────────────────────────────────────────────────────────────── +# 安全 +# ──────────────────────────────────────────────────────────────── +# 脚本里**不含任何密码或 Token**。 +# Token 只从环境变量 / 命令行读，落到机器上时写进 +# /root/.cloudflared/tunnel.env 并设成 600（只有 root 能看）。 +# ════════════════════════════════════════════════════════════════ +set -u + +# ──────────────────────────────────────────────────────────────── +# 版本号：从 relay.py 里读，避免两处不一致 +# ──────────────────────────────────────────────────────────────── +SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd) +VERSION="unknown" +if [ -f "$SCRIPT_DIR/relay.py" ]; then + VERSION=$(grep -m1 '^VERSION = ' "$SCRIPT_DIR/relay.py" 2>/dev/null \ + | sed 's/.*"\(.*\)".*/\1/') + [ -z "$VERSION" ] && VERSION="unknown" +fi + +# ──────────────────────────────────────────────────────────────── +# 默认值 +# ──────────────────────────────────────────────────────────────── +PREFIX="${PREFIX:-}" # 安装根，默认 /（测试时可指到临时目录） +TOKEN="${TUNNEL_TOKEN:-}" # 隧道 Token，默认空 +HOSTNAME_ARG="" # 域名，默认沿用已有 config.yml +TUNNEL_NAME="${TUNNEL_NAME:-lanremote}" # 具名隧道名 +PROTOCOL="${PROTOCOL:-quic}" # quic 或 http2 +SKIP_TUNNEL=0 +DOWNLOADS_SRC="" # 可选：把发布产物拷进下载目录 +PORT="${RELAY_PORT:-8080}" + +usage() { + cat </ —— 就是官网 + 查状态 lanremote-status + 看公网地址 lanremote-url +EOF +} + +# ──────────────────────────────────────────────────────────────── +# 解析参数 +# ──────────────────────────────────────────────────────────────── +while [ $# -gt 0 ]; do + case "$1" in + -h|--help) usage; exit 0 ;; + --token) TOKEN="${2:-}"; shift 2 ;; + --hostname) HOSTNAME_ARG="${2:-}"; shift 2 ;; + --tunnel-name) TUNNEL_NAME="${2:-}"; shift 2 ;; + --protocol) PROTOCOL="${2:-}"; shift 2 ;; + --port) PORT="${2:-}"; shift 2 ;; + --downloads) DOWNLOADS_SRC="${2:-}"; shift 2 ;; + --skip-tunnel) SKIP_TUNNEL=1; shift ;; + --prefix) PREFIX="${2:-}"; shift 2 ;; + *) + echo "未知参数: $1" >&2 + echo "用 bash deploy.sh --help 看用法" >&2 + exit 2 ;; + esac +done + +if [ "$PROTOCOL" != "quic" ] && [ "$PROTOCOL" != "http2" ]; then + echo "协议只能是 quic 或 http2，收到的是: $PROTOCOL" >&2 + exit 2 +fi + +# ──────────────────────────────────────────────────────────────── +# 路径：全部挂在 $PREFIX 下面 +# 真实部署时 PREFIX 是空的，于是这些就是标准的绝对路径； +# 测试时 --prefix /tmp/xxx，所有写入都关在沙箱里，不碰真系统。 +# ──────────────────────────────────────────────────────────────── +RELAY_DIR="$PREFIX/root/lanremote-relay" +CF_DIR="$PREFIX/root/.cloudflared" +UNIT_DIR="$PREFIX/etc/systemd/system" +BIN_DIR="$PREFIX/usr/local/bin" +SYSCTL_DIR="$PREFIX/etc/sysctl.d" + +say() { echo "$@"; } +step() { echo; echo "════════ $* ════════"; } +warn() { echo " ⚠ $*"; } +die() { echo; echo " ✗ $*" >&2; exit 1; } + +say "════════════════════════════════════════════════════════" +say " ykxmz 服务器端 · 一键部署 v$VERSION" +say "════════════════════════════════════════════════════════" +say " 安装根目录: ${PREFIX:-/}" +say " 中转端口: $PORT" +say " 隧道协议: $PROTOCOL" +if [ "$SKIP_TUNNEL" = "1" ]; then + say " 隧道: 跳过（--skip-tunnel）" +elif [ -n "$TOKEN" ]; then + say " 隧道: Token 模式" +else + say " 隧道: 凭据文件模式" +fi + +# ════════════════════════════════════════════════════════════════ +# 1/7 环境检查 +# ════════════════════════════════════════════════════════════════ +step "1/7 环境检查" + +# 沙箱模式（--prefix）不需要 root，因为写的都是临时目录 +if [ -z "$PREFIX" ] && [ "$(id -u 2>/dev/null || echo 1)" != "0" ]; then + die "需要 root 权限运行（前面加 sudo，或者直接以 root 登录）" +fi + +if ! command -v python3 >/dev/null 2>&1; then + die "没有 python3。先装：apt update && apt install -y python3" +fi +say " python3 $(python3 -V 2>&1 | awk '{print $2}')" + +if ! command -v systemctl >/dev/null 2>&1; then + warn "没有 systemctl —— 装完之后要自己手动启动程序" +fi + +# 核心程序必须齐全，缺一个都别往下走 +MISSING="" +for f in relay.py admin.py landing.py showcase.py favicon.ico; do + [ -f "$SCRIPT_DIR/$f" ] || MISSING="$MISSING $f" +done +if [ -n "$MISSING" ]; then + die "程序文件不全，缺:$MISSING + （确认你是从 ykxmz-server-*.zip 解压出来的整个文件夹里跑的）" +fi +say " 程序文件齐全（5 个文件）" + +# 产品截图缺失只降级成警告 —— 官网上那几张图会 404， +# 但中转、配对、远控这些核心功能完全不受影响。 +# 打包脚本漏收 site_shots/ 目录这种事真的发生过， +# 不该因为这个就整个部署失败。 +if [ -d "$SCRIPT_DIR/site_shots" ]; then + say " 产品截图齐全（$(ls -1 "$SCRIPT_DIR/site_shots" 2>/dev/null | wc -l) 张）" +else + warn "没有 site_shots/ 目录 —— 官网上那几张产品截图会显示不出来，" + warn "其他功能都正常。" +fi + +say " 内存: $(free -m 2>/dev/null | awk 'NR==2{print $2" MB 总量 / "$7" MB 可用"}' || echo '读不到')" + +# ════════════════════════════════════════════════════════════════ +# 2/7 安装 cloudflared +# ════════════════════════════════════════════════════════════════ +step "2/7 cloudflared" + +CF_BIN="$BIN_DIR/cloudflared" +# 已经在 PATH 里能用的，直接用，不重复下载 +CF_READY=0 +if command -v cloudflared >/dev/null 2>&1 \ + && cloudflared --version >/dev/null 2>&1; then + CF_BIN=$(command -v cloudflared) + say " 已安装: $(cloudflared --version 2>&1 | head -1)" + say " 位置: $CF_BIN" + CF_READY=1 +elif [ -x "$CF_BIN" ] && "$CF_BIN" --version >/dev/null 2>&1; then + say " 已安装: $("$CF_BIN" --version 2>&1 | head -1)" + CF_READY=1 +fi + +if [ "$CF_READY" = "0" ]; then + if [ "$SKIP_TUNNEL" = "1" ]; then + say " [跳过] --skip-tunnel，不装 cloudflared" + else + ARCH=$(uname -m) + case "$ARCH" in + aarch64|arm64) CF_PKG=cloudflared-linux-arm64 ;; + armv7l|armv6l) CF_PKG=cloudflared-linux-arm ;; + x86_64|amd64) CF_PKG=cloudflared-linux-amd64 ;; + *) die "不认识的 CPU 架构: $ARCH（自己去 Cloudflare 官网下对应版本放到 $CF_BIN）" ;; + esac + say " 没装，开始下载（$ARCH -> $CF_PKG）" + mkdir -p "$BIN_DIR" + CF_URL="https://github.com/cloudflare/cloudflared/releases/latest/download/$CF_PKG" + # --http1.1：这条线路对 HTTP/2 下载不稳；--retry：偶发失败自动重试 + if curl -fsSL --http1.1 --retry 3 --connect-timeout 20 --max-time 300 \ + -o "$CF_BIN.tmp" "$CF_URL" 2>/dev/null; then + chmod +x "$CF_BIN.tmp" + # 下载完必须真的能跑 —— 拿到一个 404 页面 / 半截文件也要能发现 + if "$CF_BIN.tmp" --version >/dev/null 2>&1; then + mv -f "$CF_BIN.tmp" "$CF_BIN" + say " 装好了: $("$CF_BIN" --version 2>&1 | head -1)" + say " 位置: $CF_BIN" + CF_READY=1 + else + rm -f "$CF_BIN.tmp" + warn "下载到的文件跑不起来（可能是网络劫持返回了错误页）" + fi + else + warn "下载失败: $CF_URL" + fi + + if [ "$CF_READY" = "0" ]; then + warn "cloudflared 没装上 —— 中转服务照常能用（局域网内），" + warn "但**跨网络**要等装好 cloudflared 才能用。" + warn "可以手动装：" + warn " curl -fsSL -o $CF_BIN $CF_URL && chmod +x $CF_BIN" + fi + fi +fi + +# ════════════════════════════════════════════════════════════════ +# 3/7 部署程序文件 +# ════════════════════════════════════════════════════════════════ +step "3/7 部署程序文件到 $RELAY_DIR" + +mkdir -p "$RELAY_DIR/data" +mkdir -p "$RELAY_DIR/downloads" + +# 判断源和目标是不是同一个文件 —— 脚本有可能就在 RELAY_DIR 里跑， +# 那样 cp 自己到自己会报 "are the same file"。 +same_file() { + [ -f "$1" ] && [ -f "$2" ] || return 1 + [ "$(readlink -f "$1" 2>/dev/null)" = "$(readlink -f "$2" 2>/dev/null)" ] +} + +# ⚠ 用户会在**已经跑着的机器上反复执行**这个脚本（当升级用）。 +# 如果每次都不管三七二十一重启服务，正在服务的连接就被白打断一次。 +# 所以这里记录"这次到底改动了什么"，后面按需重启。 +RELAY_CHANGED=0 +SHOTS_CHANGED=0 +CHANGED_LIST="" + +# 内容比较：一样就不动。 +# cmp 不存在时保守地当成"变了"（多重启一次也好过改了没生效）。 +differs() { + [ -f "$1" ] || return 0 + if command -v cmp >/dev/null 2>&1; then + cmp -s "$1" "$2" && return 1 || return 0 + fi + return 0 +} + +copy_one() { + local name="$1" + local src="$SCRIPT_DIR/$name" + local dst="$RELAY_DIR/$name" + [ -f "$src" ] || return 0 + if same_file "$src" "$dst"; then + return 0 + fi + if ! differs "$src" "$dst"; then + return 0 # 内容一样，不碰时间戳 + fi + if cp -f "$src" "$dst"; then + RELAY_CHANGED=1 + CHANGED_LIST="$CHANGED_LIST $name" + else + warn "复制 $name 失败" + fi +} + +COPIED=0 +# 程序本体 + 运维脚本。清单写死容易漏（watchdog.sh 就漏过一次）， +# 所以这里把 relay 目录里所有 .py / .sh / .ico 都带上。 +for f in "$SCRIPT_DIR"/*.py "$SCRIPT_DIR"/*.sh "$SCRIPT_DIR"/*.ico; do + [ -f "$f" ] || continue + COPIED=$((COPIED + 1)) + copy_one "$(basename "$f")" +done + +# 产品截图（官网要显示） +if [ -d "$SCRIPT_DIR/site_shots" ] \ + && ! same_file "$SCRIPT_DIR/site_shots" "$RELAY_DIR/site_shots"; then + mkdir -p "$RELAY_DIR/site_shots" + for shot in "$SCRIPT_DIR/site_shots"/*; do + [ -f "$shot" ] || continue + base=$(basename "$shot") + if differs "$shot" "$RELAY_DIR/site_shots/$base"; then + cp -f "$shot" "$RELAY_DIR/site_shots/$base" 2>/dev/null \ + && SHOTS_CHANGED=1 + fi + done +fi + +chmod +x "$RELAY_DIR"/*.sh 2>/dev/null || true + +# 语法检查：装上去之前先确认能编译，别把服务弄成起不来 +if python3 -m py_compile "$RELAY_DIR/relay.py" 2>/dev/null; then + say " relay.py 语法检查通过" +else + die "relay.py 编译不过 —— 文件可能坏了，先重新解压一份" +fi + +say " 已部署 $(ls -1 "$RELAY_DIR"/*.py "$RELAY_DIR"/*.sh 2>/dev/null | wc -l) 个脚本" +say " 数据目录 $RELAY_DIR/data 保持不动（设备、配对码、管理密码都在里面）" + +# 可选：把发布产物拷进下载目录（官网的下载按钮读这里） +if [ -n "$DOWNLOADS_SRC" ]; then + if [ -d "$DOWNLOADS_SRC" ]; then + n=$(ls -1 "$DOWNLOADS_SRC" 2>/dev/null | wc -l) + cp -f "$DOWNLOADS_SRC"/* "$RELAY_DIR/downloads/" 2>/dev/null || true + say " 已把 $n 个文件拷进下载目录" + else + warn "--downloads 给的目录不存在: $DOWNLOADS_SRC" + fi +fi + +# ════════════════════════════════════════════════════════════════ +# 4/7 网络调优 +# ════════════════════════════════════════════════════════════════ +step "4/7 网络调优" + +if [ -f "$RELAY_DIR/deploy-tune.sh" ]; then + # shellcheck disable=SC1090 + if [ -n "$PREFIX" ]; then + bash "$RELAY_DIR/deploy-tune.sh" --prefix "$PREFIX" || warn "网络调优有报错，继续" + else + bash "$RELAY_DIR/deploy-tune.sh" || warn "网络调优有报错，继续" + fi +else + warn "找不到 deploy-tune.sh，跳过网络调优" +fi + +# ════════════════════════════════════════════════════════════════ +# 5/7 写 systemd 服务 +# ════════════════════════════════════════════════════════════════ +step "5/7 注册 systemd 服务" + +mkdir -p "$UNIT_DIR" + +# ──────────────────────────────────────────────────────────────── +# 写 unit 文件的统一入口 +# ──────────────────────────────────────────────────────────────── +# 为什么要包一层：用户会在已经跑着的机器上反复执行本脚本（升级用）。 +# 如果每次都把 unit 重写一遍，mtime 就变了 —— 于是每次都得 +# daemon-reload + 重启服务，正在服务的连接被白打断。 +# 内容真正变了才落盘，并置上对应的标志，后面按标志决定要不要重启。 +UNITS_CHANGED=0 +RELAY_UNIT_CHANGED=0 +TUNNEL_UNIT_CHANGED=0 + +write_unit() { + local path="$1" + local tmp="$path.new.$$" + cat > "$tmp" + if [ -f "$path" ] && command -v cmp >/dev/null 2>&1 \ + && cmp -s "$tmp" "$path"; then + rm -f "$tmp" + return 1 # 内容一样，没动 + fi + mv -f "$tmp" "$path" + UNITS_CHANGED=1 + return 0 # 真的改了 +} + +# ---- 中转服务 ---- +cat > "$UNIT_DIR/lanremote-relay.service" < "$UNIT_DIR/lanremote-nettune.service" <.service」找文件的， + # `systemctl enable lanremote-tunnel` 找的是 lanremote-tunnel.service。 + # 少这个后缀的话文件是写下去了，但 systemctl 完全看不见它 —— + # 而且不会有任何报错（enable 会安静地失败），非常难查。实测踩过。 + cat > "$UNIT_DIR/$unit.service" </dev/null 2>&1; then + systemctl daemon-reload >/dev/null 2>&1 || true + say " 已写入 4 个服务单元到 $UNIT_DIR" +else + say " [跳过] 没有 systemctl，服务单元已写好但没加载" +fi + +# ════════════════════════════════════════════════════════════════ +# 6/7 配置隧道 +# ════════════════════════════════════════════════════════════════ +step "6/7 配置隧道" + +TUNNEL_OK=0 +PUBLIC_URL="" + +if [ "$SKIP_TUNNEL" = "1" ]; then + say " --skip-tunnel：不配置隧道" +elif [ "$CF_READY" = "0" ]; then + warn "cloudflared 没装好，隧道配不了" +else + mkdir -p "$CF_DIR" + chmod 700 "$CF_DIR" 2>/dev/null || true + + if [ -n "$TOKEN" ]; then + # ---------- Token 模式 ---------- + say " Token 模式" + # 单独存文件 + 600 权限：unit 文件是 644 的，Token 不能写在里面 + umask 077 + printf 'TUNNEL_TOKEN=%s\n' "$TOKEN" > "$CF_DIR/tunnel.env" + umask 022 + chmod 600 "$CF_DIR/tunnel.env" + say " Token 已写入 $CF_DIR/tunnel.env（权限 600，只有 root 能看）" + TUNNEL_OK=1 + if [ -n "$HOSTNAME_ARG" ]; then + PUBLIC_URL="https://$HOSTNAME_ARG" + fi + say " 提示：Token 模式的入口域名在 Cloudflare 后台配，本地看不到。" + say " 如果给了 --hostname，就按它当公网地址。" + else + # ---------- 凭据文件模式 ---------- + CRED="" + for f in "$CF_DIR"/*.json; do + [ -f "$f" ] && CRED="$f" && break + done + + if [ -z "$CRED" ]; then + warn "没有找到隧道凭据（$CF_DIR/*.json），也没给 TUNNEL_TOKEN" + warn "两种办法，任选一种：" + warn " A. 在 Cloudflare Zero Trust 后台建隧道，复制 Token，然后：" + warn " TUNNEL_TOKEN=<粘贴> bash $0" + warn " B. 在这台机器上登录并创建具名隧道（需要自己的域名）：" + warn " $CF_BIN tunnel login" + warn " $CF_BIN tunnel create $TUNNEL_NAME" + warn " $CF_BIN tunnel route dns $TUNNEL_NAME relay.你的域名" + warn " 然后重跑本脚本。" + warn "中转本身已经装好了 —— 局域网内可以直接用，只是跨网络还不行。" + else + TUNNEL_ID=$(basename "$CRED" .json) + say " 找到凭据: $CRED" + say " 隧道 ID: $TUNNEL_ID" + + # 域名：命令行 > 已有 config.yml > 猜不出来就报错 + CUR_HOST="" + if [ -f "$CF_DIR/config.yml" ]; then + CUR_HOST=$(grep -m1 '^ *- hostname:' "$CF_DIR/config.yml" 2>/dev/null \ + | sed 's/.*hostname: *//' | tr -d '"'"'"' ') + fi + HOST="$HOSTNAME_ARG" + [ -z "$HOST" ] && HOST="$CUR_HOST" + + if [ -z "$HOST" ]; then + warn "认不出公网域名（既没给 --hostname，config.yml 里也没有）" + warn "补上域名再跑一次：" + warn " bash $0 --hostname relay.你的域名" + warn "如果这个域名还没指向隧道，先执行：" + warn " $CF_BIN tunnel route dns $TUNNEL_NAME relay.你的域名" + else + # config.yml 只在「不存在」或「用户明确给了 --hostname」时才重写， + # 免得把别人手工调过的配置冲掉。 + if [ ! -f "$CF_DIR/config.yml" ] || [ -n "$HOSTNAME_ARG" ]; then + cat > "$CF_DIR/config.yml" </dev/null 2>&1; then + systemctl enable lanremote-relay >/dev/null 2>&1 || true + systemctl enable lanremote-nettune >/dev/null 2>&1 || true + systemctl start lanremote-nettune >/dev/null 2>&1 || true + + say " 启动中转服务" + systemctl restart lanremote-relay >/dev/null 2>&1 || true + sleep 3 + say " lanremote-relay: $(systemctl is-active lanremote-relay 2>&1)" + + if [ "$TUNNEL_OK" = "1" ]; then + say " 启动隧道服务" + systemctl enable lanremote-tunnel >/dev/null 2>&1 || true + # 备用隧道不自动启用 —— 两个同时跑会互相争抢 + systemctl disable lanremote-tunnel-h2 >/dev/null 2>&1 || true + systemctl restart lanremote-tunnel >/dev/null 2>&1 || true + say " lanremote-tunnel: $(systemctl is-active lanremote-tunnel 2>&1)" + elif [ "$SKIP_TUNNEL" != "1" ]; then + say " 隧道没配好，先不启动" + fi + + # 看门狗（如果包里有） + if [ -f "$RELAY_DIR/watchdog.sh" ]; then + cat > "$UNIT_DIR/lanremote-watchdog.service" < "$UNIT_DIR/lanremote-watchdog.timer" <<'EOF' +[Unit] +Description=定期检查隧道 + +[Timer] +OnBootSec=45s +OnUnitActiveSec=20s +AccuracySec=5s +Unit=lanremote-watchdog.service + +[Install] +WantedBy=timers.target +EOF + systemctl daemon-reload >/dev/null 2>&1 || true + systemctl enable lanremote-watchdog.timer >/dev/null 2>&1 || true + systemctl start lanremote-watchdog.timer >/dev/null 2>&1 || true + say " 看门狗: $(systemctl is-active lanremote-watchdog.timer 2>&1)" + fi +else + say " [跳过] 没有 systemctl，服务没启动" +fi + +# 便捷命令 +mkdir -p "$BIN_DIR" +cat > "$BIN_DIR/lanremote-url" <<'EOF' +#!/bin/bash +# 打印当前公网地址 +cat /root/lanremote-relay/public_url.txt 2>/dev/null \ + || grep -oE 'https://[a-z0-9.-]+' /root/lanremote-relay/tunnel.log 2>/dev/null | tail -1 \ + || echo "(还不知道，隧道可能还没连上)" +EOF +cat > "$BIN_DIR/lanremote-key" <<'EOF' +#!/bin/bash +# 打印管理页钥匙 +cat /root/lanremote-relay/data/admin_key.txt 2>/dev/null || echo "(还没有)" +EOF +cat > "$BIN_DIR/lanremote-status" <<'EOF' +#!/bin/bash +# 一眼看清状态 +echo "=== 服务 ===" +for s in lanremote-relay lanremote-tunnel lanremote-tunnel-h2 lanremote-nettune lanremote-watchdog.timer; do + printf " %-26s %s\n" "$s" "$(systemctl is-active "$s" 2>/dev/null)" +done +echo +echo "=== 端口 ===" +(curl -s --max-time 5 http://127.0.0.1:8080/v1/health 2>/dev/null | head -c 120) || echo " 本机 8080 没响应" +echo +echo "=== 公网 ===" +cat /root/lanremote-relay/public_url.txt 2>/dev/null || echo " (还不知道)" +echo +echo "=== 内存 ===" +free -m 2>/dev/null | awk 'NR==2{printf " 已用 %s MB / 可用 %s MB\n", $3, $7}' +EOF +chmod +x "$BIN_DIR"/lanremote-url "$BIN_DIR"/lanremote-key \ + "$BIN_DIR"/lanremote-status 2>/dev/null || true + +# 把公网地址写下来（relay 的 /v1/url 和客户端都读这个文件） +if [ -n "$PUBLIC_URL" ]; then + printf '%s\n' "$PUBLIC_URL" > "$RELAY_DIR/public_url.txt" +fi + +# ---- 自检 ---- +say +say " ── 自检 ──" +sleep 2 +LOCAL_OK=0 +for i in 1 2 3 4 5; do + if curl -s --max-time 8 "http://127.0.0.1:$PORT/v1/health" 2>/dev/null \ + | grep -q '"ok"'; then + LOCAL_OK=1 + break + fi + sleep 2 +done +if [ "$LOCAL_OK" = "1" ]; then + say " 本机中转: ✓ 通（http://127.0.0.1:$PORT/v1/health）" +else + warn "本机中转: ✗ 不通" + if command -v systemctl >/dev/null 2>&1; then + systemctl status lanremote-relay --no-pager -l 2>/dev/null | tail -8 | sed 's/^/ /' + fi + say " 看日志: tail -30 $RELAY_DIR/relay.log" +fi + +PUB_OK=0 +if [ -n "$PUBLIC_URL" ]; then + say " 等隧道连上（最多 90 秒）…" + for i in $(seq 1 30); do + if curl -s --max-time 12 "$PUBLIC_URL/v1/health" 2>/dev/null \ + | grep -q '"ok"'; then + PUB_OK=1 + break + fi + sleep 3 + done + if [ "$PUB_OK" = "1" ]; then + say " 公网访问: ✓ 通（$PUBLIC_URL）" + else + warn "公网访问: ✗ 还没通" + say " 看一眼隧道日志最后几行：" + tail -6 "$RELAY_DIR/tunnel.log" 2>/dev/null | sed 's/^/ /' + say " 常见原因：域名 DNS 还没指向隧道、或者这条线路连不上边缘" + fi +fi + +# ════════════════════════════════════════════════════════════════ +# 收尾 +# ════════════════════════════════════════════════════════════════ +KEY=$(cat "$RELAY_DIR/data/admin_key.txt" 2>/dev/null || echo "") + +say +say "════════════════════════════════════════════════════════" +if [ "$LOCAL_OK" = "1" ] && { [ "$TUNNEL_OK" = "0" ] || [ "$PUB_OK" = "1" ]; }; then + say " 装好了 ✓" +else + say " 装完了，但上面有 ✗ 的项目要看一眼" +fi +say "════════════════════════════════════════════════════════" +say +if [ -n "$PUBLIC_URL" ]; then + say " 公网地址 $PUBLIC_URL" +else + say " 公网地址 （还没配上）" +fi +say " 官网 ${PUBLIC_URL:-http://<本机IP>:$PORT}/" +[ -n "$KEY" ] && say " 管理页 ${PUBLIC_URL:-http://<本机IP>:$PORT}/?key=$KEY" +say +say " 常用命令" +say " lanremote-status 看整体状态" +say " lanremote-url 看公网地址" +say " systemctl status lanremote-relay 看中转服务" +say " systemctl status lanremote-tunnel 看隧道" +say " journalctl -u lanremote-relay -f 跟日志" +say +say " 换隧道协议（quic 慢一点但尾延迟好 / http2 建连更稳）" +say " systemctl disable --now lanremote-tunnel" +say " systemctl enable --now lanremote-tunnel-h2" +say +say " 重跑本脚本 = 升级，已有配置和数据都不会动" +say +exit 0 diff --git a/relay/net-tune.sh b/relay/net-tune.sh index d6835fb..4448fd0 100644 --- a/relay/net-tune.sh +++ b/relay/net-tune.sh @@ -1,6 +1,10 @@ #!/bin/bash -# 网络调优：修 MTU 问题（这次找到的**真正根因**）。 - +# 网络调优：修路径 MTU 问题 + 给 QUIC 隧道留出安全包长。 +# +# 这个脚本是 **MSS / 接口 MTU / 路径 MTU 探测** 的唯一出处。 +# deploy-tune.sh 会调它；不要在别处再设一遍 —— +# "到底哪个值生效" 一旦有两处来源就会变得很难查。 +# # ════════════════════════════════════════════════════════════════ # 证据链 # ════════════════════════════════════════════════════════════════ @@ -17,63 +21,148 @@ # ════════════════════════════════════════════════════════════════ # 不夹 MSS（1500） 87% # MSS 1300 100% -# MSS 1360 100% -# MSS 1400 100% <- 采用（离路径上限还有余量） +# MSS 1360 100% <- 采用（和 MTU 1400 配套） +# MSS 1400 100% # MSS 1440 100% # -# 15 分钟长测（180 次）：见安装日志 +# ════════════════════════════════════════════════════════════════ +# 为什么接口 MTU 也要压到 1400（早期结论是错的，这里更正） +# ════════════════════════════════════════════════════════════════ +# 早先这里写的是「不要改接口 MTU，实测降到 1400 反而掉到 50%」。 +# 那个结论只考虑了 TCP，**漏掉了 QUIC**： # -# ════════════════════════════════════════════════════════════════ -# 注意：**不要改接口 MTU** -# ════════════════════════════════════════════════════════════════ -# 把 wlan0 的 MTU 降到 1400 反而掉到 50% —— -# 链路本身能过 1448 的包，压小接口 MTU 是过度限制， -# 包变小、来回变多，命中丢包窗口的概率反而更高。 -# MSS 只限制 TCP 段，不动链路层，更精准。 +# * MSS 钳制走的是 iptables 的 TCPMSS 目标，**只对 TCP 生效**； +# * 隧道用 QUIC 时跑在 UDP 上，整套 TCPMSS 规则对它毫无作用。 +# +# QUIC 的包一旦超过路径 MTU 就会被中间设备丢掉，而 UDP 丢包 +# 不会回 ICMP，客户端只能干等到握手超时 —— cloudflared 日志里就是 +# "failed to dial to edge with quic: timeout: no recent network activity" +# +# 把 wlan0 MTU 从 1500 降到 1400 之后（实测）： +# 建齐 6 条 QUIC 连接 28 秒 -> 13 秒 +# 建齐 10 条 QUIC 连接 28 秒 -> 12 秒 +# 建连期间 dial 失败 2 次 -> 1 次 +# +# 【重要】MTU 和 MSS 必须配套： +# MTU 1400 => TCP 段最大 1360（1400 - 20 IP头 - 20 TCP头） +# 如果 MTU 压到 1400 却还把 MSS 设成 1400， +# TCP 段(1440) 就超过接口 MTU(1400)，包在本地就被分片，等于白改。 +# 两个值在本脚本里一起设，改一个必须改另一个。 set -u -MSS_VALUE=${MSS_VALUE:-1400} +MSS_VALUE=${MSS_VALUE:-1360} +MTU_VALUE=${MTU_VALUE:-1400} + +# ──────────────────────────────────────────────────────────────── +# 找对外的那张网卡 +# ──────────────────────────────────────────────────────────────── +# 以前这里写死 wlan0。写死的问题是换机器（或者用 usb0 上网）就错了， +# 而 MTU 设错网卡是没有任何提示的 —— 改了等于没改。 +IFACE=${IFACE:-} +if [ -z "$IFACE" ] && command -v ip >/dev/null 2>&1; then + IFACE=$(ip -4 route show default 2>/dev/null \ + | awk '{for(i=1;i<=NF;i++) if($i=="dev") print $(i+1)}' \ + | head -1) +fi +if [ -z "$IFACE" ]; then + for cand in /sys/class/net/*; do + name=$(basename "$cand") + case "$name" in lo|pan0|docker*|veth*|br-*) continue ;; esac + [ -r "$cand/operstate" ] || continue + [ "$(cat "$cand/operstate" 2>/dev/null)" = "up" ] || continue + IFACE="$name" + break + done +fi +[ -z "$IFACE" ] && IFACE=wlan0 echo " 1) 打开路径 MTU 探测" -sysctl -w net.ipv4.tcp_mtu_probing=1 >/dev/null -echo " tcp_mtu_probing = $(cat /proc/sys/net/ipv4/tcp_mtu_probing)" +if [ -w /proc/sys/net/ipv4/tcp_mtu_probing ]; then + sysctl -w net.ipv4.tcp_mtu_probing=1 >/dev/null + echo " tcp_mtu_probing = $(cat /proc/sys/net/ipv4/tcp_mtu_probing)" +else + echo " [跳过] 读不到 /proc（不是 Linux 环境）" +fi echo " 2) 夹 MSS 到 $MSS_VALUE（只限制 TCP 段，不改链路层）" -for chain in OUTPUT POSTROUTING; do - # 先清掉所有旧值，避免重启后越积越多 - for old in 1300 1360 1400 1440; do - while iptables -t mangle -C "$chain" -p tcp --tcp-flags SYN,RST SYN \ - -j TCPMSS --set-mss "$old" 2>/dev/null; do - iptables -t mangle -D "$chain" -p tcp --tcp-flags SYN,RST SYN \ - -j TCPMSS --set-mss "$old" 2>/dev/null || break +if command -v iptables >/dev/null 2>&1; then + for chain in OUTPUT POSTROUTING; do + # 先清掉所有旧值，避免重启后越积越多。 + # ⚠ 这个 while 必须有次数上限： + # 正常情况下 -D 删掉之后 -C 就返回非 0，循环自然结束。 + # 但如果哪天 -D 报成功而规则还在（被包了一层、或 iptables 出异常）， + # 原写法就是死循环，把整个部署卡死。 + # 实测踩过：桩命令一律返回 0，脚本真的转不出来了。 + for old in 1300 1360 1400 1440 1460; do + guard=0 + while iptables -t mangle -C "$chain" -p tcp --tcp-flags SYN,RST SYN \ + -j TCPMSS --set-mss "$old" 2>/dev/null; do + guard=$((guard + 1)) + if [ "$guard" -gt 10 ]; then + echo " ⚠ 清理旧 MSS 规则($old) 超过 10 次仍报存在，停手" + break + fi + iptables -t mangle -D "$chain" -p tcp --tcp-flags SYN,RST SYN \ + -j TCPMSS --set-mss "$old" 2>/dev/null || break + done done + iptables -t mangle -A "$chain" -p tcp --tcp-flags SYN,RST SYN \ + -j TCPMSS --set-mss "$MSS_VALUE" 2>/dev/null done - iptables -t mangle -A "$chain" -p tcp --tcp-flags SYN,RST SYN \ - -j TCPMSS --set-mss "$MSS_VALUE" 2>/dev/null -done -iptables -t mangle -L -n 2>/dev/null | grep -i mss | sed 's/^/ /' + iptables -t mangle -L -n 2>/dev/null | grep -i mss | sed 's/^/ /' +else + echo " [跳过] 没有 iptables" +fi -echo " 3) 接口 MTU 保持 1500（实测降到 1400 反而掉到 50%）" -ip link set dev wlan0 mtu 1500 2>/dev/null || true -echo " wlan0 mtu = $(cat /sys/class/net/wlan0/mtu 2>/dev/null)" +echo " 3) 接口 MTU -> $MTU_VALUE（这一条是给 QUIC 用的，见文件头说明）" +if command -v ip >/dev/null 2>&1; then + CUR=$(cat "/sys/class/net/$IFACE/mtu" 2>/dev/null || echo "?") + if [ "$CUR" = "$MTU_VALUE" ]; then + echo " $IFACE 已经是 $MTU_VALUE，不用改" + elif ip link set dev "$IFACE" mtu "$MTU_VALUE" 2>/dev/null; then + echo " $IFACE 的 MTU: $CUR -> $(cat "/sys/class/net/$IFACE/mtu" 2>/dev/null)" + else + echo " ⚠ 改 $IFACE 的 MTU 失败（权限或网卡不支持），继续" + fi +else + echo " [跳过] 没有 ip 命令" +fi + +# 持久化：wlan0 归 NetworkManager 管，光用 ip 改重启就丢。 +# 写进 NM 自己的连接配置，比塞 rc.local 干净。 +if command -v nmcli >/dev/null 2>&1; then + CONN=$(nmcli -t -f NAME,DEVICE connection show --active 2>/dev/null \ + | awk -F: -v dev="$IFACE" '$2==dev {print $1; exit}') + if [ -n "$CONN" ]; then + nmcli connection modify "$CONN" 802-11-wireless.mtu "$MTU_VALUE" \ + 2>/dev/null \ + || nmcli connection modify "$CONN" ethernet.mtu "$MTU_VALUE" \ + 2>/dev/null || true + echo " 已写进 NetworkManager 连接「$CONN」（重启后仍然生效）" + fi +fi # ════════════════════════════════════════════════════════════════ # 4) 关键：让已经在跑的隧道重建连接 # ════════════════════════════════════════════════════════════════ -# MSS 夹取只对**新建连接**生效（它改的是 SYN 包里的 MSS 选项）。 -# 隧道如果是在规则生效之前建的，它那条 TCP 连接还用着旧 MSS —— +# MSS 和 MTU 只对**新建连接**生效（MSS 改的是 SYN 包里的选项， +# MTU 影响的是新建的 socket）。隧道如果建在规则生效之前， +# 它那条连接还带着旧参数 —— # 实测：隧道 17:01 建、规则 17:22 生效，可用率一直卡在 76%； # 重启隧道之后立刻回到 100%。 # -# 开机时不会走到这一步（本服务 Before=lanremote-tunnel.service， -# 规则先于隧道生效）；但**手动重跑本脚本**时需要重建， +# 开机时不会走到这一步（nettune 服务 Before=lanremote-tunnel.service， +# 规则先于隧道生效）；但**手动重跑本脚本**时必须重建， # 否则改了等于没改。 -if systemctl is-active --quiet lanremote-tunnel 2>/dev/null; then - echo " 4) 隧道正在运行，它用的是旧 MSS —— 重启让它重建连接" - systemctl restart lanremote-tunnel - echo " 已重启（新连接会用上 MSS=$MSS_VALUE）" -else - echo " 4) 隧道未运行，跳过重建（开机时本服务先于它执行）" -fi +echo " 4) 让已经建立的隧道用上新参数" +RESTARTED=0 +for svc in lanremote-tunnel lanremote-tunnel-h2; do + if command -v systemctl >/dev/null 2>&1 \ + && systemctl is-active --quiet "$svc" 2>/dev/null; then + echo " $svc 正在跑，重启它让新参数生效" + systemctl restart "$svc" >/dev/null 2>&1 && RESTARTED=1 + fi +done +[ "$RESTARTED" = "0" ] && echo " 没有正在跑的隧道，跳过" -echo " 网络调优已应用（MSS=$MSS_VALUE）" +echo " 网络调优已应用（MSS=$MSS_VALUE, MTU=$MTU_VALUE, 网卡=$IFACE）"