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

# Mac 上的 Zscaler SSL 檢查：如何偵測並按網域繞過

檢查 Mac 上的 Zscaler Client Connector 是否正在解密 HTTPS，瞭解為何受防竄改保護下強殺 ZCC 會失敗，並對比單網域繞過與 CLI 憑證設定。

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 鑰匙圈中，Safari 和 Chrome 即使在 Zscaler 執行 HTTPS Break-and-Inspect 時仍顯示正常鎖頭。請用以下任一方式逐網域確認：

*   **使用 SWG bar 持續偵測**：[安裝 SWG bar](<https://swgbar.com/zh-TW/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，而非公開憑證機構（如 DigiCert、Let’s Encrypt 或 Google Trust Services），代表該主機名稱正處於 Zscaler SSL 檢查之下。欲交叉驗證 SHA-256 指紋，請參閱[使用 OpenSSL 與 security verify-cert 驗證 TLS 憑證](<https://swgbar.com/zh-TW/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)。

## 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](<https://swgbar.com/zh-TW/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-TW/guides/swg-bypass-vs-tls-exception/>)） |
| **為 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 繞過指南](<https://swgbar.com/zh-TW/guides/multi-domain-sso-api-cdn-swg-bypass/>)），在**繞過 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 信任設定](<https://swgbar.com/zh-TW/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)與[修復 Mac 上 Claude Code 與 Cursor 憑證錯誤](<https://swgbar.com/zh-TW/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)。

## 延伸閱讀

*   [如何在 Mac 上繞過 SWG（單網域一鍵繞過與 CLI 指令）](<https://swgbar.com/zh-TW/guides/how-to-bypass-swg/>)
*   [如何在 Mac 上繞過 SSL 檢查（企業 SWG 單網域直連方案）](<https://swgbar.com/zh-TW/guides/bypass-ssl-inspection-mac/>)
*   [如何在 macOS 上繞過 HTTPS 與 TLS 檢查（Break-and-Inspect 指南）](<https://swgbar.com/zh-TW/guides/bypass-https-tls-inspection-mac/>)
*   [如何在 Mac 上繞過企業代理伺服器與 SWG SSL 檢查](<https://swgbar.com/zh-TW/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [如何判斷 Mac 是否被 SWG 劫持（偵測 HTTPS 與 SSL 檢查）](<https://swgbar.com/zh-TW/guides/detect-https-inspection/>)
*   [如何檢查公司或工作用 Mac 是否正在攔截 HTTPS（SSL 檢查）](<https://swgbar.com/zh-TW/guides/check-if-work-mac-intercepting-https/>)
*   [Mac 專用 SSL 檢查偵測工具：在選單列即時發現 HTTPS 攔截](<https://swgbar.com/zh-TW/guides/ssl-inspection-checker-mac/>)
*   [Mac 上的 Netskope SSL 檢查：偵測解密與單網域繞過指南](<https://swgbar.com/zh-TW/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Cloudflare WARP 與 Zero Trust TLS 檢查：偵測與繞過](<https://swgbar.com/zh-TW/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar 中的「已確認」與「疑似」HTTPS 檢查狀態解析](<https://swgbar.com/zh-TW/guides/confirmed-vs-suspected-https-inspection/>)
*   [在 SWG bar 中檢查中間人根憑證與核發機構](<https://swgbar.com/zh-TW/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac 上的企業 SWG 與 MDM HTTPS 解密檢查解析](<https://swgbar.com/zh-TW/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 繞過與 TLS 解密例外（Break-and-Inspect）對比](<https://swgbar.com/zh-TW/guides/swg-bypass-vs-tls-exception/>)
*   [在 Mac 上為多網域 Web 應用、SSO、CDN 與 API 設定 SWG 繞過](<https://swgbar.com/zh-TW/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [排解 Mac 上 SWG 繞過的「恢復中」「已暫停」與連線錯誤](<https://swgbar.com/zh-TW/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 虛擬介面與 SWG HTTPS 檢查比較](<https://swgbar.com/zh-TW/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [為什麼憑證固定（Pinning）應用與 mTLS 在 SWG 檢查下會中斷](<https://swgbar.com/zh-TW/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [修復 Mac 終端機 CLI 與 AI 工具中的 SWG TLS/SSL 憑證錯誤](<https://swgbar.com/zh-TW/guides/swg-tls-certificate-errors-macos/>)
*   [Mac 在 SWG 下的 Homebrew、Docker、Python 與 Node.js CA 信任設定](<https://swgbar.com/zh-TW/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-TW/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [在 Mac 上使用 openssl 與 security verify-cert 驗證 TLS 憑證](<https://swgbar.com/zh-TW/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 權限、本機隱私與 TLS 探測上限說明](<https://swgbar.com/zh-TW/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar 如何檢查 HTTPS 解密](<https://swgbar.com/zh-TW/how-it-works/>)
*   [下載並安裝 Mac 版 SWG bar（macOS 14+）](<https://swgbar.com/zh-TW/install/>)
*   [偵測 SSL 與 HTTPS 檢查的 Chrome 擴充功能（SWG bar 配套外掛）](<https://swgbar.com/zh-TW/chrome-extension/>)
*   [SWG bar CLI 使用指南](<https://swgbar.com/zh-TW/cli/>)
*   [SWG bar MCP 使用指南](<https://swgbar.com/zh-TW/mcp/>)
*   [SWG bar 版本資訊](<https://swgbar.com/zh-TW/releases/>)
*   [關於 SWG bar](<https://swgbar.com/zh-TW/about/>)
