在 Mac 上為多網域 Web 應用、SSO、CDN 與 API 設定 SWG 繞過
為何僅繞過單一根網域對現代應用程式往往不足:在 SWG bar 中找出登入、CDN 與 API 主機名稱,並徹底重設 Keep-Alive 長連線。
SWG bar · 更新日期
在 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 的主機名稱無法比對套用單網域繞過。
找出應用程式仰賴的所有受檢主機名稱
- 在 SWG bar 持續監測的狀態下,開啟該網站或執行一次失敗的開發工作流程。
- 在 SWG bar → 網域中依已確認 / 疑似排序或篩選,並以關鍵字搜尋(例如
example或auth),或透過 CLI 查詢:
swgbar domains list --status confirmed --search example
swgbar domains list --bypass active
- 針對該工作流程所需的每一個受檢主機名稱,分別開啟其詳細資訊並啟用繞過 SWG(或執行
swgbar bypass enable <hostname>)。 - 請留意:在獲授權的網路上繞過某個身分驗證或 API 網域,不代表所有無關網域都需要繞過——請將規則嚴格限定在確有需求的主機範圍內。
關閉 Keep-Alive 長連線並查看 Chrome 狀態
即使狀態已顯示為繞過中,瀏覽器與背景常駐程式仍會沿用先前記錄在舊檢查路徑上的 HTTP/2、HTTP/3 或 TLS Keep-Alive 通訊端:
- Web 瀏覽器:強制重新載入受影響的分頁(
Cmd + Shift + R);若網站使用了長效 WebSocket 或 HTTP/3 連線,請關閉並重新開啟瀏覽器視窗。你可以使用 Chrome 配套擴充功能檢視目前分頁顯示的作用中主機名稱——但請記得該擴充功能僅顯示 SWG bar 已記錄的觀測結果,不會直接檢查 Chrome 的即時通訊端。 - 終端機與 IDE:重新啟動長時間執行的程序(
npm、Claude Code常駐程式、IDE 語言伺服器或git憑證輔助程式),促使其透過實體介面建立全新的 TCP/TLS 連線。
逐一驗證每個主機名稱
更新規則後,請開啟網域(或執行 swgbar domains detail <hostname>),確認新的探測驗證工作流程中的每一個主機名稱都已恢復公開信任路徑——而不僅僅是瀏覽器網址列上顯示的頂層網址。若全公司共用的 SaaS 或 SSO 網域影響整個團隊,請參考 SWG 繞過與 TLS 解密例外對比,評估是否更適合由管理員設定閘道器例外政策。