先確認 Clash 的本機代理連接埠
用戶端的「系統代理」開關,通常只是將本機代理位址寫入作業系統。瀏覽器可能會讀取這項設定,也可能被擴充功能、手動設定或管理政策覆寫。命令列工具則各自有不同的設定來源:瀏覽器能連線,不代表同一台電腦上的終端機也會使用相同連接埠。
- 先查看用戶端顯示的核心執行狀態與目前連接埠。使用 Clash 或 mihomo 核心的用戶端中,
mixed-port是同時接受 HTTP 和 SOCKS 連線的混合連接埠;port是 HTTP 代理連接埠,socks-port則是 SOCKS 代理連接埠。以下以 HTTP 或混合連接埠7890為例;若執行畫面顯示7897,請一併替換命令中的連接埠。 - 位址使用
127.0.0.1的前提是,用戶端與測試程式位於同一個系統環境。請勿將控制器連接埠(例如9090)當成代理連接埠。WSL、虛擬機器與容器中的127.0.0.1不一定能連到主機,請先在主機的終端機確認連線正常,再分別排查。 - 開啟用戶端的連線記錄或日誌,再送出一次測試請求。找到目標網域後,接著查看命中的規則,以及最後使用的是
DIRECT還是代理節點。在規則模式下命中DIRECT,只表示這個請求透過 Clash 直連,並不代表應用程式沒有連上 Clash。
瀏覽器代理無效:檢查系統位址、擴充功能與例外清單
不只要確認用戶端已開啟,也要檢查系統代理位址
- Windows 11:前往「設定」→「網路和網際網路」→「Proxy」,在「手動設定 Proxy」下確認「使用 Proxy 伺服器」的位址與連接埠是否和用戶端一致。如果另有「使用設定指令碼」,請先確認是否為公司或組織提供的設定,不要直接刪除。
- macOS 13 及以上版本:前往「系統設定」→「網路」→選取目前使用的網路服務→「詳細資訊」→「代理伺服器」。Wi‑Fi 與有線網路需分別檢查;確認 HTTP 和 HTTPS 的代理設定,並檢查要測試的網域是否列在略過代理的清單中。
- Firefox:前往「設定」→「一般」→頁面底部的「網路設定」→「設定」。若要使用作業系統的代理設定,請確認選取「使用系統 Proxy 設定」,而非「不使用 Proxy」、舊的手動位址或其他自動代理設定。
使用同一個網址,找出是哪一層覆寫代理設定
在 Chrome 的 chrome://extensions/ 或 Edge 的 edge://extensions/ 停用自行安裝的代理切換擴充功能,再開啟新分頁前往 https://example.com/,並比對 Clash 同一時間的連線記錄。無痕視窗不能取代這個步驟:允許在無痕模式中執行的擴充功能仍可能生效。若瀏覽器顯示由組織管理,可前往 chrome://policy/ 或 edge://policy/ 查看是否有代理政策;受管理的設定應向管理員確認。
若只有特定網站異常,請用該網站的實際網域重新測試。首頁、登入導向與圖片可能來自不同網域,請在連線記錄中找出失敗的請求。如果記錄中已出現目標網域,先檢查命中的規則與節點錯誤;若沒有,則確認系統例外清單、瀏覽器代理設定,以及頁面是否只是從快取載入。
終端機代理無效:先用 curl 指定代理進行比對
以下兩個命令會要求同一個 HTTPS 網址。第一個命令讓 curl 不使用代理;第二個則明確連線至本機 HTTP 代理,並將這次請求的代理例外限制為兩個本機位址,避免既有的 NO_PROXY=* 讓測試略過代理。兩個命令都設定了 8 秒連線逾時與 15 秒總逾時。Windows PowerShell 請將 curl 改寫為 curl.exe,避免舊版 PowerShell 將它解析成其他命令。
curl --noproxy "*" -v -I --connect-timeout 8 --max-time 15 https://example.com/
curl --proxy http://127.0.0.1:7890 --noproxy "localhost,127.0.0.1" -v -I --connect-timeout 8 --max-time 15 https://example.com/
| 第二個命令的結果 | 下一步 |
|---|---|
連線 127.0.0.1:7890 遭拒 | 確認核心是否正在執行、連接埠是否填錯,以及終端機與核心是否位於同一個系統環境。此時尚未連線至目標網站。 |
已連上本機連接埠,但 CONNECT 失敗 | 確認使用的是 HTTP 或混合連接埠,再檢查 Clash 日誌中的規則、節點連線與目標解析錯誤。 |
已建立 CONNECT,但接著發生 TLS 錯誤 | 請區分通道是否已建立,以及目標網站的憑證是否通過驗證。檢查系統時間、目標網域與工具的憑證信任設定,請勿以關閉憑證驗證作為修復方式。 |
| 已收到目標網站的 HTTP 回應 | 這次請求已使用明確指定的代理。還要查看連線記錄,確認流量是經過代理節點還是 DIRECT;兩個命令都成功也可能是正常情況。 |
如果實際設定只有 SOCKS 連接埠,例如 1080,可將第二個命令的代理參數改為 --proxy socks5h://127.0.0.1:1080,讓 curl 將目標主機名稱交由 SOCKS 代理解析。不要在同一個連接埠上反覆切換通訊協定碰運氣,先確認該連接埠對應的設定欄位。
明確指定代理可用後,再檢查環境變數與工具設定
如果加上 --proxy 就能連線,移除後卻不行,請先確認工具讀取哪些設定。對 curl 而言,可在目前的終端機暫時設定 http_proxy 和 https_proxy。環境變數名稱依目標 URL 的通訊協定而異;即使造訪的是 HTTPS 網站,只要本機代理入口使用 HTTP,變數值仍應以 http:// 開頭。curl 對 HTTP 目標只會讀取小寫的 http_proxy;在區分大小寫的系統中,請勿只設定 HTTP_PROXY。
Bash 或 zsh:只為單次命令設定
http_proxy=http://127.0.0.1:7890 \
https_proxy=http://127.0.0.1:7890 \
no_proxy=localhost,127.0.0.1 \
curl -v -I --connect-timeout 8 --max-time 15 https://example.com/
PowerShell:在新視窗中暫時設定
$env:http_proxy = 'http://127.0.0.1:7890'
>$env:https_proxy = 'http://127.0.0.1:7890'
>$env:no_proxy = 'localhost,127.0.0.1'
>curl.exe -v -I --connect-timeout 8 --max-time 15 https://example.com/
這些 PowerShell 設定只會影響目前的處理程序及其後續啟動的子處理程序;測試完成後關閉測試視窗即可。如果 curl 已能連線,但 Git 或 npm 仍然失敗,請檢查工具是否保存了舊位址:Git 可用 git config --show-origin --get-regexp '^http\..*proxy$' 查看設定來源;npm 可分別執行 npm config get proxy 和 npm config get https-proxy 查看設定。輸出內容可能包含代理憑證,請勿原樣貼到公開求助文章。
如果只有編輯器的整合式終端機無法連線,請先在獨立終端機執行相同測試。已經執行中的編輯器不會自動收到其他視窗暫時設定的變數;請在實際執行命令的終端機中設定,或修改永久設定後重新啟動編輯器。先暫時測試,再決定是否寫入啟動檔,以免用戶端關閉後,工具仍嘗試連線到已失效的本機連接埠。
檢查過系統代理與終端機後,何時才需要檢查 TUN
如果瀏覽器和帶有 --proxy 的 curl 都能連上 Clash,只有某個程式沒有代理選項,也不會讀取系統代理或環境變數,這時才值得檢查用戶端是否支援 TUN。TUN 會在系統路由層接管流量,適用範圍取決於核心、權限、路由與 DNS 設定。它無法修復本機監聽失敗、規則選錯目標或節點連線逾時。
完成前,只需重新測試原本失敗的程式與網域,確認請求已進入 Clash,並確認最終出口符合預期。若需進一步求助,請記下作業系統、用戶端與核心版本、實際使用的連接埠與通訊協定、失敗的 curl 命令,以及當時對應的規則或錯誤訊息。移除訂閱網址與憑證後,提供這些資訊比只貼一張「系統代理已開啟」的截圖更容易找出問題。