v2rayN 日誌怎麼看?常見錯誤訊息與排查方法

從日誌層級設定開始,說明 connection refused、i/o timeout、TLS 握手失敗等常見錯誤訊息,並整理逐步排查順序。

本文速覽

適合使用 Windows 版 v2rayN,並遇到核心啟動失敗或網頁逾時的讀者。先用一次請求對照日誌與故障,再確認錯誤指向本機監聽、節點連線、網域解析或 TLS 驗證。每次只調整一項設定,並以相同請求確認是否有效。

設定日誌層級:只重現一次故障

v2rayN 介面中的訊息可能來自用戶端,也可能來自正在執行的核心。訂閱下載、設定檔產生與核心轉送是不同環節:更新訂閱時發生逾時,不代表已匯入的節點無法建立連線。以下以 Windows 上的 v2rayN 7.x 搭配 Xray 為例;不同版本的選項位置可能不同,請先確認目前執行的核心,再判斷日誌層級是否適用。

  1. 啟用診斷日誌

    前往「設定」→「參數設定」→「Core: 基礎設定」,找到「日誌等級」,暫時選擇 info;若同一頁有日誌開關,也請確認已啟用。儲存後查看是否出現新的核心啟動訊息。只有現有資訊不足時,才短暫切換至 debug。

  2. 固定測試條件

    保持目前節點與路由模式不變,記下測試時間。排查 Windows 系統 Proxy 時,可在系統匣選單的「系統代理」中選擇「自動配置系統代理」,再用會遵循系統 Proxy 設定的瀏覽器開啟先前無法連線的網址。若原本的故障發生在 TUN 模式,請先依原模式重現,不要同時切換代理入口。

  3. 擷取第一筆錯誤

    在主視窗的訊息區找出測試時間附近的記錄。先保留啟動結果,再保留此次請求的第一筆具體錯誤及前後幾行。記下錯誤涉及的地址、連接埠與操作,不要只複製最後一行的重試失敗訊息。

  4. 還原日誌層級

    測試完成後請還原原本的層級,避免長期記錄造訪目標。對外分享前,請遮蔽訂閱網址、使用者 ID、權杖、節點地址及實際造訪的網域;保留連接埠類型與完整錯誤訊息,才能判斷哪一段連線出了問題。

本機連接埠:先確認請求已進入核心

用戶端視窗能開啟,不代表本機代理已在監聽。先到「設定」→「參數設定」確認「本機監聽連接埠」,再比對 Windows 系統 Proxy 設定中的地址與連接埠。以下數字僅用於示範如何閱讀日誌,並非每台電腦都適用的固定設定。

127.0.0.1
IPv4 迴送位址:請求仍在本機
10808
本機監聽連接埠範例:以參數設定為準
443
遠端 TLS 連接埠範例:以節點設定為準

判斷方式:先看地址,再看錯誤

看到 connection refused 時,先標出錯誤行中的地址。若目標是 127.0.0.1:10808,先檢查本機監聽;若目標是節點地址與連接埠,修改 Windows 系統 Proxy 的連接埠無法解決遠端拒絕連線。

可在 PowerShell 查詢本機的監聽狀態。將命令中的 10808 替換成實際連接埠;這項檢查不會嘗試連線至遠端。

Get-NetTCPConnection -State Listen -LocalPort 10808 |
  Select-Object LocalAddress, LocalPort, OwningProcess

常見錯誤訊息:分辨拒絕連線、逾時與 TLS 驗證失敗

相同的錯誤訊息可能出現在不同階段。以下依據錯誤行附近的操作與地址判斷;如果只看到外層的失敗提示,請繼續查看同一請求中的內層錯誤,不要先更換協定。

錯誤:bind: address already in use

原因:本機連接埠無法繫結,常見原因是其他程序或另一個實例已在監聽;Windows 也可能顯示系統提供的 Socket 錯誤訊息。

解決方式:依連接埠查詢 PID,結束確認不再使用的重複實例,或改用尚未占用的連接埠,並同步修改手動設定的 Proxy 入口。

錯誤:connection refused

