如何在 Mac 上繞過企業代理伺服器與 SWG SSL 檢查
解析為何關閉 macOS 系統設定代理伺服器或執行 networksetup 對透明 SWG 代理無效,以及如何按網域繞過或修復 CLI 憑證錯誤。
SWG bar · 更新日期
如果你在 系統設定 → 網路 → 代理伺服器 中關閉 Wi-Fi 代理開關,或執行 networksetup -setproxybypassdomains 加入排除網域後,Mac 依然受到企業代理伺服器 SSL 檢查,代表你的裝置使用的是透明 安全 Web 閘道(SWG)代理程式(NetworkExtension 或 utun 通道),而不是傳統的顯式 HTTP 代理。要在經授權的 Mac 上為特定主機名稱繞過 SWG 檢查,請開啟 SWG bar → 網域,選取目標主機名稱並開啟繞過 SWG(或執行 swgbar bypass enable <domain>)。
大多數 macOS 代理設定教學將兩種完全不同的企業架構混為一談:傳統的顯式代理 / PAC 指令碼,以及現代的透明 SWG 代理程式(如 Cisco Umbrella / Cisco Secure Client、Broadcom Cloud SWG、Zscaler、Netskope 或 Cloudflare Gateway)。釐清你的 Mac 屬於哪一種,就能馬上明白為什麼調整系統代理無效,以及哪種做法才真正起作用。
1. 檢查你的 Mac 是顯式代理還是透明 SWG
執行兩項快速檢查,即可確認 macOS 上的流量轉導方式:
- 檢查顯式系統代理設定:
scutil --proxy
查看輸出中是否包含 HTTPEnable : 1、HTTPSEnable : 1 或 ProxyAutoConfigURLString(.pac 網址)。2. 檢查實際 HTTPS 憑證是否遭攔截:開啟 SWG bar → 概覽(或執行 swgbar overview / swgbar domains list --status confirmed)。
- 若
scutil --proxy為空,但 SWG bar 顯示網域劫持比例 >0%(伴隨已確認或疑似網域及中間人憑證),代表你的 Mac 處於透明 SWG 代理程式(NetworkExtension/utun)之下,封包在系統代理設定底層就被截獲。 - 若
scutil --proxy列出企業代理/PAC 且 SWG bar 顯示企業中間人根憑證,則流量係經由顯式/PAC 攔截代理轉送。
2. macOS 上顯式代理 vs. 透明 SWG 代理對比
| 架構類型 | macOS 攔截流量的位置 | 系統設定 → 代理伺服器 / networksetup 能否繞過? |
經授權 Mac 上真正有效的方法 |
|---|---|---|---|
| 顯式 HTTP/HTTPS 或 PAC 代理(未受管) | macOS 系統設定代理欄位 | 可以(前提是未被 MDM 鎖定「略過這些主機與網域的代理伺服器設定」) | macOS 代理略過清單,搭配單網域路由複核 |
MDM 鎖定的顯式代理或透明 SWG(NetworkExtension / utun) |
位於瀏覽器代理開關底層的核心 / NetworkExtension 通訊端與 IP 過濾器 | 否——設定會被鎖定、自動覆寫,或完全被 SWG 通道忽略 | 透過 SWG bar 按網域走實體硬體網卡 IPv4 繞過(如何在 Mac 上繞過 SWG)、IT 閘道器 External Domains / Do Not Decrypt 例外,或 CLI CA 憑證設定 |
3. 在 macOS 上為特定網域繞過 SWG 代理 SSL 檢查
當你在自行管理或經授權設定的網路上,遇到特定網頁應用、API 端點或憑證固定桌面用戶端因企業 SWG 代理而失敗時:
- 安裝並開啟 SWG bar(macOS 14+ Apple 晶片,提供 14 個使用日免費試用),重現一次請求讓確切主機名稱出現在網域列表中。
- 開啟該主機名稱的詳細資訊,在繞過 SWG列按一下開啟,或執行:
swgbar bypass enable <domain>
swgbar bypass status
- 等待狀態顯示繞過中後,重新載入網頁或重啟終端機/桌面用戶端,讓既有的 Keep-Alive 通訊端改經實體硬體網卡 IPv4 介面(
en0/en7)重新連線。 - 執行
swgbar probe <domain>確認已正確呈現來源伺服器的公開憑證鏈。請注意:若某應用程式自行硬編碼了顯式代理(例如~/.zshrc、~/.npmrc或~/.gitconfig中的HTTP_PROXY/HTTPS_PROXY),需先為該主機解除這些代理環境變數,避免程式把流量又送回顯式代理連接埠。
4. 無法繞過代理時:IT 例外規則與 CLI CA 憑證鏈
如果企業防火牆採用嚴格的 Fail-Closed 邊界策略,全面阻擋未經 SWG 代理的對外 IPv4 連線:
- 停用單網域繞過(
swgbar bypass disable <domain>),讓該主機名稱立刻恢復常規代理路由。 - 為 CLI 工具設定信任企業代理 CA:將
git、curl、npm、Python、Homebrew、Claude Code與Cursor指向匯出的企業 CA PEM 檔案(SSL_CERT_FILE、NODE_EXTRA_CA_CERTS、REQUESTS_CA_BUNDLE、git http.sslCAInfo),而不要不安全地關閉 SSL 驗證。詳見修復 Mac 終端機 CLI 與 AI 工具中的 SWG TLS/SSL 憑證錯誤。 - 申請 IT 閘道器繞過或解密例外:將 SWG bar 記錄的確切故障主機名稱(包含登入與 CDN 網域)及憑證證據提供給 IT,由其在集中政策新增 Do Not Decrypt 或 External Domains List 規則。兩者差異請見 SWG 繞過與 TLS 解密例外對比。