如何在 macOS 上绕过 HTTPS 与 TLS 检查(Break-and-Inspect 指南)
在 macOS 上使用 SWG bar 按域名绕过 HTTPS 与 TLS Break-and-Inspect 解密检查:解析 TLS 终止为何破坏 HTTP/2、QUIC 与证书固定,以及 CLI 验证方法。
SWG bar · 更新日期
要在 macOS 上为特定域名绕过 HTTPS 或 TLS 检查(Break-and-Inspect 解密重签)且不全局停用企业安全客户端,请打开 SWG bar → 域名,选择目标主机名并开启绕过 SWG(或运行 swgbar bypass enable <domain>)。等待该行显示绕过中后,重启浏览器标签页、IDE 或终端会话,使新的 TLS 握手通过 Mac 的物理硬件网卡 IPv4 接口建立。
企业安全 Web 网关(SWG)与下一代防火墙在执行 HTTPS 检查时,会充当受信任的中间人:先终止 Mac 发起的出站 TLS 1.2/1.3 握手,解密并审查 HTTP 负载,再向源站重新加密转发。虽然浏览器会自动接受通过 MDM 安装的网关根证书,但现代传输协议和严格校验的开发者客户端在 TLS 重签下经常出现故障。
HTTPS / TLS 解密重签在 Mac 上究竟会破坏什么
即便你的 Mac 钥匙串已经信任企业根证书,在线 TLS 终止仍常常导致以下四类 macOS 常见工作流异常:
- 证书固定与双向 TLS(mTLS):一旦网关替换为自己的终端站点证书,绑定源站公钥(Certificate Pinning)或要求提供客户端证书的应用程序会立即中止握手。详见证书固定与 mTLS 在 SWG 解密检查下为何失效。
- HTTP/3(QUIC)以及长连接 HTTP/2 / WebSocket 流:对 TLS 进行降级或代理的网关经常会丢弃 UDP QUIC 流、导致大模型流式响应卡顿,或重置持久化的 IDE 与 WebSocket 通道。
- 独立的 CLI 与编程语言 CA 证书库:
Node.js、Python、Git、Homebrew、Docker、Claude Code和Cursor等运行时自带独立的根证书库,因此容易报CERTIFICATE_VERIFY_FAILED或UNABLE_TO_GET_ISSUER_CERT_LOCALLY。 - 对延迟敏感的开发 API:将每一次 TLS 握手都回源到远端云 SWG 接入点(PoP),会显著增加依赖安装、
git fetch以及实时代码补全的往返延迟。
单域名 TLS 绕过、本机代理设置与网关例外对比
| 对比维度 | 单域名绕过(SWG bar) |
管理员 TLS 检查例外(Do Not Decrypt) |
本机代理修改(系统设置 → 代理) |
|---|---|---|---|
| 生效层级 | 依托 macOS NetworkExtension 的主机名级物理 IPv4 路由 | 集中式 SWG / 防火墙解密策略 | 仅限系统显式 HTTP/HTTPS 代理字段 |
| 对透明 SWG 是否有效? | 有效(前提是具备可达的物理 IPv4 路径) | 有效(由 IT 管理员配置) | 无效——会被 utun 或透明 SWG 客户端忽略或覆盖 |
| 是否需要 IT 管理后台? | 不需要(在获授权 Mac 上本地控制) | 需要(Zscaler、Netskope、Cloudflare、Palo Alto 管理控制台) | 不需要 |
| 是否保留设备合规与 SSO? | 是——企业终端客户端保持正常运行 | 是 | 经常会破坏企业 PAC 路由 |
如需深入比较路由变更与网关解密例外的架构差异,请参阅SWG 绕过与 TLS 解密例外对比。
在 macOS 上为指定域名绕过 HTTPS 与 TLS 检查
- 识别所有受检主机名:打开 SWG bar → 域名,或通过 CLI 运行
swgbar domains list --status confirmed。请注意,example.com、auth.example.com和api.example.com是彼此独立的主机名。 - 开启单域名绕过:在目标域名的绕过 SWG一行点击开启,或运行:
swgbar bypass enable api.example.com
swgbar bypass status
- 关闭复用的 TLS 与 HTTP/3 连接:仅刷新单个浏览器标签页可能会继续复用旧受检路径上的 HTTP/2 或 QUIC 连接池。SWG bar 的原生绕过会在新建连接时将 HTTP/3 回落到基于 TCP 的 HTTPS,因此请在显示绕过中后重新加载标签页,或彻底退出并重新打开目标应用。
- 验证全新的证书链:运行
swgbar probe api.example.com(或执行openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null),核实当前返回的已是源站服务器的公共签发机构。
如果状态显示为恢复中或已暂停而非绕过中,请查阅排查 macOS 上“恢复中”与“已暂停”的 SWG 绕过状态。
按需关闭绕过或改用 CA 信任方案
再次点击已启用的绕过 SWG控件——或运行 swgbar bypass disable <domain>——即可立即让该主机名恢复正常网关路由。退出 SWG bar 也会立刻停止当前生效的绕过,但会保留你保存的主机名选择,待下次启动时自动恢复。
如果所在网络在防火墙层面禁止直接出站 IPv4 流量,请关闭绕过,改用 CLI 与 AI 工具 CA 证书信任修复指南,或请管理员针对确切主机名添加 Do Not Decrypt 例外规则。