2026-10-21 · 疑難排解 · 約 8 分鐘

V2Ray 系統代理無法使用:瀏覽器與終端機命令列分開排查

瀏覽器能連線,終端機卻不行,或情況正好相反?本文分別檢查瀏覽器擴充功能衝突與 PAC 設定,以及終端機的 http_proxy 環境變數和本機連接埠,逐步找出系統代理失效的原因。

本文重點

桌面環境中,瀏覽器和命令列的連線結果不一致時,可先用 curl 明確連線至 v2rayN 本機代理,再分別檢查瀏覽器使用的代理來源,以及終端機程序的環境變數。如此可判斷問題屬於應用程式未使用代理、本機連接埠無法連線,或請求進入核心後出站失敗。

先確認本機代理入口

系統代理並非接管所有流量,而是提供一組代理設定,只有讀取並採用這組設定的應用程式才會透過代理傳送請求。瀏覽器可能使用作業系統設定,也可能使用自己的代理設定;命令列工具則可能只讀取參數、環境變數或自己的設定檔。v2rayN 的系統代理狀態和核心的監聽狀態也要分開確認:系統填入代理位址,不代表該連接埠上確實有服務在監聽。

應用程式請求代理選擇本機監聽路由比對連線目標

在 v2rayN 的「設定」→「參數設定」中確認本機監聽相關欄位,並查看核心啟動記錄。以下列出兩種範例設定,並非對目前版本預設值的說明。使用混合監聽時,HTTP 和 SOCKS 請求可能共用同一個連接埠;若使用分開監聽,請依實際協定填寫,不要只因連接埠號碼相近就互相替換。

10809
HTTP 範例監聽連接埠
10808
SOCKS 範例監聽連接埠

以下使用 HTTP 監聽執行基準測試。請先將範例連接埠替換成實際使用的連接埠;若在 Windows PowerShell 執行,請使用 curl.exe,避免命令被交給同名別名。後續測試請使用相同的目標網址,並記下請求時間,以便對照用戶端記錄。

curl -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10809 https://example.com/

--noproxy "" 可排除既有略過清單對本次測試的影響。詳細輸出中的 Connected to 127.0.0.1 只表示已連上本機連接埠;接著還要確認 CONNECT 是否成功,以及目標是否有回應。即使收到目標回應,也不能僅憑這點判定請求是由遠端節點轉送:核心仍可能依路由規則選擇直連。

瀏覽器無法使用代理:檢查擴充功能與 PAC

若明確指定代理的請求成功,但瀏覽器仍無法連線,請先找出瀏覽器實際使用的代理來源。擴充功能、瀏覽器本身的設定與作業系統設定可能同時生效。每次只調整一項,否則即使恢復連線,也很難判斷是哪項設定發揮作用。

  1. 確認代理來源

    在 Windows 中先查看「設定」→「網路和網際網路」→「Proxy」,分別記下設定指令碼和手動 Proxy 設定。Firefox 可在「設定」→「一般」→「網路設定」→「設定」中確認目前使用的是系統 Proxy、手動設定,還是自動設定網址。

  2. 停用代理擴充功能以進行隔離測試

    在有權限管理的瀏覽器設定中,暫時停用用來管理代理或切換規則的擴充功能,再重新開啟相同目標。不要以無痕視窗作為隔離的證明,因為部分擴充功能仍可獲准在無痕視窗中執行。由組織政策管理的設定,應請管理員協助檢查。

  3. 檢查 PAC 規則

    若使用自動設定指令碼,請先確認指令碼網址能否載入,再檢查目標網域符合的是代理項目還是 DIRECT。後者表示規則要求瀏覽器直連;若符合代理項目,請確認其中的位址和連接埠仍與本機監聽設定一致。

  4. 以相同目標重新測試

    關閉舊分頁後重新發出請求,並參照用戶端可用的連線記錄核對時間和目標。若只有單一網域連線失敗,請先檢查該網域的略過清單或 PAC 比對條件,不要把局部規則問題誤判為整體系統代理失效。

