遇到 v2rayN 無法啟動或網頁無法開啟時,先確認核心是否已載入設定、是否已建立本機監聽,再檢查對外連線。本文以 Windows 上使用 Xray 核心的 v2rayN 為例,說明如何擷取故障日誌,以及如何根據位址、連接埠與錯誤前後文縮小排查範圍。
v2rayN 日誌在哪裡看?日誌等級怎麼選?
先查看主視窗的「資訊」區域,找到切換節點或啟動核心附近的輸出內容。若要設定日誌等級,可從「設定」→「參數設定」進入 Core 基本設定,找到「日誌等級」。不同版本的分類名稱可能略有差異;使用自訂設定時,也要確認實際載入的設定是否自行指定日誌輸出位置與等級。
記錄目前環境
記下 v2rayN 版本、節點使用的核心類型,以及本機代理連接埠。先不要同時更新訂閱、切換節點又修改連接埠,否則即使恢復連線,也無法判斷是哪項變更生效。
設為 info
暫時將核心日誌等級設為
info,儲存後重新啟動目前的核心。Xray 設定中對應的欄位是log.loglevel。warning和error記錄的範圍較窄,適合日常使用,但未必能顯示請求經過的環節。重現一次故障
記下發出請求的時間,並用原本出錯的應用程式重試一次。若故障發生在啟動時,只要重新啟動核心即可,不必反覆重新整理網頁。保留錯誤行及前後幾行,不要只複製視窗最後一行。
補充記錄後還原
若
info無法判斷故障環節,可暫時改用debug再試一次,之後恢復原本等級。對外分享前,請遮蔽訂閱網址、驗證資訊、私人網域名稱及公網 IP 位址;保留錯誤關鍵字、連接埠,以及同一請求中的關聯識別碼。
日誌格式:分辨本機入站、路由與遠端出站
一段日誌可能同時包含用戶端提示、核心輸出與測速結果。查看核心輸出時,先依時間對照該次操作,再看元件名稱及發生錯誤的動作。部分核心日誌會用 > 串接多層錯誤:左側通常是動作失敗的概述,右側則常有更具體的系統錯誤。只比較同一條錯誤鏈,不要把相鄰請求的日誌拼成同一個原因。
| 日誌片段 | 可以確認什麼 | 下一步檢查哪裡 |
|---|---|---|
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,再核對遠端連接埠與傳輸設定,並以同一個測試請求再次確認。