Source: https://swgbar.com/zh-TW/guides/multi-domain-sso-api-cdn-swg-bypass/
Language: zh-TW

# 在 Mac 上為多網域 Web 應用、SSO、CDN 與 API 設定 SWG 繞過

為何僅繞過單一根網域對現代應用程式往往不足：在 SWG bar 中找出登入、CDN 與 API 主機名稱，並徹底重設 Keep-Alive 長連線。

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

在 macOS 上啟用**繞過 SWG** 時，常見的意外情況是：主網頁確實重新載入了，但登入跳轉、圖片資源、套件下載或 API 呼叫仍然觸發 HTTPS 檢查甚至失敗。由於 SWG bar 是**依確切主機名稱逐一**套用繞過規則，現代多網域 Web 應用程式與開發工具通常仰賴多個獨立主機。

## 為什麼單一主機名稱繞過不會涵蓋子網域

對 `app.example.com` 啟用繞過時，規則**僅**套用於 `app.example.com`，不會自動繞過：

*   **單一登入（SSO）與 OAuth 識別提供者**：`login.example.com`、`auth.example.com`、`sso.company.com`，或第三方身分驗證主機（`accounts.google.com`、`login.microsoftonline.com`）。
*   **API 與 AI 端點**：`api.example.com`、`graphql.example.com`，以及獨立的遙測或串流子網域。
*   **靜態資源與套件庫**：`cdn.example.net`、`assets.example.com`，或物件儲存貯體（`*.s3.amazonaws.com`、`objects.githubusercontent.com`）。

請注意，**無法辨識或採用加密 SNI/ECH 的主機名稱**無法比對套用單網域繞過。

## 找出應用程式仰賴的所有受檢主機名稱

1.  在 SWG bar 持續監測的狀態下，開啟該網站或執行一次失敗的開發工作流程。
2.  在 **SWG bar → 網域**中依**已確認** / **疑似**排序或篩選，並以關鍵字搜尋（例如 `example` 或 `auth`），或透過 [CLI](<https://swgbar.com/zh-TW/cli/>) 查詢：

```
swgbar domains list --status confirmed --search example
swgbar domains list --bypass active
```

3.  針對該工作流程所需的每一個受檢主機名稱，分別開啟其詳細資訊並啟用**繞過 SWG**（或執行 `swgbar bypass enable <hostname>`）。
4.  請留意：在獲授權的網路上繞過某個身分驗證或 API 網域，不代表所有無關網域都需要繞過——請將規則嚴格限定在確有需求的主機範圍內。

## 關閉 Keep-Alive 長連線並查看 Chrome 狀態

即使狀態已顯示為**繞過中**，瀏覽器與背景常駐程式仍會沿用先前記錄在舊檢查路徑上的 HTTP/2、HTTP/3 或 TLS Keep-Alive 通訊端：

*   **Web 瀏覽器**：強制重新載入受影響的分頁（`Cmd + Shift + R`）；若網站使用了長效 WebSocket 或 HTTP/3 連線，請關閉並重新開啟瀏覽器視窗。你可以使用 [Chrome 配套擴充功能](<https://swgbar.com/zh-TW/chrome-extension/>)檢視目前分頁顯示的作用中主機名稱——但請記得該擴充功能僅顯示 SWG bar 已記錄的觀測結果，不會直接檢查 Chrome 的即時通訊端。
*   **終端機與 IDE**：重新啟動長時間執行的程序（`npm`、`Claude Code` 常駐程式、IDE 語言伺服器或 `git` 憑證輔助程式），促使其透過實體介面建立全新的 TCP/TLS 連線。

## 逐一驗證每個主機名稱

更新規則後，請開啟**網域**（或執行 `swgbar domains detail <hostname>`），確認新的探測驗證工作流程中的**每一個**主機名稱都已恢復公開信任路徑——而不僅僅是瀏覽器網址列上顯示的頂層網址。若全公司共用的 SaaS 或 SSO 網域影響整個團隊，請參考 [SWG 繞過與 TLS 解密例外對比](<https://swgbar.com/zh-TW/guides/swg-bypass-vs-tls-exception/>)，評估是否更適合由管理員設定閘道器例外政策。

## 延伸閱讀

*   [如何在 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 上的 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 上 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/>)
