適合已啟動 v2rayN,但瀏覽器和終端機的連線狀況不一致的使用者。先用 curl 明確指定本機代理,確認連接埠與通訊協定可用,再分別檢查瀏覽器使用的代理來源,以及終端機程序的環境變數。文中提供 Windows 監聽查詢範例,macOS 和 Linux 也可用 curl 進行對照測試。
本機監聽:確認應用程式連線的連接埠
系統代理會將代理位址提供給會讀取系統設定的應用程式,但不會自動接管每個程序。應用程式可能讀取系統設定,也可能使用自己的代理設定,或直接連線。只有要求抵達 v2rayN 後,核心才會依路由規則決定透過代理連線或直接連線。因此,「應用程式已連上本機連接埠」和「要求已透過代理連線」是兩回事。
開啟 v2rayN 的「設定」→「參數設定」,查看本機監聽連接埠。如果目前版本分別顯示 HTTP 和 SOCKS 連接埠,請依通訊協定記下各自的連接埠;只有明確設定為混合監聽時,才能用同一個連接埠測試兩種通訊協定。以下以 127.0.0.1:10808 為例,請依實際設定替換,並在執行 v2rayN 的同一個系統環境中測試。
在 Windows PowerShell 中查詢監聽狀態。如果結果只有 ::1,表示該監聽記錄對應的是 IPv6 迴圈位址,不能據此判定 127.0.0.1 可用。如果結果列出多個程序或曾變更連接埠,請依實際連接埠和程序 ID 確認所屬程序,不要只憑連接埠號碼判定它是 v2rayN 的核心。
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
明確指定代理:用 curl 進行對照測試
以下指令使用 curl 8.x 常見的參數。先執行 curl --version,確認呼叫的是 curl。Windows 使用者可在命令提示字元中執行以下三行,避免部分 PowerShell 環境將 curl 解讀為別名,或傳遞參數時遺失空字串。macOS 和 Linux 則可直接在常用終端機中執行。
curl --disable -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10808 https://example.com/
curl --disable -v --max-time 15 --noproxy "" --proxy socks5h://127.0.0.1:10808 https://example.com/
curl --disable -v --max-time 15 --noproxy "*" https://example.com/
前兩行分別測試 HTTP 和 SOCKS,請只執行符合實際監聽類型的指令。將 --disable 放在最前面,可略過 curl 的預設設定檔。--noproxy "" 會清除本次要求的目標排除清單。第三行讓 curl 不使用應用程式層級的代理,作為對照;如果系統另有流量接管機制,這一行無法證明封包最終是直接連線。
HTTP 代理處理 HTTPS 目標時,會先接收 CONNECT example.com:443。代理回覆 200 Connection established 只代表通道已建立,仍需檢查後續的 TLS 交握與目標回應。socks5h 會將目標主機名稱交由 SOCKS 代理解析,和由 curl 先解析目標名稱的 socks5 不同。如果兩者結果不一致,請記錄差異,不要同時調整連接埠、路由和 DNS。
結論:先用明確指定的代理縮小問題範圍
如果明確指定代理的指令能取得目標回應,但同一個終端機中的一般指令失敗,請先檢查一般指令如何選擇代理。如果要求尚未連上本機監聽,先確認位址、連接埠和監聽程序,不必急著修改瀏覽器設定。
瀏覽器:區分擴充功能與系統設定
停用代理擴充功能
在目前瀏覽器設定檔的擴充功能管理頁面,暫時停用具備代理控制功能的擴充功能。不要只看擴充功能圖示,因為網域比對規則仍可能讓不同網站採用不同的連線方式。若瀏覽器受組織政策管理,請先確認是否有設定遭到鎖定。
確認瀏覽器的代理來源
在 Firefox 中,前往「設定」→「一般」→「網路設定」→「設定…」,查看目前使用的代理來源。若要測試系統代理,請選擇使用系統代理設定;若要測試手動設定,請依監聽類型填入相應的位址和連接埠。不要將 SOCKS 連接埠填入 HTTP 代理欄位。
確認系統代理設定
在 Windows 開啟「設定」→「網路和網際網路」→「代理伺服器」。如果 v2rayN 系統匣選單中的「系統代理」設為「自動設定系統代理」,請在系統設定頁確認實際寫入的代理位址、連接埠和例外項目。如果使用設定指令碼,請確認目標網域是否被判定為直接連線。
重新測試同一個網址
回到同一個瀏覽器設定檔,重新載入 curl 測試過的網址,並在 v2rayN 記錄中確認要求時間與目標網域。如果需要重新啟用代理擴充功能,請每次只啟用一個,再測試同一個目標,避免混淆系統設定與擴充功能規則的變動。
如果瀏覽器能開啟網頁,但 v2rayN 記錄中找不到相應要求,請先確認目前的記錄層級是否會記錄連線,再排除頁面快取和既有連線的影響。網頁能開啟不代表瀏覽器使用了系統代理;要求也可能直接連到目標,或透過瀏覽器自行設定的代理送出。
終端機:檢查程序讀取了哪些環境變數
即使瀏覽器會讀取系統設定,命令列工具仍可能只讀取自己的設定或環境變數。對 curl 而言,連線至 HTTPS 目標時通常會檢查 https_proxy;如果沒有適用的通訊協定專用變數,則可能改用 all_proxy。no_proxy 用於排除目標。curl 的 HTTP 目標代理變數應使用小寫 http_proxy;不要將此規則套用到所有工具。
請在發生錯誤的終端機中檢查變數,而不是在另一個視窗裡檢查。以下兩段指令只會列出變數名稱,避免將可能含有憑證的代理位址直接貼進支援單。
# Windows PowerShell
Get-ChildItem Env: | Where-Object {
$_.Name -match '^(http_proxy|https_proxy|all_proxy|no_proxy)$'
} | Select-Object -ExpandProperty Name
# macOS 或 Linux:在常見的 POSIX 相容 Shell 中執行
env | cut -d= -f1 | grep -Ei '^(http_proxy|https_proxy|all_proxy|no_proxy)$'
- 檢查舊值。在本機查看變數中的主機、連接埠和通訊協定。透過 HTTP 代理連線至 HTTPS 目標並建立通道時,
https_proxy的值可以是http://127.0.0.1:10808。變數名稱表示目標通訊協定,值中的通訊協定才表示如何連線至代理。 - 檢查例外清單。如果一般指令失敗,但使用
--noproxy ""的明確指定代理指令成功,請確認目標是否符合no_proxy規則。*會讓 curl 對所有目標略過代理。請勿為了測試而永久清除工作環境所需的例外清單。 - 檢查環境變數繼承。變更變數後,請從已更新環境變數的父程序重新啟動實際發出要求的工具。編輯器內建終端機、背景工作和獨立終端機可能繼承不同的值。在容器或遠端終端機中,
127.0.0.1也不一定指向執行 v2rayN 的主機。
常見錯誤:依失敗階段逐一排查
錯誤:curl: (7) Failed to connect to 127.0.0.1 port 10808
原因:curl 未能與範例中的本機連接埠建立 TCP 連線。處理方式:查詢相同位址和連接埠的監聽記錄,再確認 v2rayN 是否已啟動核心,以及指令是否在相同的系統環境中執行。
錯誤:curl: (56) CONNECT tunnel failed, response 407
原因:回應中的 HTTP 代理要求驗證。處理方式:確認 curl 是否連到預期的代理;如果連到舊的代理位址,請修正代理設定;如果確實需要驗證,請依該代理的授權方式設定。
錯誤:curl: (6) Could not resolve host: example.com
原因:curl 需要解析目標網域名稱時,本次要求發生失敗。處理方式:先查看詳細輸出,確認要求是否因例外規則而直接連線,或是否使用了由 curl 解析目標名稱的 SOCKS 模式。
如果瀏覽器和明確指定代理的 curl 都已連上本機連接埠,但仍無法存取同一個目標,請依測試時間在 v2rayN 記錄中搜尋目標網域。先區分本機入站、路由比對和對外連線,再檢查符合的規則或錯誤。此時更換瀏覽器擴充功能通常無法解決對外連線失敗。
重新測試時,請保留三項結果:明確指定代理是否收到目標回應、瀏覽器使用哪裡的代理設定,以及原本的終端機能否重現問題。每次只變更一項。問題排除後,請恢復暫時停用的擴充功能或測試時調整的設定,再用原本失敗的操作驗證一次。