PAC 和用戶端路由分流是在不同位置運作。PAC 回傳直連時,請求通常不會進入本機代理;用戶端路由選擇直連時,請求已進入核心,只是出站連線未經節點轉送。若要判斷是哪一層做出選擇,不能只看網頁能否開啟,也要確認瀏覽器的代理來源,以及用戶端記錄中的出站結果。

終端機無法使用代理:檢查環境變數與協定

瀏覽器正常、curl 卻無法連線時,先在同一個終端機中比較明確指定代理和未指定代理的請求。若只有明確指定代理時能連線,通常不必調整本機監聽設定,應先檢查目前程序是否取得代理設定。桌面環境的代理開關不會自動為每個 shell 設定環境變數;從編輯器、終端機或服務啟動的程序,也可能繼承不同的環境。

設定在 curl 中的用途排查重點
http_proxy為 HTTP 目標指定代理在區分大小寫的環境中使用小寫;curl 不接受大寫的 HTTP_PROXY
https_proxy為 HTTPS 目標指定代理變數名稱表示目標協定,變數值的前綴則表示連線至代理所使用的協定
all_proxy未設定對應協定的代理時,提供備用代理確認是否仍指向已停用的舊連接埠
no_proxy列出略過代理的目標確認測試網域或萬用字元是否讓請求改為直連

例如,本機入口是一般 HTTP 代理時,即使目標使用 HTTPS,https_proxy 的值仍可設為 http://127.0.0.1:10809。curl 會向 HTTP 代理傳送 CONNECT,再透過通道與目標建立 TLS 連線。不要因為目標網址以 HTTPS 開頭,就把本機代理位址也改成 HTTPS。

# macOS、Linux:變數僅套用於這次 curl 呼叫
https_proxy=http://127.0.0.1:10809 curl -v --noproxy "" https://example.com/

# Windows PowerShell:先列出目前工作階段中的代理變數
Get-ChildItem Env: | Where-Object Name -Match '^(http|https|all|no)_proxy$'

結論:先確認設定的生效範圍,再寫入永久設定

單次變數測試成功後,再將驗證過的設定加入實際啟動該工具的環境。只在互動式終端機有效的設定,不應視為背景工作或編輯器整合終端機的設定。

若使用 SOCKS 入口,可將基準命令中的代理參數替換為 --proxy socks5h://127.0.0.1:10808。對 curl 而言,socks5h 會將目標主機名稱交由代理解析,socks5 則由 curl 在本機解析。兩者結果不同,表示應檢查解析位置和代理端的解析設定,但不足以單憑此結果判定某個 DNS 服務故障。

根據錯誤訊息判斷失敗階段

判斷時優先查看第一則錯誤訊息,以及它之前嘗試連線的目標。相同的逾時提示,可能發生在連線至本機連接埠、等待代理建立通道,或等待目標回應時。將詳細輸出與同一時間的核心記錄一起檢視,比反覆切換節點更能縮小問題範圍。

Connection refused

原因與解法:若連線至 127.0.0.1 時遭到拒絕,請先確認該連接埠是否由核心監聽。檢查啟動記錄和監聽位址,尤其是命令在虛擬機器或容器中執行時,其回送位址通常不是桌面主機的回送位址。

Could not resolve proxy

原因與解法:curl 無法解析的是代理位址中的主機名稱,而非目標網站。請檢查代理變數是否仍保留舊主機名稱;若核心在相同網路環境中監聽 IPv4 回送位址,可搭配實際連接埠使用 127.0.0.1 重新測試。

CONNECT tunnel failed, response 502

原因與解法:HTTP 代理回覆了 CONNECT,但傳回 502,表示通道未能建立。請先確認監聽中的程序是預期的核心,再檢查同一請求對應的出站連線、目標解析和連線記錄;單憑狀態碼無法判定是哪個步驟失敗。

重新測試並還原設定

若兩種方式都無法透過明確設定完成請求,請返回連線故障疑難排解檢查核心與出站連線;若請求已進入核心,但直連與代理路徑不符合預期,請參閱路由分流說明。提交排查記錄時,請保留連接埠類型、錯誤發生階段和必要的記錄片段,並移除訂閱網址、驗證資訊,以及記錄中不宜公開的請求內容。

用戶端下載與安裝