故障排除 預計閱讀 7 分鐘

Clash 系統代理沒生效?檢查瀏覽器擴充功能與終端機環境變數

Clash 系統代理無法使用?分別檢查瀏覽器擴充功能、系統設定,以及終端機的 http_proxy 環境變數與命令列工具代理設定。

先測試本機代理連接埠,再檢查應用程式設定

用戶端的「系統代理」開關會設定作業系統的代理,並不代表所有程式的連線都會經過 Clash。排查時可將連線分成兩段:應用程式是否連上本機代理入口;請求進入核心後,規則將它送往哪個出口。瀏覽器無法開啟網頁、終端機命令逾時,以及出口 IP 沒變,可能是不同環節出了問題。

先到用戶端的連接埠設定查看目前的監聽值。以下以 mihomo 的 mixed-port: 7890 為例,這個連接埠可接收 HTTP 和 SOCKS 代理請求;7890 僅供示範,並非所有用戶端的預設值。如果設定分別使用 port 和 socks-port,以下命令請填入 HTTP 入口的 port,不要填控制介面 external-controller 的連接埠。

curl -v --connect-timeout 5 --max-time 15 --noproxy "" --proxy http://127.0.0.1:7890 https://example.com/

在 Windows 上建議使用 curl.exe,避免舊版 Windows PowerShell 將 curl 解讀為別名。舊版 PowerShell 也可能省略傳給外部程式的空字串參數;若因此出現參數錯誤,請改用命令提示字元執行,並將命令開頭改為 curl.exe。這裡的 --noproxy "" 用來清除本次測試所繼承的代理略過清單。

瀏覽器:先檢查代理擴充功能,再確認系統位址

一次只保留一種代理設定來源

在 Chrome 開啟 chrome://extensions/,在 Edge 開啟 edge://extensions/。先停用負責切換代理、依網域選擇路線或寫入 PAC 的擴充功能。擴充功能中的「直連」通常代表明確指定直接連線,不等於「使用系統設定」。若要保留擴充功能,請選擇系統代理模式,並確認沒有其他擴充功能同時接管設定。

測試時重新載入目標頁面,並查看用戶端連線記錄,確認確實產生新請求。必要時完全結束瀏覽器後重新啟動,避免沿用舊連線。不要只憑無痕視窗判斷擴充功能是否已排除:部分擴充功能可在無痕模式中執行,裝置政策也不會因切換視窗而消失。若設定顯示由組織管理,請前往 chrome://policy/ 或 edge://policy/ 查看生效中的政策;受管理裝置請洽管理員處理。

確認作業系統與 Firefox 的個別設定

如果系統位址剛寫入就被改回,請記錄切換前後的值,再檢查是否有其他代理用戶端、網路管理軟體或組織政策正在更新設定。先找出寫入來源,不要同時開啟多個用戶端又反覆切換規則模式。

終端機:比較預設請求與明確指定代理的請求

瀏覽器正常、終端機卻失敗時,請在同一個終端機以相同目標執行上方的明確指定代理命令,再執行 curl -v https://example.com/。如果明確指定代理時成功,但預設請求直接連到目標位址,請優先檢查工具讀取環境變數的方式。以下是 POSIX shell 的暫時設定,只會影響目前的 shell 和之後啟動的子程序:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
curl -v https://example.com/

此處的目標使用 HTTPS,但代理位址仍以 http:// 開頭:前者是連線目標的通訊協定,後者則是連上本機代理的通訊協定。curl 對 HTTP 請求只讀取小寫的 http_proxy,對 HTTPS 請求也支援大寫的 HTTPS_PROXY。如果電腦同時設定了大小寫版本,請確認兩者的值一致;不要假設不同工具遇到衝突時都會採用相同設定。

$env:http_proxy = 'http://127.0.0.1:7890'
$env:https_proxy = 'http://127.0.0.1:7890'
curl.exe -v https://example.com/

以上是 Windows PowerShell 中設定目前程序的方式。已啟動的 IDE、背景服務、容器和其他終端機不會繼承此時的變更。若終端機中的 curl 正常,但 IDE 仍無法下載,請在實際啟動工作的環境中檢查代理設定;若使用 Git,也可以執行 git config --show-origin --get-all http.proxy,確認是否有個別設定及其來源檔案。不要將含有帳號密碼的代理變數或完整記錄直接貼到公開求助文章。

只有特定網域無法使用:分辨略過清單與核心規則

no_proxy 或 NO_PROXY 會在應用程式端生效。例如 curl 讀取到 localhost,127.0.0.1,example.com 時,對 example.com 的請求就會略過已設定的代理。請使用相同 URL 比較一般請求,以及帶有 --noproxy "" 的明確測試;如果只有一般請求略過本機連接埠,再檢查環境變數和工具本身的例外設定。不要只為了修復單一網域,就永久清空公司內網的略過清單。

核心規則則會在請求進入 Clash 後生效。查看連線記錄時,請對照請求時間、網域、命中的規則和出口鏈。如果記錄顯示命中 DIRECT,請確認這條規則是否排在預期規則之前;若命中代理策略群組但連線失敗,請檢查群組目前選用的項目,以及該出口是否可連線。在規則模式下通常會依清單順序比對;範圍過廣的規則若排在前面,後面的特定規則可能就不會生效。

修復後再次測試:以相同目標確認兩條連線路徑

  1. 保留已確認可用的本機連接埠,選一個曾出問題的 URL。先讓瀏覽器依平常設定連線一次,再於終端機執行不帶 --proxy 的命令。分別查看兩次連線的用戶端記錄,不要只看網頁是否開啟。
  2. 如果只有瀏覽器沒有記錄,請回頭檢查擴充功能、政策、系統指令碼和瀏覽器例外設定;如果只有終端機沒有記錄,請檢查變數、工具設定和程序的執行環境。如果兩者都有記錄,接下來就從出口或目標服務著手排查。
  3. 關閉暫時測試用的終端機,即可清除這次設定的環境變數;若有修改永久設定,請依原先記錄還原不需要的變更。重新開啟實際使用的終端機和瀏覽器,再測試一次,確認修復不依賴某個舊視窗。

再次測試仍失敗時,請記錄作業系統、用戶端與核心版本、入口類型和連接埠,以及錯誤發生在本機連線、CONNECT、TLS 或目標回應階段。設定欄位的說明請參閱設定欄位文件。求助時提供這些資訊,比只說「已開啟但流量沒走代理」更容易找出問題。

下載Clash