probe: add native OpenWrt deployment and signed automatic updates [CI]

2026-10-20 14:15:01 +08:00
1 parent 24ba05fbb6
commit cd193378a6
@@ -173,6 +173,24 @@ Linux 上比 Windows 大，是因为 .NET 的加密、压缩、网络本机库

 ### OpenWrt（`packaging/openwrt/`）

+#### 原生一键安装与自动更新
+
+管理端「添加 Probe」提供 **OpenWrt · 原生二进制** 命令，以 root 执行。支持 ARM64/aarch64 和 x86_64，不需要容器或 .NET；自动安装依赖、验签下载、固定属主并注册、配置 procd。身份在 `/etc/moshiro/`，更新策略在 `/etc/moshiro-native.conf`（`CHANNEL=dev|release`、`POLICY=auto|manual`、`INTERVAL=30`）。动态 musl 正式包仍需 `libopenssl3`，实际设备兼容性需实机验证。
+
+带 `[CI]` 的 main push 发布 dev，稳定 tag 发布 release，沿用 `gitea_token` 和 `release_signing_key`；Gitea generic package `moshiro-openwrt` 需允许匿名下载。制品发布后，在线节点收到通知就唤醒更新器，另有 30 秒轮询兜底，不等待 10 分钟。更新器验签、防重放、原子切换完整版本，健康检查失败回滚；Probe 本身不下载、不执行命令。
+
+```sh
+logread -e moshiro
+/etc/init.d/moshiro-probe status
+/etc/init.d/moshiro-probe-update status
+/usr/libexec/moshiro-openwrt check       # 立即检查；auto 策略下有新版就安装
+cat /var/run/moshiro-update/status.json
+```
+
+默认测量上限 20 Mbps/2000 pps，可修改 `probe.json`。sysupgrade 保留身份和更新配置，升级固件后重新校验安装脚本并执行 `install` 恢复程序，不需新加入码；旧部署需要人工迁移，不覆盖现有身份。首次安装没有旧版可回滚。发布公钥轮换需 root 手动更新本机公钥。隔离测试：`python3 scripts/test-openwrt-updater.py`。
+
+#### 旧的解压包安装方式
+
 只支持 Probe（Agent 面向服务器）。`install.sh probe` 安装 `/etc/init.d/moshiro-probe`（procd，崩溃自动重启，日志进 logd）并写入 `/lib/upgrade/keep.d/moshiro`，sysupgrade 时保留 `/etc/moshiro/`。

 OpenWrt 默认不带 OpenSSL：`opkg install libopenssl3`（较新的快照和 24.10 之后用 `apk add libopenssl3`）。安装包会把 MsQuic、NUMA 和相关共享库放到 `/usr/lib/moshiro`，procd 会设置 `LD_LIBRARY_PATH`；OpenSSL 3 仍由系统提供。闪存很小时注意：Probe 二进制约 7.7 MB，配置只在 Agent 列表变化时才写。路由器上建议把 `probe.json` 的 `limits.max_test_mbps` 调低。