下载正确的未签名安装包

Apple Silicon 选择 arm64，Intel Mac 选择 x86_64。一起下载同一 GitHub Release 的 SHA256SUMS，并在安装前核对文件。

正式发布由 GitHub Actions 构建并提供 provenance，但当前 PKG 没有 Developer ID 签名或 notarization。若 Gatekeeper 阻止，请只对该安装包使用“系统设置 → 隐私与安全性 → 仍要打开”，不要全局关闭 Gatekeeper。

在网关停止时配置

从菜单栏 App 打开本地 Web GUI，导入兼容的 mihomo 配置或订阅，检查网络模式。首次 IPv4 验收时建议保持实验性 IPv6 关闭，除非你专门测试它。

  • 从一台设备的旁路由模式开始。
  • 确认 Mac 的稳定 LAN 地址。
  • 登记测试设备的稳定 IPv4。
  • 应用配置后再明确启动网关。

验证客户端路径并干净停止

从下游设备确认网关、DNS、域名解析、HTTPS 与连接可见性。测试完成后从控制面停止 OpenSurge，并确认预期网络服务已经恢复。

FAQ

改变网络前常见的问题

公开安装包已经签名和公证了吗？

没有。当前公开 PKG 会明确标注 unsigned。请核对 SHA-256 与 GitHub 构建 provenance，再决定是否使用单个文件的 Gatekeeper 放行。

打开 App 会立刻启动网关吗？

不会。安装会启动本地 helper 和 control service，但网关保持停止，只有在控制面明确操作后才启动。