排查 Mac 上 SWG 绕过的“恢复中”“已暂停”与连接错误
排查 SWG bar 2.4.12 中的绕过中、恢复中与已暂停状态:检查 macOS 系统扩展授权与网络过滤授权、硬件网卡 IPv4 网关及 HTTP/3 回退。
SWG bar · 更新日期
在 SWG bar 2.4.12 中为某个域名开启绕过 SWG后,状态行会在绕过中、恢复中或已暂停等状态之间流转。了解每个状态背后的检查条件与所需网络前提,能让你快速解决绕过异常,避免残留无效规则。
理解“绕过中”“恢复中”与“已暂停”
| 状态 | 含义 | 优先检查项 |
|---|---|---|
| 绕过中 | 在 SWG bar 保持运行期间,原生网络扩展规则已对该主机名的新建连接生效。 | 查看下方的校验提示:如果出现“尚未观测到通过原生扩展建立的连接”(No connection through the native extension has been observed yet),请刷新页面或重启发起请求的应用程序。 |
| 恢复中 | SWG bar 正在重新应用已保存的域名规则,或等待本地网络扩展工作进程就绪。 | 稍等数秒,在设置 → 试用与激活中确认试用或许可证处于有效状态,并保持 SWG bar 运行。 |
| 已暂停 | 绕过未生效——通常发生在退出 SWG bar 后、试用/许可证过期,或网络扩展/网络路径报错时。 | 在系统设置中批准待处理的 macOS 系统扩展提示,检查物理网络连接,并查看控件旁显示的内联错误信息。 |
检查 macOS 系统扩展与许可证要求
SWG bar 通过经过签名的 macOS 网络扩展(SWGBar 系统扩展与网络过滤/代理配置),在不修改全局系统代理设置的前提下将指定主机名路由至物理网卡直连:
- 检查 macOS 系统设置 → 隐私与安全性(以及网络 → 过滤器),确保已完成 SWGBar 的系统扩展授权与网络过滤授权。如果在首次授权时 macOS 提示需要重启电脑,请先完成重启。
- 在设置 → 试用与激活中确认拥有有效的 14 个使用日免费试用或付费许可证。
- 保持 SWG bar 在菜单栏中运行——一旦退出应用,当前生效的绕过会立即停止,已保存的规则会切换为已暂停,直到下次重新打开应用。
检查硬件网卡 IPv4 出口与 HTTP/3 回退
SWG bar 2.4.12 的单域名绕过需要通过已连接的物理网络接口(硬件网卡)配合可用的 IPv4 网关(例如内置 Wi-Fi 或有线以太网)建立连接。以下两种常见网络行为可以解释绝大多数验证告警:
- VPN 或纯虚拟通道出口:如果 Mac 将所有出站路由强制限定在仅通过
虚拟网卡VPN 隧道转发,且没有可达的物理 IPv4 路径,绕过验证可能会失败并提示“未找到带有 IPv4 网关的已连接物理接口”(No connected physical interface with an IPv4 gateway)。请参阅 macOS VPN 虚拟网卡与 SWG 检查对比。 - 浏览器 HTTP/3(QUIC)与长连接复用:Chrome 及其他浏览器可能会沿用开启绕过之前建立的 HTTP/3 UDP 流或复用 TLS 套接字池。SWG bar 的原生绕过会在新连接上将 HTTP/3 回退为基于 TCP 的 HTTPS,因此看到绕过中后,请刷新页面或重启浏览器/CLI 工具。
通过 CLI 清理或验证规则
如果规则卡在异常状态,或在关闭绕过时出现内联报错,请保持 SWG bar 运行,并在终端中使用 CLI 检查或清理规则:
swgbar bypass status
swgbar bypass disable <domain>
swgbar bypass clear
swgbar probe <domain>
如果应用报告恢复错误,切勿默认规则已经被移除——请保持 SWG bar 运行直到 swgbar bypass status 确认规则已清除,或查阅如何在 Mac 上绕过 SWG了解完整生命周期行为。