V2Ray 系統代理無效怎麼排查？瀏覽器能連線、終端機卻不行

一、系統代理只設定代理，不會接管所有連線

v2rayN 的「設定系統代理」會將本機代理位址寫入作業系統的相關設定。應用程式是否讀取這些設定，取決於應用程式本身。瀏覽器通常會讀取系統代理，但許多命令列工具使用的是環境變數或自己的設定檔。因此，瀏覽器能連上同一個網址，不代表終端機也已透過代理連線。

這條連線路徑有三個互相獨立的環節：應用程式是否使用代理、本機連接埠能否接收要求，以及核心最後選擇哪條輸出路徑。V2Ray 或 Xray 負責核心處理，v2rayN 負責桌面端的設定與管理。VMess、VLESS 等是伺服器連線協定，不是瀏覽器代理類型的選項。

本文會先排除應用程式代理設定問題，不會一開始就啟用 TUN。若 TUN 已開啟，直連測試也可能被它接管；若要分辨兩種入口，可先記下原設定，再暫時關閉 TUN 進行比對。

二、先確認 v2rayN 監聽的連接埠，再測試明確指定代理

先查看 v2rayN 主畫面的本機連接埠資訊，並在「設定」→「參數設定」中確認本機監聽設定。不同版本的欄位名稱和預設值可能不同，別只依舊教學認定 HTTP 連接埠一定是 10809。以下假設 127.0.0.1:10808 是支援 HTTP 的混合入口；若實際入口只支援 SOCKS，請改用後文的 SOCKS 指令。

1. 確認核心正在執行

   在主畫面選取要使用的伺服器，查看記錄檔是否出現啟動失敗或連接埠遭占用的訊息。更新訂閱只會更新伺服器資料，不代表連線已成功建立。

2. 確認本機連接埠

   開啟「設定」→「參數設定」，記下實際監聽連接埠及支援的入口類型。儲存變更後，確認核心已重新載入設定。

3. 檢查連接埠是否正在監聽

   在 Windows PowerShell 執行下方指令。若沒有監聽結果，先解決核心啟動問題，暫時不必調整瀏覽器設定。

4. 明確指定代理

   使用 curl 的 --proxy 參數直接指定入口，排除「工具究竟讀取哪一份代理設定」的不確定性。

# Windows PowerShell
Get-NetTCPConnection -State Listen -LocalPort 10808

curl.exe -v --connect-timeout 10 --max-time 25 --proxy http://127.0.0.1:10808 --noproxy "localhost,127.0.0.1" https://example.com/ -o NUL

Windows 請使用 curl.exe，避免舊版 Windows PowerShell 將 curl 解讀成其他指令。Linux 與 macOS 請使用 curl，並將輸出目標 NUL 改為 /dev/null。範例的略過清單只包含本機位址，確保目標網址不會因既有的 NO_PROXY 設定而略過代理。

三、瀏覽器排查：檢查擴充功能、手動代理與自動設定

瀏覽器正常、終端機失敗，可能只是瀏覽器另外設定了代理。反過來，明確指定代理的 curl 測試成功、瀏覽器卻失敗，也可能是擴充功能仍指向舊連接埠。先選定一個固定網址，記下瀏覽器目前的代理來源，再逐項調整設定，避免同時更動多項而無從比對。

• v2rayN：在系統匣選單的「系統代理」中選擇「自動設定系統代理」，再確認作業系統實際寫入的位址與連接埠。若使用自動設定指令碼，也要檢查指令碼規則。
• Windows：前往「設定」→「網路和網際網路」→「Proxy」，查看「使用設定指令碼」和「使用 Proxy 伺服器」。記下原有設定，避免其他網路工具反覆覆寫。
• Chrome：前往「設定」→「系統」→「開啟電腦的 Proxy 設定」，確認系統代理入口；再開啟「擴充功能」→「管理擴充功能」，暫時停用代理切換類擴充功能。
• Firefox：前往「設定」→「一般」→「網路設定」→「設定」，確認選用的是「使用系統 Proxy 設定」還是「手動設定 Proxy」。手動模式中的舊連接埠不會隨系統設定自動更新。

自動設定指令碼可依網址指定使用代理或直接連線，系統略過清單也可能排除特定網域。若只有某個網站沒有走代理，先確認目標是否符合這些規則，不要立即更換伺服器。瀏覽器的安全 DNS 設定會影響部分網域的解析方式，但不等同於代理開關。

四、終端機排查：設定 http_proxy 與 https_proxy

命令列工具通常不會因為系統代理已開啟，就自動使用本機入口。先在目前的終端機暫時設定變數，確認可用後再考慮寫入使用者設定檔。以下位址適用於 HTTP 代理或支援 HTTP 的混合入口；即使目標是 HTTPS，代理位址的前綴仍可使用 http://。

Windows PowerShell：只設定目前工作階段

