如何在 Mac 上绕过企业代理与 SWG SSL 检查
解析为何在 macOS 上关闭系统设置代理或执行 networksetup 无法绕过透明 SWG 代理,并说明如何按域名绕过或修复 CLI 证书错误。
SWG bar · 更新日期
如果在系统设置 → 网络 → 代理中关闭 Wi-Fi 代理开关——或使用 networksetup -setproxybypassdomains 添加豁免域名——后,你的 Mac 仍然处于企业代理 SSL 检查之下,说明设备运行的是透明安全 Web 网关(SWG)客户端(基于 NetworkExtension 或 utun 隧道),而非简单的显式 HTTP 代理。要在获授权的 Mac 上为特定主机名绕过 SWG 检查,请打开 SWG bar → 域名,选择目标主机名并开启绕过 SWG(或运行 swgbar bypass enable <domain>)。
大多数 macOS 代理教程将两种截然不同的企业网络架构混为一谈:传统的显式代理 / PAC 文件,以及现代的透明 SWG 客户端(例如 Cisco Umbrella / Cisco Secure Client、Broadcom Cloud SWG、Zscaler、Netskope 或 Cloudflare Gateway)。分清你的 Mac 属于哪一种架构,就能立刻明白为什么常规代理设置不起作用,以及哪种解决方案才能真正生效。
1. 检查你的 Mac 使用的是显式代理还是透明 SWG
通过以下两项快速检查,确认 macOS 当前是如何牵引流量的:
- 检查系统显式代理配置:
scutil --proxy
留意输出中是否包含 HTTPEnable : 1、HTTPSEnable : 1 或 ProxyAutoConfigURLString(指向 .pac 的 URL)。2. 检查实际的 HTTPS 证书拦截情况:打开 SWG bar → 概览(或运行 swgbar overview / swgbar domains list --status confirmed)。
- 如果
scutil --proxy输出为空,但 SWG bar 显示域名劫持占比 >0%(并且列出已确认或疑似域名以及中间人证书),说明你的 Mac 位于透明 SWG 客户端(NetworkExtension/utun)之后,它在 macOS 系统代理设置之下直接捕获数据包。 - 如果
scutil --proxy列出了企业代理或 PAC 地址,且 SWG bar 同时显示企业中间人根证书,说明流量经由显式/PAC 拦截代理转发。
2. macOS 上的显式代理与透明 SWG 代理对比
| 架构类型 | macOS 拦截流量的位置 | 系统设置 → 代理 / networksetup 能否绕过? |
在获授权 Mac 上真正有效的方案 |
|---|---|---|---|
| 显式 HTTP/HTTPS 或 PAC 代理(非受管) | macOS 系统配置代理字段 | 可以(前提是未被 MDM 锁定“忽略这些主机与域的代理设置”) | macOS 代理绕过列表,或按域名路由核验 |
MDM 锁定的显式代理或透明 SWG(NetworkExtension / utun) |
位于浏览器代理开关之下的内核 / NetworkExtension 套接字与 IP 过滤层 | 不能——设置会被锁定、自动覆盖,或被 SWG 隧道完全无视 | 使用 SWG bar 按域名走物理硬件网卡 IPv4 绕过(详见如何在 Mac 上绕过 SWG)、IT 网关的 External Domains / Do Not Decrypt 例外,或配置 CLI CA 证书包 |
3. 在 macOS 上为特定域名绕过 SWG 代理 SSL 检查
当某个 Web 应用、API 端点或启用证书固定的桌面客户端在企业 SWG 代理后无法正常工作,且你管理该网络或已获授权进行配置时:
- 安装并打开 SWG bar(macOS 14+,Apple 芯片,提供 14 个使用日免费试用),重现一次请求,让准确的主机名出现在域名列表中。
- 打开该主机名的详情页,在绕过 SWG一行点击开启——或在终端运行:
swgbar bypass enable <domain>
swgbar bypass status
- 等待状态变为绕过中,随后刷新网页或重启终端/桌面客户端,使已有 Keep-Alive 套接字通过 Mac 的物理
硬件网卡IPv4 接口(en0/en7)重新建立连接。 - 运行
swgbar probe <domain>确认已正常返回源站的公共证书链。请注意:如果某个应用自行硬编码了显式代理配置(例如在~/.zshrc、~/.npmrc或~/.gitconfig中设置了HTTP_PROXY/HTTPS_PROXY),需要针对该主机取消这些代理变量,避免应用仍强制将流量发往显式代理端口。
4. 无法绕过代理时:IT 例外与 CLI CA 证书包
如果企业防火墙采用默认拒绝(Fail-Closed)边界策略,阻断所有未经过 SWG 代理的直接 IPv4 出站流量:
- 关闭单域名绕过(
swgbar bypass disable <domain>),让该主机名立即恢复正常代理路由。 - 为 CLI 工具配置企业代理 CA 信任:将
git、curl、npm、Python、Homebrew、Claude Code和Cursor指向导出的企业 CA PEM 文件(SSL_CERT_FILE、NODE_EXTRA_CA_CERTS、REQUESTS_CA_BUNDLE、git http.sslCAInfo),而不要不安全地关闭 SSL 验证。详见修复 Mac 终端 CLI 与 AI 工具中的 SWG TLS/SSL 证书错误。 - 申请 IT 网关绕过或解密例外:将出错的准确主机名(含登录页与 CDN 域名)以及 SWG bar 提供的证书证据提交给 IT,由其在集中策略中添加 Do Not Decrypt 或 External Domains List 规则。两层方案的对比请阅读SWG 绕过与 TLS 解密例外对比。