原因:此次連線收到拒絕回應,可能是目標沒有在監聽,也可能是連線路徑上的設備主動拒絕。

解決方式:目標是本機地址時,先檢查監聽程序;目標是節點地址時,確認匯入的連接埠,並請服務維護者確認相應的入站是否正在監聽。

錯誤:i/o timeout

原因:某項操作超過等待期限;dial tcp 後的連線逾時,與連線建立後的 read tcp 逾時,並非發生在同一階段。

解決方式:建立連線時逾時,先確認節點地址與連接埠;讀取逾時則保留握手及第一筆讀取錯誤,並在相同網路下使用另一個已知可用的節點進行比對。

錯誤:no such host

原因:目前的查詢路徑無法解析所需的主機名稱;出錯的可能是節點網域,也可能是造訪的網域。

解決方式:先抄下 lookup 指向的名稱並檢查拼字,再分辨使用的是系統 DNS 還是核心 DNS;系統能解析,不代表核心使用的解析器也能解析。

錯誤:x509: certificate has expired or is not yet valid

原因:一般 TLS 憑證驗證發現憑證目前不在有效期限內;本機時鐘不準也可能觸發此錯誤。

解決方式:在 Windows「設定」→「時間與語言」→「日期與時間」同步時鐘。若重新測試仍失敗,請服務維護者檢查憑證及憑證鏈的有效期限。

握手與路由:TCP 連得上,不代表網頁就能開啟

節點連接埠可連線,只代表傳輸層可能正常。一般 TLS 節點後續仍須驗證伺服器名稱與憑證;握手成功後,也要確認請求是否走到預期的出站。不要為了消除錯誤而關閉憑證驗證,也不要把一般 TLS 的憑證排查方式直接套用到 REALITY 設定。

  1. 先確認安全類型。開啟目前節點的編輯視窗,對照可信來源提供的原始設定,核對傳輸方式與安全類型。一般 TLS 若提示憑證上的有效名稱與請求名稱不符,請確認伺服器名稱(SNI)以及憑證涵蓋的網域;連線地址能解析,不代表該地址就是應填入的伺服器名稱。
  2. 接著確認實際出站。在同一請求的日誌中查看路由或出站資訊。若該網域實際走直連,請先檢查 v2rayN 目前選用的「路由」規則與比對順序,而非反覆更換代理節點。看到 accepted 只代表核心已接收請求,不代表目標網站已回應。
  3. 最後透過比對縮小範圍。同一個目標在兩個節點上都無法連線時,再換另一個測試目標;只有一個網域失敗時,優先檢查網域解析與分流。保持節點不變、改用其他網路測試時,請維持測試地址不變並記錄結果,避免誤以為是設定修正了問題。

日誌排查常見問題

測速有數值,為什麼瀏覽器還是打不開網頁?

測速與瀏覽器不一定使用相同入口,也不一定連線至相同目標。記下瀏覽器重新整理的時間,確認核心有收到這次請求,再查看出站結果。若沒有入站記錄,優先檢查系統 Proxy 與瀏覽器的 Proxy 設定。

最後一行顯示找不到可用目標,應該看哪一行?

failed to find an available destination 通常是多次嘗試失敗後的彙總訊息,不單指網域解析失敗。沿著同一請求往前查看 lookup、dial 或憑證錯誤;若多筆日誌交錯,先關閉其他測試頁面,再只重現一次。

為什麼開啟除錯日誌後,還是看不到網頁請求?

先確認調整層級後核心已成功啟動,再使用明確遵循系統 Proxy 設定的應用程式測試。若系統 Proxy 模式看得到請求、原本的 TUN 模式卻看不到,請分別檢查兩種入口的設定,不要把兩者的日誌混在同一次測試中。

提供給維護者的日誌應保留哪些資訊?

從 v2rayN 的版本資訊記下完整用戶端版本號,從啟動訊息記下核心名稱與版本,再附上執行模式、重現時間及去識別化後的第一筆具體錯誤。說明相同節點改用其他網路、相同網路改用其他節點時的結果;未進行的比對請註明尚未測試。

下載 V2Ray 用戶端