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

說明日誌等級與格式,解析連線逾時、連接埠遭占用、設定檔解析失敗及 TLS 交握錯誤等狀況,提供排查步驟。

本文重點

遇到 v2rayN 無法啟動或網頁無法開啟時,先確認核心是否已載入設定、是否已建立本機監聽,再檢查對外連線。本文以 Windows 上使用 Xray 核心的 v2rayN 為例,說明如何擷取故障日誌,以及如何根據位址、連接埠與錯誤前後文縮小排查範圍。

v2rayN 日誌在哪裡看?日誌等級怎麼選?

先查看主視窗的「資訊」區域,找到切換節點或啟動核心附近的輸出內容。若要設定日誌等級,可從「設定」→「參數設定」進入 Core 基本設定,找到「日誌等級」。不同版本的分類名稱可能略有差異;使用自訂設定時,也要確認實際載入的設定是否自行指定日誌輸出位置與等級。

  1. 記錄目前環境

    記下 v2rayN 版本、節點使用的核心類型,以及本機代理連接埠。先不要同時更新訂閱、切換節點又修改連接埠,否則即使恢復連線,也無法判斷是哪項變更生效。

  2. 設為 info

    暫時將核心日誌等級設為 info,儲存後重新啟動目前的核心。Xray 設定中對應的欄位是 log.loglevel。warning 和 error 記錄的範圍較窄,適合日常使用,但未必能顯示請求經過的環節。

  3. 重現一次故障

    記下發出請求的時間,並用原本出錯的應用程式重試一次。若故障發生在啟動時,只要重新啟動核心即可,不必反覆重新整理網頁。保留錯誤行及前後幾行,不要只複製視窗最後一行。

  4. 補充記錄後還原

    若 info 無法判斷故障環節,可暫時改用 debug 再試一次,之後恢復原本等級。對外分享前,請遮蔽訂閱網址、驗證資訊、私人網域名稱及公網 IP 位址;保留錯誤關鍵字、連接埠,以及同一請求中的關聯識別碼。

日誌格式:分辨本機入站、路由與遠端出站

一段日誌可能同時包含用戶端提示、核心輸出與測速結果。查看核心輸出時,先依時間對照該次操作,再看元件名稱及發生錯誤的動作。部分核心日誌會用 > 串接多層錯誤:左側通常是動作失敗的概述,右側則常有更具體的系統錯誤。只比較同一條錯誤鏈,不要把相鄰請求的日誌拼成同一個原因。

127.0.0.1
本機迴路位址
10808
本機代理連接埠範例
443
遠端 TLS 連接埠範例
日誌片段可以確認什麼下一步檢查哪裡
listen tcp 127.0.0.1:10808這段文字指向本機監聽操作查看同一行是否出現繫結失敗,而不是測試伺服器端連接埠
accepted核心已收到這個入站請求若後續顯示入站至出站的標籤,請確認是否使用預期的路由
dial tcp某個元件嘗試建立 TCP 連線依日誌中的目標位址與連接埠,判斷是節點、直連目標或本機服務

判斷方式:以同一個請求確認路由

若瀏覽器出錯時已有對應的 accepted,但出站標籤顯示命中直連規則,請先檢查該路由規則及其比對順序。此時重新安裝用戶端或頻繁切換節點,都不會改變這個請求的出站選擇。

核心啟動失敗:連接埠遭占用或設定檔解析錯誤

啟動階段出現錯誤時,瀏覽器的代理錯誤通常只是後續現象。先確認核心是否成功載入設定,再檢查能否監聽本機連接埠。這兩種故障都可能使請求無法進入核心,但處理方式不同。

錯誤:Only one usage of each socket address (protocol/network address/port) is normally permitted.

原因與解法:Windows 回報這項繫結錯誤,通常是因為目前的程序無法再次占用該位址與連接埠。查看監聽中的程序,確認是否有另一個用戶端執行個體或未關閉的核心;正常結束衝突的程式,或變更本機連接埠,並同步修改應用程式中的代理設定。

錯誤:invalid character '}' looking for beginning of object key string

原因與解法:解析器正等待下一個物件鍵時,讀到了右大括號;常見原因是最後一個欄位後多了逗號。依照錯誤訊息中的檔名、行列或偏移位置,檢查實際載入的設定檔,先修正語法,再確認欄位類型與核心是否支援。

