xmz7891/ykxmz
1
0
Fork 0
mirror of https://gitee.com/xmz7891/ykxmz.git synced 2026-10-18 11:20:43 +00:00
Code Issues Packages Projects Releases Wiki Activity

服务端 zip 加一键部署脚本（cloudflared 安装 + 部署 + 公网，全自动）

Browse Source 
用户要求：服务器端文件里放一个 .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
This commit is contained in:
xmz7891
2026-10-07 17:28:09 +08:00
parent d4f335b8f9
commit facb156aca
10 changed files with 2331 additions and 89 deletions
Download Patch File Download Diff File Expand all files Collapse all files
_build/CHANGELOG.md
+27
View File
@@ -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
- 修**局域网连接被中转劫持**（重要）：
_build/fix_sh_format.py
+82
View File
@@ -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())
_build/package_remote.py
+95 -47
View File
@@ -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=<lanremote-key 的输出>
管理页顶部也会大字显示"当前公网地址"。
管理密码：120830（存在 data/admin_password.txt，可改）
管理密码： 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
_build/patch_relay_readme.py
+204
View File
@@ -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=<lanremote-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())
_build/test_deploy_real.sh
+97
View File
@@ -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/^/ /'
_build/test_deploy_sh.sh
+494
View File
@@ -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 <<EOF
#!/bin/bash
exec "$REAL_PY" "\$@"
EOF
fi
export PATH="$STUB:$PATH"
echo " 沙箱: $TMP"
echo " 安装根: $SANDBOX"
echo " 桩命令: $(ls "$STUB" | tr '\n' ' ')"
# ════════════════════════════════════════════════════════════════
echo
echo "── 5. 第一次部署（--skip-tunnel，不碰隧道）──"
OUT1="$TMP/run1.log"
bash "$DEPLOY" --prefix "$SANDBOX" --skip-tunnel --port 8080 > "$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
_build/test_zip_deploy.sh
+221
View File
@@ -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 <<EOF
#!/bin/bash
exec "$REAL_PY" "\$@"
EOF
export PATH="$STUB:$PATH"
OUT="$TMP/run.log"
(cd "$SRV" && bash deploy.sh --prefix "$SANDBOX" --skip-tunnel) > "$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
relay/deploy-tune.sh
+149
View File
@@ -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 的输出）"
relay/deploy.sh
+831
View File
@@ -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 <<EOF
ykxmz 服务器端 · 一键部署 v$VERSION
用法:
bash deploy.sh [选项]
不带任何选项时：复用机器上已有的隧道凭据，全自动装好并启动。
选项:
--token TOKEN 用隧道 Token 部署（等价于环境变量 TUNNEL_TOKEN）
--hostname NAME 公网域名，例如 relay.example.com
不填则沿用 /root/.cloudflared/config.yml 里已有的
--tunnel-name NAME 具名隧道名字（默认 lanremote）
--protocol P 隧道协议：quic（默认）或 http2
quic 尾部延迟更好；http2 走 TCP、建连更稳
--port N 中转监听端口（默认 8080）
--downloads DIR 把 DIR 里的发布产物拷进下载目录（官网下载按钮用）
--skip-tunnel 只装中转，不碰隧道
--prefix DIR 安装根目录（默认 /）。测试或自定义安装位置时用
-h, --help 显示这段帮助
环境变量:
TUNNEL_TOKEN 和 --token 等价（推荐用这个，不留在 shell 历史里）
RELAY_PORT 和 --port 等价
例子:
bash deploy.sh # 全自动
TUNNEL_TOKEN=eyJh... bash deploy.sh # 用 Token
bash deploy.sh --hostname relay.mydomain.com # 换域名
bash deploy.sh --skip-tunnel # 只装中转
做完之后:
浏览器打开 https://<你的域名>/ —— 就是官网
查状态 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" <<EOF
[Unit]
Description=ykxmz 中转服务器
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
WorkingDirectory=$RELAY_DIR
Environment=RELAY_PORT=$PORT
Environment=RELAY_BIND=127.0.0.1
Environment=RELAY_DATA=$RELAY_DIR/data
# 长轮询挂多久。60 秒是实测调出来的：
# 隧道每次请求要多花 1~2 秒（边缘路由 + 回源），这个开销按**次数**收，
# 60 秒一循环把请求数降到 1/4，撞上丢包窗口的概率也降到 1/4。
# 不会让命令变慢 —— 有数据时立刻返回，不是等满 60 秒。
Environment=RELAY_POLL=60
Environment=RELAY_QUEUE_BYTES=2097152
ExecStart=/usr/bin/python3 $RELAY_DIR/relay.py
Restart=always
RestartSec=3
# 460MB 的小机器：限制住，别把系统拖死
MemoryMax=128M
CPUQuota=60%
StandardOutput=append:$RELAY_DIR/relay.log
StandardError=append:$RELAY_DIR/relay.log
[Install]
WantedBy=multi-user.target
EOF
# ---- 网络调优（开机先跑，排在 relay / tunnel 前面）----
cat > "$UNIT_DIR/lanremote-nettune.service" <<EOF
[Unit]
Description=ykxmz 网络调优（keepalive + MSS + MTU）
After=network-online.target
Wants=network-online.target
Before=lanremote-relay.service lanremote-tunnel.service lanremote-tunnel-h2.service
[Service]
Type=oneshot
RemainAfterExit=yes
# 只跑 deploy-tune.sh 这一个入口。
# 它会自己再去调 net-tune.sh（MSS / 接口 MTU / 路径探测的唯一出处）——
# 早先这里写了两条 ExecStart，两边都设一遍 MSS 和 MTU，
# 结果"到底哪个值生效"很难查。现在收成一个入口。
ExecStart=/bin/bash $RELAY_DIR/deploy-tune.sh
[Install]
WantedBy=multi-user.target
EOF
# ---- 隧道（主用：协议由 --protocol 决定）----
# 参数都是实测调出来的，改动前先看 deploy-tune.sh 顶部的说明：
# --edge-ip-version 4 这条线路有 IPv6 地址但实际不通，
# 边缘默认优先 IPv6 会一直超时
# --ha-connections 10 连接多 = 单条掉线影响小（实测 10 条时
# P99 从 13.7 秒降到 2.99 秒）
# --retries 5 连边缘失败时多重试
TUNNEL_COMMON="--no-autoupdate --edge-ip-version 4 --ha-connections 10 --retries 5"
if [ -n "$TOKEN" ]; then
# Token 模式：Token 存单独的 600 权限文件，不写进 unit
# （unit 文件是 644，任何人都能看）
TUNNEL_ARGS="--token \${TUNNEL_TOKEN}"
ENV_LINE="EnvironmentFile=-$CF_DIR/tunnel.env"
else
TUNNEL_ARGS="--config $CF_DIR/config.yml run $TUNNEL_NAME"
ENV_LINE=""
fi
write_tunnel_unit() {
local unit="$1" proto="$2"
# ⚠ 文件名必须带 .service 后缀。
# systemd 是按「<名字>.service」找文件的，
# `systemctl enable lanremote-tunnel` 找的是 lanremote-tunnel.service。
# 少这个后缀的话文件是写下去了，但 systemctl 完全看不见它 ——
# 而且不会有任何报错（enable 会安静地失败），非常难查。实测踩过。
cat > "$UNIT_DIR/$unit.service" <<EOF
[Unit]
Description=ykxmz Cloudflare 隧道（$proto）
After=network-online.target lanremote-relay.service
Wants=network-online.target
Requires=lanremote-relay.service
[Service]
Type=simple
$ENV_LINE
ExecStart=$CF_BIN tunnel $TUNNEL_COMMON --protocol $proto $TUNNEL_ARGS
Restart=always
RestartSec=5
MemoryMax=160M
StandardOutput=append:$RELAY_DIR/tunnel.log
StandardError=append:$RELAY_DIR/tunnel.log
[Install]
WantedBy=multi-user.target
EOF
}
# 装两份：一份主用、一份 HTTP/2 备用。
# 不自动同时启用 —— 两条隧道同时跑会互相争抢，实测反而更不稳。
# 需要切换时：
# systemctl disable --now lanremote-tunnel
# systemctl enable --now lanremote-tunnel-h2
write_tunnel_unit lanremote-tunnel "$PROTOCOL"
ALT_PROTO="http2"
[ "$PROTOCOL" = "http2" ] && ALT_PROTO="quic"
write_tunnel_unit lanremote-tunnel-h2 "$ALT_PROTO"
if command -v systemctl >/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" <<EOF
# ykxmz 中转 · Cloudflare 具名隧道配置
# 由 deploy.sh 生成。改完记得 systemctl restart lanremote-tunnel
tunnel: $TUNNEL_ID
credentials-file: $CRED
ingress:
- hostname: $HOST
service: http://127.0.0.1:$PORT
originRequest:
# 长轮询每个请求要挂 60 秒，回源超时必须给够，
# 否则边缘会在中转返回之前先掐断，表现就是 502。
connectTimeout: 30s
# 是流式响应，别缓冲
disableChunkedEncoding: false
# 兜底规则：不匹配上面任何 hostname 的请求一律 404。
# 这条**必须有**，否则 cloudflared 会拒绝启动。
- service: http_status:404
EOF
chmod 600 "$CF_DIR/config.yml"
say " 已写入 $CF_DIR/config.yml（域名 $HOST）"
else
say " 沿用已有 $CF_DIR/config.yml（域名 $HOST）"
fi
if [ "$HOST" != "$CUR_HOST" ] && [ -n "$HOSTNAME_ARG" ]; then
say " 提示：域名变了要同步改 DNS 指向："
say " $CF_BIN tunnel route dns $TUNNEL_NAME $HOST"
fi
TUNNEL_OK=1
PUBLIC_URL="https://$HOST"
fi
fi
fi
fi
# ════════════════════════════════════════════════════════════════
# 7/7 启动 + 自检
# ════════════════════════════════════════════════════════════════
step "7/7 启动并自检"
if command -v systemctl >/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" <<EOF
[Unit]
Description=ykxmz 隧道看门狗
After=lanremote-relay.service lanremote-tunnel.service
[Service]
Type=oneshot
ExecStart=/bin/bash $RELAY_DIR/watchdog.sh
MemoryMax=64M
StandardOutput=append:$RELAY_DIR/watchdog.log
StandardError=append:$RELAY_DIR/watchdog.log
EOF
cat > "$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
relay/net-tune.sh
+124 -35
View File
@@ -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
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 -L -n 2>/dev/null | grep -i mss | sed 's/^/ /'
done
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）"