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 開啟單網域繞過

  1. 開啟 SWG bar → 網域,找到確切的異常主機名稱(請注意登入、API 與 CDN 分屬不同主機名稱,可參考多網域 SSO、API 與 CDN 繞過指南),在繞過 SWG列按一下開啟,或執行 swgbar bypass enable <domain>。
  2. 等待顯示繞過中後,重啟瀏覽器分頁、IDE 或 CLI 工作階段,讓既有的連線池切換到實體硬體網卡 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 的完整步驟,請參閱 Homebrew、Docker、Python 與 Node.js 的 CA 信任設定與修復 Mac 上 Claude Code 與 Cursor 憑證錯誤。