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

# 如何在 macOS 上繞過 HTTPS 與 TLS 檢查（Break-and-Inspect 指南）

透過 SWG bar 在 macOS 上按網域繞過 HTTPS/TLS Break-and-Inspect 解密檢查：解析 TLS 終止對 HTTP/2、QUIC 與憑證固定的影響及 CLI 驗證。

SWG bar · 更新日期 2026年11月19日

要在 macOS 上為特定網域繞過 **HTTPS 或 TLS 檢查（Break-and-Inspect）**而不必全域關閉安全用戶端，請開啟 **SWG bar → 網域**，選取目標主機名稱並開啟**繞過 SWG**（或執行 `swgbar bypass enable <domain>`）。等待該列顯示**繞過中**後，重啟瀏覽器分頁、IDE 或 CLI 工作階段，讓新的 TLS 交握經由 Mac 的實體**硬體網卡** IPv4 介面直接建立。

企業安全 Web 閘道（SWG）與次世代防火牆透過受信任的中間人機制檢查 HTTPS 流量：它們會終止 Mac 發出的 TLS 1.2/1.3 交握、解密並審查 HTTP 內容，再重新加密發往來源伺服器。雖然瀏覽器會默默信任 MDM 安裝的企業根憑證，但現代傳輸協定與嚴格的開發工具常因 TLS 重簽而中斷。

## HTTPS / TLS Break-and-Inspect 會在 Mac 上造成哪些故障

即使 macOS 鑰匙圈已信任企業根憑證，行內 TLS 終止仍會破壞四類常見 macOS 工作流程：

1.  **憑證固定（Certificate Pinning）與雙向 TLS（mTLS）**：內建伺服器公鑰指紋或需要用戶端憑證的應用程式，一旦偵測到閘道器替換葉憑證便會立刻中止交握。詳見[憑證固定與 mTLS 在 SWG 檢查下為何失敗](<https://swgbar.com/zh-TW/guides/certificate-pinning-mtls-swg-inspection-macos/>)。
2.  **HTTP/3（QUIC）與長連線 HTTP/2 / WebSocket**：將 TLS 連線降級或代理的閘道器經常丟棄 UDP QUIC 串流、導致 LLM 串流回應卡頓，或重置持續性的 IDE/WebSocket 通道。
3.  **獨立 CA 憑證庫的 CLI 與語言執行時期**：`Node.js`、`Python`、`Git`、`Homebrew`、`Docker`、`Claude Code` 與 `Cursor` 等工具多數使用內建公開根憑證庫，遇到重簽憑證即回報 `CERTIFICATE_VERIFY_FAILED` 或 `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`。
4.  **對延遲敏感的開發 API**：每次 TLS 交握皆回傳至遠端雲端 SWG 節點，會顯著拖慢套件安裝、`git fetch` 與即時程式碼補全。

## 單網域 TLS 繞過 vs. 系統代理設定與閘道器例外

| 維度 | 單網域繞過（`SWG bar`） | 管理員 TLS 檢查例外（`Do Not Decrypt`） | 本機代理設定（`系統設定 → 代理伺服器`） |
| --- | --- | --- | --- |
| **作用層級** | 透過 macOS NetworkExtension 執行主機名稱層級的實體 IPv4 路由 | 閘道器/防火牆集中解密政策 | 僅影響顯式系統 HTTP/HTTPS 代理欄位 |
| **對透明 SWG 是否有效？** | 有效（需具備可達的實體 IPv4 路徑） | 有效（由 IT 管理員設定） | 無效——會被 `utun` 或透明 SWG 代理程式忽略或覆蓋 |
| **需要 IT 管理後台嗎？** | 不需要（經授權 Mac 本機控制） | 需要（Zscaler、Netskope、Cloudflare、Palo Alto 後台） | 不需要 |
| **保留裝置合規狀態與 SSO？** | 是——企業端點代理程式維持正常運作 | 是 | 常破壞企業 PAC 路由 |

想深入比較本機路由變更與閘道器解密例外，請參閱 [SWG 繞過與 TLS 解密例外對比](<https://swgbar.com/zh-TW/guides/swg-bypass-vs-tls-exception/>)。

## 在 macOS 上為網域繞過 HTTPS 與 TLS 檢查

1.  **找出所有受檢查的主機名稱**：開啟 **SWG bar → 網域**或透過 [CLI](<https://swgbar.com/zh-TW/cli/>) 執行 `swgbar domains list --status confirmed`。請記住 `example.com`、`auth.example.com` 與 `api.example.com` 屬於各自獨立的主機名稱。
2.  **啟用單網域繞過**：在該網域的**繞過 SWG**列點擊**開啟**，或在終端機執行：

```
swgbar bypass enable api.example.com
swgbar bypass status
```

3.  **關閉既有的 TLS 與 HTTP/3 連線池**：僅重新整理瀏覽器分頁可能會沿用舊路徑上已建立的 HTTP/2 或 QUIC 通訊端。SWG bar 的原生繞過會在新連線時將 HTTP/3 回退為 HTTPS over TCP，因此在看到**繞過中**後請重新載入分頁或重新開啟目標應用程式。
4.  **驗證最新憑證鏈**：執行 `swgbar probe api.example.com`（或 `openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null`），確認收到的已為來源伺服器的公開簽發機構。

若狀態顯示**恢復中**或**已暫停**而非**繞過中**，請參閱[排解 macOS 上 SWG 繞過的恢復中與已暫停狀態](<https://swgbar.com/zh-TW/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)。

## 需要時關閉繞過或改用 CA 信任方案

再次點擊**繞過 SWG**列中已啟用的控制項（或執行 `swgbar bypass disable <domain>`），即可立即讓該主機名稱恢復一般閘道器路由。結束 SWG bar 也會即時停止進行中的繞過，同時保留你儲存的網域清單以便下次啟動時自動恢復。

若企業防火牆在網路層全面阻擋直接對外的 IPv4 連線，請關閉繞過並改用 [CLI 與 AI 工具 CA 信任修復指南](<https://swgbar.com/zh-TW/guides/swg-tls-certificate-errors-macos/>)，或向 IT 申請針對該確切主機名稱的 **Do Not Decrypt** 規則。

## 延伸閱讀

*   [如何在 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/>)
*   [如何在 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 上的 Zscaler SSL 檢查：如何偵測並按網域繞過](<https://swgbar.com/zh-TW/guides/zscaler-ssl-inspection-bypass-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/>)