若錯誤中的監聽連接埠是 10808,可在 Windows PowerShell 中查詢。若日誌顯示其他連接埠,請將命令中的數字替換為該值。若查不到監聽記錄,先重新確認錯誤發生時間;造成衝突的程序可能已經結束。

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

OwningProcess 是程序 ID,可在工作管理員的「詳細資料」頁面核對。若變更了本機代理連接埠,請重新套用 v2rayN 的系統代理設定,並檢查曾手動填入代理位址的應用程式。若自動產生的設定檔解析失敗,請優先回到節點編輯畫面修正來源;直接編輯暫存設定檔,可能會在下次啟動時被覆寫。

連線逾時、連線遭拒與 TLS 交握失敗

核心收到請求後,下一步要確認是撥號失敗,還是 TCP 已建立連線後在交握階段失敗。兩者的檢查項目不同:前者檢查實際連線位址與連接埠,後者檢查安全類型、服務名稱與憑證等參數。

錯誤:i/o timeout

原因與解法:某次網路操作超過時限,但光看這幾個字無法判斷逾時發生在哪一層。若前面是 dial tcp,先測試日誌中的目標 TCP 連接埠;若錯誤發生在讀取回應或交握時,請繼續查看同一條錯誤鏈的前後文。

錯誤:connection refused

原因與解法:連線遭到主動拒絕,常見原因是目標連接埠沒有服務在監聽,或中間設備主動拒絕連線。確認位址是否屬於本機;若是本機,查看監聽中的程序;若是遠端,請核對節點連接埠,並向服務管理者確認是否有監聽及允許連線。

錯誤:x509: certificate signed by unknown authority

原因與解法:一般 TLS 憑證驗證無法將收到的憑證鏈連結至受信任的根憑證。先確認連線的是預期服務,再請服務管理者檢查憑證鏈;若使用的是組織管理的網路,請向管理員確認信任鏈要求,不要透過略過驗證來消除錯誤。

錯誤:remote error: tls: handshake failure

原因與解法:遠端在交握時回傳失敗警示,單看這一行無法判斷是哪個參數不符。請核對節點的安全類型、服務名稱與連接埠;若設定使用 REALITY,則依服務端提供的參數核對服務名稱、公鑰與短 ID,不要套用一般 TLS 的憑證設定。

若節點使用 TCP,可在 PowerShell 中單獨測試伺服器入口。依提示輸入節點伺服器位址與遠端連接埠,不要輸入訂閱連結、TLS 服務名稱或本機代理連接埠。

$serverAddress = Read-Host '節點伺服器位址'
$serverPort = [int](Read-Host '節點遠端連接埠')
Test-NetConnection -ComputerName $serverAddress -Port $serverPort

日誌排查常見問題

網頁無法開啟,但資訊區沒有新日誌?

先將日誌暫時調整為 info 再試一次。若仍找不到對應的入站記錄,請確認核心已開始監聽,再檢查 v2rayN 的系統代理狀態,以及 Windows「設定」→「網路和網際網路」→「Proxy」。若應用程式自行設定了代理,請確認填入的位址、連接埠與代理協定是否符合實際入站設定。

只看到 failed to find an available destination,就能判斷是 DNS 問題嗎?

不能。這只是嘗試建立出站連線失敗時的概述,不代表一定是網域名稱解析出問題。請繼續查看更具體的錯誤:出現 lookup 和 no such host 時,再檢查網域名稱拼字與解析;若已出現目標 IP 和撥號逾時,則先檢查連往該 IP 與連接埠的連線。

節點可以使用,為什麼更新訂閱仍會逾時?

更新訂閱時連線的是訂閱伺服器,節點連得上不代表訂閱伺服器也能連線。開啟主畫面的「訂閱群組」,查看「不透過代理」與「透過代理」的更新選項,先確認是哪一種方式失敗。嘗試透過代理更新前,先用目前的節點確認網頁可以正常開啟。分享更新日誌時,請移除訂閱連結中的路徑與查詢參數。

日誌偶爾出現 EOF,需要更換節點嗎?

先確認網頁請求是否真的失敗。EOF 表示讀取到資料流末尾,單獨出現時無法說明是誰關閉連線或關閉原因。若同一操作總是在交握階段觸發 unexpected EOF,再核對遠端連接埠與傳輸設定,並以同一個測試請求再次確認。

下載用戶端