如何在 macOS 上繞過 HTTPS 與 TLS 檢查(Break-and-Inspect 指南)
透過 SWG bar 在 macOS 上按網域繞過 HTTPS/TLS Break-and-Inspect 解密檢查:解析 TLS 終止對 HTTP/2、QUIC 與憑證固定的影響及 CLI 驗證。
SWG bar · 更新日期
要在 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 工作流程:
- 憑證固定(Certificate Pinning)與雙向 TLS(mTLS):內建伺服器公鑰指紋或需要用戶端憑證的應用程式,一旦偵測到閘道器替換葉憑證便會立刻中止交握。詳見憑證固定與 mTLS 在 SWG 檢查下為何失敗。
- HTTP/3(QUIC)與長連線 HTTP/2 / WebSocket:將 TLS 連線降級或代理的閘道器經常丟棄 UDP QUIC 串流、導致 LLM 串流回應卡頓,或重置持續性的 IDE/WebSocket 通道。
- 獨立 CA 憑證庫的 CLI 與語言執行時期:
Node.js、Python、Git、Homebrew、Docker、Claude Code與Cursor等工具多數使用內建公開根憑證庫,遇到重簽憑證即回報CERTIFICATE_VERIFY_FAILED或UNABLE_TO_GET_ISSUER_CERT_LOCALLY。 - 對延遲敏感的開發 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 解密例外對比。
在 macOS 上為網域繞過 HTTPS 與 TLS 檢查
- 找出所有受檢查的主機名稱:開啟 SWG bar → 網域或透過 CLI 執行
swgbar domains list --status confirmed。請記住example.com、auth.example.com與api.example.com屬於各自獨立的主機名稱。 - 啟用單網域繞過:在該網域的繞過 SWG列點擊開啟,或在終端機執行:
swgbar bypass enable api.example.com
swgbar bypass status
- 關閉既有的 TLS 與 HTTP/3 連線池:僅重新整理瀏覽器分頁可能會沿用舊路徑上已建立的 HTTP/2 或 QUIC 通訊端。SWG bar 的原生繞過會在新連線時將 HTTP/3 回退為 HTTPS over TCP,因此在看到繞過中後請重新載入分頁或重新開啟目標應用程式。
- 驗證最新憑證鏈:執行
swgbar probe api.example.com(或openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null),確認收到的已為來源伺服器的公開簽發機構。
若狀態顯示恢復中或已暫停而非繞過中,請參閱排解 macOS 上 SWG 繞過的恢復中與已暫停狀態。
需要時關閉繞過或改用 CA 信任方案
再次點擊繞過 SWG列中已啟用的控制項(或執行 swgbar bypass disable <domain>),即可立即讓該主機名稱恢復一般閘道器路由。結束 SWG bar 也會即時停止進行中的繞過,同時保留你儲存的網域清單以便下次啟動時自動恢復。
若企業防火牆在網路層全面阻擋直接對外的 IPv4 連線,請關閉繞過並改用 CLI 與 AI 工具 CA 信任修復指南,或向 IT 申請針對該確切主機名稱的 Do Not Decrypt 規則。