Source: https://swgbar.com/zh-CN/guides/bypass-https-tls-inspection-mac/
Language: zh-CN

# 如何在 macOS 上绕过 HTTPS 与 TLS 检查（Break-and-Inspect 指南）

在 macOS 上使用 SWG bar 按域名绕过 HTTPS 与 TLS Break-and-Inspect 解密检查：解析 TLS 终止为何破坏 HTTP/2、QUIC 与证书固定，以及 CLI 验证方法。

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

要在 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 解密检查下为何失效](<https://swgbar.com/zh-CN/guides/certificate-pinning-mtls-swg-inspection-macos/>)。
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 解密例外对比](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)。

## 在 macOS 上为指定域名绕过 HTTPS 与 TLS 检查

1.  **识别所有受检主机名**：打开 **SWG bar → 域名**，或通过 [CLI](<https://swgbar.com/zh-CN/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
```

3.  **关闭复用的 TLS 与 HTTP/3 连接**：仅刷新单个浏览器标签页可能会继续复用旧受检路径上的 HTTP/2 或 QUIC 连接池。SWG bar 的原生绕过会在新建连接时将 HTTP/3 回落到基于 TCP 的 HTTPS，因此请在显示**绕过中**后重新加载标签页，或彻底退出并重新打开目标应用。
4.  **验证全新的证书链**：运行 `swgbar probe api.example.com`（或执行 `openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null`），核实当前返回的已是源站服务器的公共签发机构。

如果状态显示为**恢复中**或**已暂停**而非**绕过中**，请查阅[排查 macOS 上“恢复中”与“已暂停”的 SWG 绕过状态](<https://swgbar.com/zh-CN/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)。

## 按需关闭绕过或改用 CA 信任方案

再次点击已启用的**绕过 SWG**控件——或运行 `swgbar bypass disable <domain>`——即可立即让该主机名恢复正常网关路由。退出 SWG bar 也会立刻停止当前生效的绕过，但会保留你保存的主机名选择，待下次启动时自动恢复。

如果所在网络在防火墙层面禁止直接出站 IPv4 流量，请关闭绕过，改用 [CLI 与 AI 工具 CA 证书信任修复指南](<https://swgbar.com/zh-CN/guides/swg-tls-certificate-errors-macos/>)，或请管理员针对确切主机名添加 **Do Not Decrypt** 例外规则。

## 继续阅读

*   [如何在 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/>)
*   [如何在 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/>)
*   [排查 Mac 上 SWG 绕过的“恢复中”“已暂停”与连接错误](<https://swgbar.com/zh-CN/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [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/>)
