Source: https://swgbar.com/zh-CN/guides/troubleshoot-swg-bypass-recovering-paused-macos/
Language: zh-CN

# 排查 Mac 上 SWG 绕过的“恢复中”“已暂停”与连接错误

排查 SWG bar 2.4.12 中的绕过中、恢复中与已暂停状态：检查 macOS 系统扩展授权与网络过滤授权、硬件网卡 IPv4 网关及 HTTP/3 回退。

SWG bar · 更新日期 2026年11月18日

在 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` 系统扩展与网络过滤/代理配置），在不修改全局系统代理设置的前提下将指定主机名路由至物理网卡直连：

1.  检查 **macOS 系统设置 → 隐私与安全性**（以及**网络 → 过滤器**），确保已完成 SWGBar 的**系统扩展授权**与**网络过滤授权**。如果在首次授权时 macOS 提示需要重启电脑，请先完成重启。
2.  在**设置 → 试用与激活**中确认拥有有效的 14 个使用日免费试用或付费许可证。
3.  保持 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 检查对比](<https://swgbar.com/zh-CN/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)。
*   **浏览器 HTTP/3（QUIC）与长连接复用**：Chrome 及其他浏览器可能会沿用开启绕过之前建立的 HTTP/3 UDP 流或复用 TLS 套接字池。SWG bar 的原生绕过会在新连接上将 HTTP/3 回退为基于 TCP 的 HTTPS，因此看到**绕过中**后，请刷新页面或重启浏览器/CLI 工具。

## 通过 CLI 清理或验证规则

如果规则卡在异常状态，或在关闭绕过时出现内联报错，请保持 SWG bar 运行，并在终端中使用 [CLI](<https://swgbar.com/zh-CN/cli/>) 检查或清理规则：

```
swgbar bypass status
swgbar bypass disable <domain>
swgbar bypass clear
swgbar probe <domain>
```

如果应用报告恢复错误，切勿默认规则已经被移除——请保持 SWG bar 运行直到 `swgbar bypass status` 确认规则已清除，或查阅[如何在 Mac 上绕过 SWG](<https://swgbar.com/zh-CN/guides/how-to-bypass-swg/>)了解完整生命周期行为。

## 继续阅读

*   [如何在 Mac 上绕过 SWG（单域名一键绕过与 CLI 命令）](<https://swgbar.com/zh-CN/guides/how-to-bypass-swg/>)
*   [如何在 Mac 上绕过 SSL 检查（企业 SWG 单域名绕过指南）](<https://swgbar.com/zh-CN/guides/bypass-ssl-inspection-mac/>)
*   [如何在 macOS 上绕过 HTTPS 与 TLS 检查（Break-and-Inspect 指南）](<https://swgbar.com/zh-CN/guides/bypass-https-tls-inspection-mac/>)
*   [如何在 Mac 上绕过企业代理与 SWG SSL 检查](<https://swgbar.com/zh-CN/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [如何判断我的电脑是否被 SWG 劫持（Mac 上检测 HTTPS/SSL 检查）](<https://swgbar.com/zh-CN/guides/detect-https-inspection/>)
*   [如何检查公司或办公 Mac 是否正在拦截 HTTPS（SSL 检查排查）](<https://swgbar.com/zh-CN/guides/check-if-work-mac-intercepting-https/>)
*   [Mac SSL 检查检测工具：菜单栏实时侦测 HTTPS 拦截](<https://swgbar.com/zh-CN/guides/ssl-inspection-checker-mac/>)
*   [Mac 上的 Zscaler SSL 检查：如何检测并按域名绕过](<https://swgbar.com/zh-CN/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Netskope SSL 检查：检测解密与单域名绕过指南](<https://swgbar.com/zh-CN/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Cloudflare WARP 与 Zero Trust TLS 检查：检测与绕过](<https://swgbar.com/zh-CN/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar 中的“已确认”与“疑似”HTTPS 检查状态解析](<https://swgbar.com/zh-CN/guides/confirmed-vs-suspected-https-inspection/>)
*   [在 SWG bar 中检查中间人根证书与签发机构](<https://swgbar.com/zh-CN/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac 上的企业 SWG 与 MDM HTTPS 解密检查解析](<https://swgbar.com/zh-CN/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 绕过与 TLS 解密例外（Break-and-Inspect）对比](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)
*   [在 Mac 上为多域名 Web 应用、SSO、CDN 与 API 配置 SWG 绕过](<https://swgbar.com/zh-CN/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [macOS VPN 虚拟网卡与 SWG HTTPS 检查对比](<https://swgbar.com/zh-CN/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [为什么证书固定（Pinning）应用与 mTLS 在 SWG 检查下会失效](<https://swgbar.com/zh-CN/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [修复 Mac 终端 CLI 与 AI 工具中的 SWG TLS/SSL 证书错误](<https://swgbar.com/zh-CN/guides/swg-tls-certificate-errors-macos/>)
*   [Mac 在 SWG 下的 Homebrew、Docker、Python 与 Node.js CA 信任配置](<https://swgbar.com/zh-CN/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [修复 Mac 上 Claude Code 与 Cursor 的 'unable to get local issuer certificate' 报错（SWG 与 MCP）](<https://swgbar.com/zh-CN/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [在 Mac 上使用 openssl 与 security verify-cert 验证 TLS 证书](<https://swgbar.com/zh-CN/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 权限、本地隐私与 TLS 探测限额说明](<https://swgbar.com/zh-CN/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar 如何检查 HTTPS 解密](<https://swgbar.com/zh-CN/how-it-works/>)
*   [下载并安装 Mac 版 SWG bar（macOS 14+）](<https://swgbar.com/zh-CN/install/>)
*   [检测 SSL 与 HTTPS 检查的 Chrome 扩展（SWG bar 配套插件）](<https://swgbar.com/zh-CN/chrome-extension/>)
*   [SWG bar CLI 使用指南](<https://swgbar.com/zh-CN/cli/>)
*   [SWG bar MCP 使用指南](<https://swgbar.com/zh-CN/mcp/>)
*   [SWG bar 版本信息](<https://swgbar.com/zh-CN/releases/>)
*   [关于 SWG bar](<https://swgbar.com/zh-CN/about/>)
