如何在 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 常见工作流异常:

  1. 证书固定与双向 TLS(mTLS):一旦网关替换为自己的终端站点证书,绑定源站公钥(Certificate Pinning)或要求提供客户端证书的应用程序会立即中止握手。详见证书固定与 mTLS 在 SWG 解密检查下为何失效。
  2. HTTP/3(QUIC)以及长连接 HTTP/2 / WebSocket 流:对 TLS 进行降级或代理的网关经常会丢弃 UDP QUIC 流、导致大模型流式响应卡顿,或重置持久化的 IDE 与 WebSocket 通道。
  3. 独立的 CLI 与编程语言 CA 证书库:Node.js、Python、Git、Homebrew、Docker、Claude Code 和 Cursor 等运行时自带独立的根证书库,因此容易报 CERTIFICATE_VERIFY_FAILED 或 UNABLE_TO_GET_ISSUER_CERT_LOCALLY。
  4. 对延迟敏感的开发 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 检查

  1. 识别所有受检主机名:打开 SWG bar → 域名,或通过 CLI 运行 swgbar domains list --status confirmed。请注意,example.com、auth.example.com 和 api.example.com 是彼此独立的主机名。
  2. 开启单域名绕过:在目标域名的绕过 SWG一行点击开启,或运行:
swgbar bypass enable api.example.com
swgbar bypass status
  1. 关闭复用的 TLS 与 HTTP/3 连接:仅刷新单个浏览器标签页可能会继续复用旧受检路径上的 HTTP/2 或 QUIC 连接池。SWG bar 的原生绕过会在新建连接时将 HTTP/3 回落到基于 TCP 的 HTTPS,因此请在显示绕过中后重新加载标签页,或彻底退出并重新打开目标应用。
  2. 验证全新的证书链:运行 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 例外规则。