適合遇到核心啟動失敗、節點連線逾時或網頁無法開啟的 v2rayN 使用者。以下以 Windows 搭配 Xray 核心為例:先擷取一次失敗時的日誌,再根據錯誤中的位址與操作,分辨本機監聽、網域解析、遠端連線或 TLS 交握問題;每次只改一項設定,再重新測試。
開啟執行日誌,記錄一次失敗
先查看 v2rayN 主視窗中的日誌區。畫面可能同時顯示用戶端操作訊息與核心輸出:訂閱更新失敗代表取得訂閱連結時出錯;核心撥號失敗則代表某次網路連線失敗。即使兩則訊息緊接在一起,也不一定來自同一個要求。
固定測試條件
保留目前使用的節點、路由設定與連線方式,記下系統代理或 TUN 的狀態。若是啟動失敗,就只重現啟動問題;若網頁無法開啟,就單獨重新載入原本可正常存取的頁面。不要同時執行批次測速或更新訂閱。
確認日誌層級
開啟「設定」→「參數設定」,在核心基本設定中找到日誌層級。以 Xray 為例,
warning適合先檢查已記錄的警告與錯誤;需要查看連線處理過程時,再切換至info。介面欄位位置可能隨用戶端版本而異,請先確認目前連線使用的核心。套用設定後重現問題
儲存設定,並確認核心已重新載入設定;記下操作時間後,再重現一次問題。擷取同一時段內包含要求與失敗原因的幾行日誌;若行中有要求編號,優先比對相同編號,避免將背景要求的錯誤誤認為這次故障。
保留關鍵欄位
記下失敗發生在
listen、lookup、dial還是憑證驗證階段。對外分享日誌前,請遮蔽訂閱連結、使用者識別資訊、實際網域名稱與公網 IP 位址;但要保留連接埠、錯誤內容,以及位址屬於本機還是遠端。
常見錯誤:逾時、拒絕連線與交握失敗
以下列出的是方便搜尋的錯誤片段,不一定是每個核心輸出的完整句子。同一行若包含多層錯誤,先找出含有具體位址或失敗操作的內層原因,再回頭確認外層是哪個入站、出站或要求發生錯誤。
錯誤:i/o timeout
原因:某項網路操作未能在時限內完成,可能是連線至遠端,也可能是讀取資料或等待解析。
處理方式:如果同一行包含 dial tcp,請依該行的位址確認節點遠端主機與連接埠,並測試 TCP 連線;如果出現 lookup,先檢查 DNS 解析流程。
錯誤:no such host
原因:發出查詢的一方未取得該主機名稱的有效解析結果;發生錯誤的名稱不一定是瀏覽器正在存取的網站。
處理方式:先確認 lookup 後方的完整主機名稱與節點設定,再比較系統解析和核心使用的 DNS 路徑。不要只因系統查詢成功,就排除核心解析發生問題的可能。
錯誤:connection refused
原因:連線遭到拒絕,常見原因是目標連接埠沒有程式監聽,也可能是中間設備主動拒絕連線。
處理方式:若目標是 127.0.0.1,請確認應用程式使用的連接埠與核心監聽連接埠;若目標是遠端,請確認訂閱中的連接埠,並向服務提供者確認該連接埠是否正在監聽。
錯誤:x509: certificate signed by unknown authority
原因:TLS 已進入憑證驗證階段,但連線使用的信任鏈無法驗證對端憑證。
處理方式:先確認日誌中的 TLS 對端是節點還是目標網站,再檢查憑證鏈與本機信任設定。不要透過略過驗證來消除錯誤。
錯誤:remote error: tls: handshake failure
原因:遠端在 TLS 交握階段回傳失敗警示;單憑這則通用錯誤,無法判斷是哪項參數不相符。
處理方式:使用 TLS 的節點,請依服務端提供的設定逐項比對傳輸類型、TLS 開關與伺服器名稱(SNI)。必要時請服務提供者比對同一時間的服務端日誌。
本機連接埠占用:確認監聽程序後再變更連接埠
核心啟動時若出現 address already in use,或 Windows 的 Only one usage of each socket address,請先抄下綁定失敗的位址與連接埠。以下兩個連接埠僅用來說明日誌中不同的位置;排查時請以自己的設定與錯誤訊息為準。
判斷方式:只修改錯誤對應的一端
若錯誤是 listen tcp 127.0.0.1:10808,請檢查本機監聽程序,不要修改訂閱中的遠端連接埠;若 dial tcp 連往遠端的 443 時發生逾時,變更本機連接埠也無法恢復遠端連線。
在 Windows PowerShell 中查詢 TCP 監聽程序。將第一行中的數字替換成日誌裡綁定失敗的連接埠;如果日誌明確指出是 UDP,請使用 Get-NetUDPEndpoint -LocalPort $port 查詢對應端點。
$port = 10808
Get-NetTCPConnection -LocalPort $port -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
- 將
OwningProcess與工作管理員「詳細資料」頁面中的 PID 比對。如果監聽位址是0.0.0.0,也要確認它是否與核心嘗試綁定的本機位址衝突。 - 確認占用連接埠的是重複啟動的用戶端後,先從系統匣正常結束多餘的執行個體。若連接埠由仍需執行的程式占用,請在 v2rayN「設定」→「參數設定」中修改對應的本機監聽連接埠,並同步更新手動設定該連接埠的應用程式。
- 重新啟動核心後,再次確認監聽狀態與程序是否已綁定預期連接埠,然後重新嘗試開啟網頁。若連接埠已在監聽但頁面仍無法開啟,請接著檢查新要求的入站與出站日誌,不要反覆更換連接埠。
核心已啟動:分辨流量接管、路由與遠端連線
核心成功啟動,只代表程序可以執行;不代表瀏覽器要求已進入核心,也不代表節點或目標網站可以連線。暫時將日誌層級切換至 info,使用相同網址與連線方式重現問題,並觀察以下三個位置。
- 檢查入站。如果找不到與這次操作相符的連線紀錄,請先確認應用程式是否使用系統代理,或是否手動指定正確的本機連接埠。使用 TUN 時,則要確認 TUN 是否成功啟動,以及該流量是否經過 TUN。先確認目前的連線方式,不要同時切換兩種模式。
- 檢查出站。出現入站紀錄後,如果日誌顯示出站標籤,請將標籤與目前的路由規則比對。預期經由節點轉送的網域若命中直連規則,應先檢查規則是否命中及排列順序,不要直接修改節點的憑證參數。
- 檢查遠端。如果已確認要求選擇了預期的出站,且失敗發生在連線至 TCP 節點時,可使用 PowerShell 的
Test-NetConnection測試該節點的主機與實際連接埠。此測試只能確認目前環境能否建立 TCP 連線,無法證明 TLS、協定驗證或目標網頁正常,也不適合用來判斷 UDP 傳輸是否可用。
修改後使用原本的節點與網址重新測試,並比對同一階段的日誌:如果原本的撥號逾時變成憑證錯誤,代表排查已進入下一階段,不表示連線已修復。確認網頁恢復正常後,請將暫時調高的日誌層級改回原設定。
日誌排查常見問題
日誌更新太快,怎麼找到這次操作對應的訊息?
暫停測速與訂閱更新,只重現一次問題,並記下操作開始時間。先依時間縮小範圍,再用目標位址或要求編號找出相關行。只有 info 仍缺少關鍵資訊時,才短暫切換至 debug;收集完成後請恢復原本的層級。
網頁可以開啟,為什麼更新訂閱還是逾時?
更新訂閱時連線的是訂閱伺服器,使用的連線方式可能與瀏覽器不同。只更新發生錯誤的分組,記下更新提示,再確認訂閱網址是否仍有效、更新是否經由代理,以及同一時間節點是否正常運作。先不要刪除現有分組。
看到憑證過期,就一定要更換節點嗎?
先在 Windows「設定」→「時間與語言」→「日期與時間」中確認系統時間並進行同步,再重新測試。如果時間正確但仍出現憑證過期錯誤,請確認日誌指向哪個 TLS 對端,並請負責該對端的一方檢查憑證有效期限與部署狀態。
測速有數值,為什麼特定網站還是無法開啟?
測速要求與該網站的要求不是同一次連線。停止測速後,單獨存取該網站,並在新日誌中確認命中的出站,以及失敗發生在解析、撥號還是交握階段。若只有這個網域無法連線,請先檢查其路由規則命中情況與解析結果。