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

# Mac 上的 Zscaler SSL 检查：如何检测并按域名绕过

检测 Zscaler Client Connector 是否正在 Mac 上解密 HTTPS，解析防篡改保护下为何强杀 ZCC 会失效，以及如何按域名绕过或配置 CLI CA 信任。

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

要确认 **Zscaler（ZIA / Zscaler Client Connector）**是否正在解密你 Mac 上的 HTTPS 流量，请打开 **SWG bar → 概览**（或运行 `swgbar overview`），查看**域名劫持占比**是否大于 `0%`，以及**中间人证书**列表中是否出现 **Zscaler Root CA** 或企业级中级 CA。若要在获授权的 Mac 上为单个出错主机名绕过 Zscaler SSL 检查，请打开 **SWG bar → 域名**，选中该主机名并开启**绕过 SWG**（或运行 `swgbar bypass enable <domain>`）。

网上大多数 Zscaler 绕过教程都默认你拥有 **Zscaler Admin Portal**（ZIA）管理后台权限。但在通过 Jamf、Kandji 或 Intune 托管的公司 MacBook 上，开发者和普通员工很少拥有后台权限——而 Zscaler 的 **Z-Tunnel 2.0**（`NetworkExtension` / `utun` 隧道）与 **Zscaler Root CA** 却常常导致证书固定应用、`Homebrew`、`npm`、`git`、`Python`、`Docker`、`Claude Code` 和 `Cursor` 报错中断。

## 1\. 检查 Zscaler 是否正在你的 Mac 上执行 HTTPS 检查

由于 MDM 已预先将 **Zscaler Root CA** 安装并设为 macOS 钥匙串受信任根证书，即使 Zscaler 正在执行 HTTPS 解密重签，Safari 和 Chrome 依然会显示正常的锁形图标。你可以通过以下任一方法核验单个域名的解密状态：

*   **使用 SWG bar 持续监测**：[安装 SWG bar](<https://swgbar.com/zh-CN/install/>)（macOS 14+，Apple 芯片，提供 14 个使用日免费试用）并访问目标网站。打开 **SWG bar → 域名**或**证书**——或运行 `swgbar probe <domain>`——查看该域名是被判定为由 `Zscaler Root CA`（或公司自定义 Zscaler 中级 CA）签发的**已确认**拦截状态，还是正常通过的**公共路径**。
*   **在终端抽检单个域名**：

```
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject
```

如果 `issuer=` 显示 `Zscaler` 或你所在组织的自定义 Zscaler 中级 CA，而不是公共 CA（例如 DigiCert、Let’s Encrypt 或 Google Trust Services），即说明 Zscaler 正在对该主机名执行 SSL 检查。如需交叉比对 SHA-256 指纹，请阅读[在 Mac 上使用 OpenSSL 与 security verify-cert 验证 TLS 证书](<https://swgbar.com/zh-CN/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)。

## 2\. 为什么退出登录或强行卸载 Zscaler Client Connector 会失效

在受管 Mac 上试图全局关闭 Zscaler 几乎总是适得其反：

*   **防篡改保护（Tamper Protection）**：多数企业 ZCC 应用配置文件（App Profile）在退出登录或关闭 Internet Security（`ZIA`）时都要求输入 IT 一次性密码；执行 `sudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.*` 也会被拦截或立即自动拉起。
*   **Z-Tunnel 2.0 绕过系统代理设置**：在 macOS 系统设置中关闭 Wi-Fi HTTP/HTTPS 代理开关，对 Z-Tunnel 2.0 的数据包牵引毫无作用。
*   **中断企业办公访问**：即使成功停掉 ZCC，依赖 ZPA（Zscaler Private Access）的内网应用和校验设备合规状态的单点登录（`Okta`、`Entra ID`）也会随之失效。

## 3\. 在 macOS 上应对 Zscaler SSL 检查的三种实用方案

| 方案 | 控制方 | 是否保持 ZCC 与企业 SSO 正常运行？ | 最适用场景 |
| --- | --- | --- | --- |
| **按域名绕过 SWG（`SWG bar`）** | 本地 Mac 用户（获授权网络中） | 是——仅将选定主机名经由 Mac 的物理`硬件网卡` IPv4 接口路由 | 无需关闭 ZCC，即可立即缓解证书固定应用、WebSocket 或开发 API 的单域名故障（详见[如何在 Mac 上绕过 SWG](<https://swgbar.com/zh-CN/guides/how-to-bypass-swg/>)） |
| **Zscaler 管理后台豁免（`Do Not Inspect` / App Profile）** | 企业 IT / 安全团队 | 是 | 在 **Policy → SSL Inspection → Do Not Inspect** 或 macOS **App Profiles → Hostname/IP Bypass** 中配置全公司永久豁免（详见[SWG 绕过与 TLS 解密例外对比](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)） |
| **导出并在 CLI 工具中信任 Zscaler Root CA** | 本地开发者 | 是（流量仍保持受检） | 企业策略要求流量继续解密审计，且 `git`、`npm`、`brew`、`Python`、`Claude Code` 或 `Cursor` 报 `unable to get local issuer certificate` |

## 4\. 开启单域名绕过或为 CLI 工具配置 Zscaler Root CA

### 方案 A：使用 SWG bar 开启单域名绕过（获授权时）

1.  打开 **SWG bar → 域名**，找到出错的准确主机名（请注意登录、API 和 CDN 分别对应不同主机名——详见[多域名 SSO、API 与 CDN 绕过指南](<https://swgbar.com/zh-CN/guides/multi-domain-sso-api-cdn-swg-bypass/>)），在**绕过 SWG**一行点击**开启**，或运行 `swgbar bypass enable <domain>`。
2.  等待状态变为**绕过中**，然后重启浏览器标签页、IDE 或终端会话，使连接池在物理`硬件网卡` IPv4 路径上重新建立连接。
3.  运行 `swgbar probe <domain>` 验证返回的已是源站服务器的公共证书链。如果防火墙阻断直连出站，运行 `swgbar bypass disable <domain>` 即可立即恢复正常的 Zscaler 路由。

### 方案 B：为 CLI 与 AI 工具配置信任 Zscaler Root CA

如果安全策略要求流量继续经 Zscaler 解密，请从钥匙串访问导出 Zscaler Root CA PEM 证书包（或向 IT 索取 PEM 文件），并为开发运行时配置信任，而不是关闭 SSL 校验：

```
# Node.js、npm、Claude Code、Cursor
export NODE_EXTRA_CA_CERTS="$HOME/.certs/zscaler-root.pem"

# Python（pip、requests）、OpenSSL、Homebrew curl
export SSL_CERT_FILE="$HOME/.certs/zscaler-root.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"
export CURL_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"

# Git
git config --global http.sslCAInfo "$HOME/.certs/zscaler-root.pem"
```

涵盖 Homebrew、Docker Desktop、Python、Node.js、Claude Code 与 Cursor 的完整配置说明，请阅读[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 证书错误](<https://swgbar.com/zh-CN/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)。

## 继续阅读

*   [如何在 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 上的 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/>)
