· 故障排除 · 約需閱讀 8 分鐘
macOS 系統代理已開啟卻無效?Safari、Chrome 與終端機分開排查
Safari、Chrome、終端機與命令列工具使用代理的方式各不相同。本文說明如何檢查網路設定、排除瀏覽器擴充功能衝突,以及設定 export 環境變數。
先確認 macOS 代理位址與監聽連接埠
先確認請求是否有進入 Clash 用戶端,再判斷使用了哪個出口。系統代理會讓支援此設定的 App 將請求送至本機連接埠;規則模式則決定收到請求後要直連、走代理或拒絕。開啟系統代理,不代表每個網站都會經由代理節點連線。
- 確認目前連線的網路服務。在 macOS 13 Ventura 或更新版本中,使用 Wi-Fi 時,開啟「系統設定」→「網路」→「Wi-Fi」→已連線網路的「詳細資訊」→「代理伺服器」。使用有線網路時,從「網路」進入目前乙太網路服務的「詳細資訊」→「代理伺服器」。macOS 12 Monterey 則從「系統偏好設定」→「網路」選取目前服務,再開啟「進階」→「代理伺服器」。
- 確認通訊協定、位址與連接埠。若設定使用本機 HTTP 或混合連接埠,請確認「網頁代理伺服器(HTTP)」和「安全網頁代理伺服器(HTTPS)」指向 Clash 用戶端實際監聽的位址與連接埠。例如用戶端顯示混合連接埠為
7890時,兩者都可設為127.0.0.1:7890。僅支援 SOCKS 的連接埠不能填入 HTTP 或 HTTPS 代理欄位。 - 檢查是否有其他代理設定。留意「自動代理探索」、「自動代理設定」及代理略過清單。自動代理設定指令碼可能依不同網址傳回不同結果,略過清單則可能讓特定網域直接連線。受管理的 Mac 請勿自行移除設定描述檔或政策,先向管理員確認目前設定的用途。
接著在終端機執行以下兩個指令。第二個指令中的 7890 僅為範例,請替換成用戶端顯示的 HTTP 或混合連接埠。
scutil --proxy
lsof -nP -iTCP:7890 -sTCP:LISTEN
使用手動 HTTP 代理時,第一個指令通常會列出 HTTPEnable : 1、HTTPSEnable : 1 及對應的主機與連接埠。第二個指令用來確認監聽程序和綁定位址。如果設定指向 127.0.0.1:7890,但用戶端只在另一個連接埠監聽,瀏覽器就會嘗試連到錯誤的連接埠。闔上筆電後,若從 Wi-Fi 改接擴充基座的有線網路,也要重新確認目前使用的網路服務,不能沿用上一個連線的設定。
Safari 無法使用代理:從連線紀錄判斷是略過還是分流
Safari 通常會使用 macOS 系統代理。排查時,開啟 Clash 用戶端的「連線」檢視或可用的記錄檢視,再用 Safari 開啟一個不需登入的 HTTPS 網頁,例如 https://example.com/。依存取時間和主機名稱篩選,別把載入頁面時連線的其他主機誤認為主要請求。
- 有紀錄,策略顯示
DIRECT:請求已進入 Clash 用戶端,只是依規則直連。查看符合的規則和目前的策略群組,不必反覆開關系統代理。如果這是預期設定,直連並不是故障。 - 有紀錄,但請求失敗:先確認失敗發生在網域名稱解析、連線至上游伺服器,還是交握階段。使用同一個策略群組測試另一個已知可用的目標,有助於判斷是單一網站故障,還是整個出口都無法使用。
- 沒有紀錄:先確認連線檢視沒有篩掉該請求,再檢查系統代理略過清單、自動代理設定和目前的網路服務。開新視窗重試;必要時按 ⌘ + Q 完全結束 Safari 後重新開啟,避免舊連線或頁面快取影響判斷。
Chrome 無法使用代理:檢查擴充功能、啟動參數與管理政策
如果 Safari 的相同目標已出現在連線紀錄中,但 Chrome 沒有,先檢查 Chrome 本身的設定。Chrome 在 macOS 上預設會使用系統代理,但有權控制代理的擴充功能、啟動參數和管理政策都可能改變實際使用的代理。
- 開啟
chrome://extensions/,暫時停用代理切換、網路加速等可能管理代理的擴充功能。每次停用一個,再重試相同網址。無痕視窗不是可靠的比對方式,因為擴充功能可能獲准在無痕模式中執行。 - 開啟
chrome://version/,檢查「命令列」是否包含--proxy-server或--no-proxy-server。如果平常透過指令碼或捷徑啟動 Chrome,請按 ⌘ + Q 完全結束,再從「應用程式」正常開啟並重新測試。 - 開啟
chrome://policy/,搜尋ProxySettings等代理相關政策。如果公司或學校裝置套用了相關政策,記下名稱和值,交由管理員確認;不要把受管理的設定當成一般擴充功能開關處理。
如果 Chrome 和 Safari 都有連線紀錄,但只有 Chrome 出錯,請記下具體錯誤碼。ERR_PROXY_CONNECTION_FAILED 表示應先確認 Chrome 使用的代理位址是否可連線;若是憑證錯誤,則應檢查系統時間與憑證信任鏈。不要透過忽略憑證錯誤來確認代理是否正常。
終端機無法使用代理:先用 curl 指定代理,再設定 export
終端機不會自動讓所有指令使用 macOS 系統代理。先用 curl 明確指定本機代理,排除工具設定差異。以下範例假設 Clash 用戶端的本機 HTTP 或混合連接埠是 7890。兩個指令使用相同目標,並各自設定 15 秒逾時。
curl -q -vI --max-time 15 --noproxy "" --proxy http://127.0.0.1:7890 https://example.com/
curl -q -vI --max-time 15 --noproxy '*' https://example.com/
將 -q 放在第一個參數的位置,讓 curl 略過預設設定檔。第一個指令使用空的略過清單,強制這次請求使用指定代理;可在輸出中尋找 CONNECT example.com:443,並與用戶端紀錄比對。如果一開始就顯示無法連線至 127.0.0.1,先檢查監聽連接埠;如果隧道建立後才出錯,再檢查 TLS 或網站回應。第二個指令只會讓 curl 不使用應用程式層的代理;若同時啟用了 TUN,流量仍可能由虛擬網卡接管。
只在目前的 shell 工作階段設定代理變數
export http_proxy='http://127.0.0.1:7890'
export https_proxy='http://127.0.0.1:7890'
export no_proxy='localhost,127.0.0.1,::1'
curl -q -vI --max-time 15 https://example.com/
https_proxy 中的 http:// 指的是終端機連線至本機代理所用的通訊協定,不是目標網站的通訊協定。連線 HTTPS 網站時,curl 可透過 HTTP 代理送出 CONNECT,再於隧道中與目標建立 TLS 連線。這裡使用小寫變數,尤其不要只設定 HTTP_PROXY:curl 不會在 HTTP 請求中讀取這個大寫變數。
這些變數只會影響目前的 shell,以及之後從該 shell 啟動且支援相應變數的程式。明確指定代理可以連線、移除參數後卻不行時,先確認是否在同一個終端機視窗匯出變數,再檢查既有的 NO_PROXY、ALL_PROXY 或工具本身的設定。curl 成功不代表 Git 的 SSH 連線也會使用相同代理;如果儲存庫網址以 git@ 或 ssh:// 開頭,請另外檢查 SSH 設定。
暫時測試完成後,執行 unset http_proxy https_proxy no_proxy 即可移除這次設定;如果測試覆蓋了原有值,請還原原值。先確認設定有效,再考慮寫入 shell 啟動檔,否則關閉 Clash 用戶端後,新開的終端機仍可能把請求送往已停止監聽的連接埠。
何時需要 TUN 模式
Safari 和 Chrome 已正常運作,只有特定命令列工具失敗時,優先使用該工具支援的代理設定,不必一開始就啟用 TUN。只有目標應用既不使用系統代理,也沒有可用的應用程式內代理選項時,再確認用戶端是否支援透過 TUN 接管這類流量。
TUN 會透過虛擬網卡和路由接管流量,但仍受路由範圍、排除項目和出站規則影響。測試時一次只變更一項:先保留相同的測試網址,記下原本的系統代理和終端機變數狀態;再依用戶端說明啟用 TUN,確認相同請求是否出現在連線紀錄中。如果啟用後公司內網、區域網路或 VPN 異常,先關閉 TUN 並還原原設定,再檢查路由衝突,不要把出站模式改成全域。
重新檢查時,可依三個狀況快速定位:請求沒有到達本機連接埠,檢查系統或應用程式設定;已到達連接埠但走 DIRECT,檢查符合的規則;已選擇代理出口但連線失敗,檢查出口和記錄。每次使用相同網址和連接埠,才能判斷是哪項變更生效。