服务端 zip 加一键部署脚本(cloudflared 安装 + 部署 + 公网,全自动)

用户要求:服务器端文件里放一个 .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
+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
- 修**局域网连接被中转劫持**(重要):
+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())
+96 -48
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,可改)
官网: <公网地址>/
管理页: <公网地址>/?key=<lanremote-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
+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())
+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/^/ /'
+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
+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