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 开启单域名绕过(获授权时)

  1. 打开 SWG bar → 域名,找到出错的准确主机名(请注意登录、API 和 CDN 分别对应不同主机名——详见多域名 SSO、API 与 CDN 绕过指南),在绕过 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 信任配置和修复 Mac 上 Claude Code 与 Cursor 证书错误。