Mac 上的 Zscaler SSL 檢查:如何偵測並按網域繞過
檢查 Mac 上的 Zscaler Client Connector 是否正在解密 HTTPS,瞭解為何受防竄改保護下強殺 ZCC 會失敗,並對比單網域繞過與 CLI 憑證設定。
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 鑰匙圈中,Safari 和 Chrome 即使在 Zscaler 執行 HTTPS Break-and-Inspect 時仍顯示正常鎖頭。請用以下任一方式逐網域確認:
- 使用 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,而非公開憑證機構(如 DigiCert、Let’s Encrypt 或 Google Trust Services),代表該主機名稱正處於 Zscaler SSL 檢查之下。欲交叉驗證 SHA-256 指紋,請參閱使用 OpenSSL 與 security verify-cert 驗證 TLS 憑證。
2. 為什麼登出或卸載 Zscaler Client Connector 通常行不通
在企業受管 Mac 上嘗試全域關閉 Zscaler 往往適得其反:
- 防竄改保護(Tamper Protection):大多數企業 ZCC App Profile 會要求輸入 IT 一次性密碼才能登出或停用 Internet Security(
ZIA),而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)內網服務與綁定裝置合規狀態的企業 SSO(
Okta、Entra ID)也會跟著失效。
3. 在 macOS 上處理 Zscaler SSL 檢查的 3 種實用方案
| 方案 | 控制方 | 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. 開啟單網域繞過或設定 Zscaler Root CA 供 CLI 使用
方案 A:經授權時使用 SWG bar 開啟單網域繞過
- 開啟 SWG bar → 網域,找到確切的異常主機名稱(請注意登入、API 與 CDN 分屬不同主機名稱,可參考多網域 SSO、API 與 CDN 繞過指南),在繞過 SWG列按一下開啟,或執行
swgbar bypass enable <domain>。 - 等待顯示繞過中後,重啟瀏覽器分頁、IDE 或 CLI 工作階段,讓既有的連線池切換到實體硬體網卡 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 的完整步驟,請參閱 Homebrew、Docker、Python 與 Node.js 的 CA 信任設定與修復 Mac 上 Claude Code 與 Cursor 憑證錯誤。