Mac 上的 Zscaler SSL 检查:如何检测并按域名绕过
检测 Zscaler Client Connector 是否正在 Mac 上解密 HTTPS,解析防篡改保护下为何强杀 ZCC 会失效,以及如何按域名绕过或配置 CLI CA 信任。
SWG bar · 更新日期
要确认 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(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 证书。
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) |
Zscaler 管理后台豁免(Do Not Inspect / App Profile) |
企业 IT / 安全团队 | 是 | 在 Policy → SSL Inspection → Do Not Inspect 或 macOS App Profiles → Hostname/IP Bypass 中配置全公司永久豁免(详见SWG 绕过与 TLS 解密例外对比) |
| 导出并在 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 开启单域名绕过(获授权时)
- 打开 SWG bar → 域名,找到出错的准确主机名(请注意登录、API 和 CDN 分别对应不同主机名——详见多域名 SSO、API 与 CDN 绕过指南),在绕过 SWG一行点击开启,或运行
swgbar bypass enable <domain>。 - 等待状态变为绕过中,然后重启浏览器标签页、IDE 或终端会话,使连接池在物理
硬件网卡IPv4 路径上重新建立连接。 - 运行
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 信任配置和修复 Mac 上 Claude Code 与 Cursor 证书错误。