$env:http_proxy = "http://127.0.0.1:10808"
$env:https_proxy = "http://127.0.0.1:10808"
$env:no_proxy = "localhost,127.0.0.1"

Get-ChildItem Env: | Where-Object Name -Match 'proxy'
curl.exe -v --connect-timeout 10 --max-time 25 https://example.com/ -o NUL

設定 $env: 會影響目前的 PowerShell 及其後續啟動的子程序，不會修改另一個已開啟的終端機。若要讓開發工具繼承變數，請從這個工作階段啟動工具，或修改永久環境設定後重新啟動工具。

Linux 與 macOS：在目前的 shell 匯出變數

export http_proxy='http://127.0.0.1:10808'
export https_proxy='http://127.0.0.1:10808'
export no_proxy='localhost,127.0.0.1'

env | grep -i proxy
curl -v --connect-timeout 10 --max-time 25 https://example.com/ -o /dev/null

• https_proxy 表示連線至 HTTPS 目標時使用的代理，不代表代理入口必須啟用 TLS。若將一般 HTTP 入口誤寫為 https://127.0.0.1:10808，可能會發生交握錯誤。
• curl 使用小寫的 http_proxy 作為 HTTP 代理變數；不要只設定大寫的 HTTP_PROXY。在區分大小寫的環境中，也請清除重複且值不相同的變數。
• 目標符合 no_proxy 或 NO_PROXY 設定時，連線會略過代理。特別留意是否包含 *，它可能使所有目標都直接連線。
• 從圖形桌面啟動的程式、管理員程序及背景服務不一定會繼承目前 shell 的變數。有些工具也有專用代理設定，請依工具實際的優先順序確認。

這裡的 127.0.0.1 必須與 v2rayN 位於相同的網路環境。容器、遠端 SSH 工作階段及部分虛擬化環境中的迴路位址，指向的是它們自身，而非桌面電腦。此時不能直接照抄這個位址，也不應為了排查而將代理連接埠開放至公用網路。

五、分辨 HTTP、SOCKS 與 DNS 解析問題

若入口只支援 SOCKS5，卻將它當成 HTTP 代理使用，可能會導致連線重設或協定錯誤。先確認本機入口類型，再使用相應指令。以下的 socks5h 會將目標網域交由代理端解析；一般的 socks5 則通常由 curl 在本機解析目標網域。

# Windows：透過 SOCKS5 入口，將目標網域交由代理端解析
curl.exe -v --connect-timeout 10 --max-time 25 --proxy socks5h://127.0.0.1:10808 --noproxy "localhost,127.0.0.1" https://example.com/ -o NUL

# Linux / macOS
curl -v --connect-timeout 10 --max-time 25 --proxy socks5h://127.0.0.1:10808 --noproxy "localhost,127.0.0.1" https://example.com/ -o /dev/null

錯誤訊息末尾通常還會附上目標位址和更具體的原因，請保留完整內容。若 HTTP 代理已回傳 200 Connection established，只代表 CONNECT 通道已建立，不代表後續 TLS 交握和目標內容要求一定成功。

六、要求進入核心後，檢查路由與伺服器輸出

應用程式連上本機入口，不代表要求一定會經由遠端伺服器輸出。v2rayN 的路由規則可能讓特定網域或 IP 直接連線。瀏覽器和終端機若使用不同網域、不同位址家族或不同重新導向目標，結果可能不同；比對時請固定完整網址。

測試期間可暫時提高記錄層級，但請限制持續時間。分享記錄前，請刪除訂閱網址、使用者識別資訊、造訪網域等敏感內容。若記錄明確顯示遠端交握或驗證失敗，再檢查 VMess、VLESS 等節點參數；這類錯誤與終端機是否讀取系統代理是兩個不同層次的問題。

七、驗證完成後，還原暫時設定

暫時設定的環境變數會留在終端機中，可能導致退出 v2rayN 後，命令列仍嘗試連線至已關閉的連接埠。若這些變數是本次新增的，可依下方方法刪除；若原本已有企業代理或開發環境設定，請還原先前記錄的值，而非直接清空。

# Windows PowerShell：刪除目前工作階段中的暫時變數
Remove-Item Env:http_proxy, Env:https_proxy, Env:no_proxy -ErrorAction SilentlyContinue

# Linux / macOS：刪除目前 shell 中的暫時變數
unset http_proxy https_proxy no_proxy

• 使用同一個網址重新測試瀏覽器和終端機，確認結果符合預期。
• 重新啟用測試前暫停的擴充功能、TUN 或自動設定指令碼；每恢復一項，就確認故障是否再次出現。
• 確實需要長期使用代理時，再將已驗證的設定寫入相應的使用者環境或應用程式設定，並記下連接埠。
• 日後變更本機監聽連接埠時，請同步更新環境變數和瀏覽器手動設定，避免舊設定繼續生效。