VOHIVE / ARM64 / UTM

从“能编译”到
能稳定运行

最终采用 Apple Silicon 主机 + UTM + Ubuntu ARM64 + VoHive + SOCKS5 系统代理的组合，优先保证边界清晰和可验证。

隐私处理
本文已移除账号、邮箱、密码、SSH 密钥、虚拟机 UUID、精确内网地址、机器路径、令牌和日志原文。所有连接信息均使用占位符。

构建与部署步骤

  1. 准备 Ubuntu Server ARM64 虚拟机，使用 Shared Network，先不要桥接物理网卡。
  2. 固定源码版本和本地替换依赖，确保凭据文件、私钥、cloud-init seed 与运行日志不在项目中。
  3. 使用 CGO_ENABLED=0 GOOS=linux GOARCH=arm64 构建，并用 file、sha256sum、go version -m 验证产物。
  4. 通过安全通道传输到目标机临时目录：scp dist/vohive_linux_arm64 <user>@<device-host>:/tmp/vohive。
  5. 在目标机安装为 systemd 服务，启用开机启动，确认管理页返回 HTTP 200。
  6. 先验证虚拟机本机出口，再验证 SOCKS5 代理出口，最后接入 USB 蜂窝模块。
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -trimpath -buildvcs=false -tags "with_utls nomsgpack" -ldflags "-s -w" -o dist/vohive_linux_arm64 ./cmd/vohive
file dist/vohive_linux_arm64
sha256sum dist/vohive_linux_arm64

Bug 修复与避坑

Token 过期：QQ Bot 在特定 HTTP 错误和业务码 11244 下，旧实现会反复使用旧 Token。修复后将其归类为认证失效，清理旧 Token、重新获取并限制重试次数。

Email SSL/TLS 丢失：保存配置时遗漏 SSL 字段，重启后安全连接会恢复为关闭。修复配置持久化并增加回归测试后，重启可保持设置。

OpenWrt 启动顺序：Docker 可能早于代理服务启动，导致通知渠道初始化失败；用启动脚本等待代理端口就绪后再重启 VoHive。

代理边界：让 wwan0 的本机流量绕过策略路由，避免公网出口探测被 PassWall 改写；旁路由 IPv6 也要单独确认，避免客户端绕过代理。

构建标签遗漏：修复版必须保留原有的 with_utls 与 nomsgpack 构建标签，否则可能出现启动后设备能力异常。

上线前检查

  • uname -m 返回 aarch64，二进制为静态 ARM64 ELF。
  • 服务为 active，管理端口返回 200。
  • QMI / wwan0、QQ Bot 命令监听、Email 和代理出口完成基础验证。
  • 保留当前版本和回滚校验值，不要在新版本验证前覆盖。
  • 不要把管理端口暴露到公网，关闭 root 直接登录。

能复现的部署，才是值得交付的部署。