· 故障排查 · 約 8 分鐘

V2Ray 執行記錄怎麼看?常見錯誤訊息與排查方法

了解如何查看用戶端記錄、調整記錄層級,並判讀握手失敗、連線逾時、連接埠占用與時間不同步等問題,依序由近到遠排查。

本文摘要

適合遇到核心啟動失敗、啟用代理後立即逾時,或只有少數網站無法開啟的讀者。先擷取一次失敗請求的記錄,再依序檢查本機監聽、路由規則、節點解析、遠端連線與協定握手。每次只調整一項設定,並用同一個網址重新測試,避免把偶然恢復誤認為問題已解決。

開啟用戶端記錄,記下錯誤發生情況

用戶端記錄和核心記錄能解答不同問題。前者可確認訂閱是否下載成功、設定是否載入;後者則適合用來判斷本機連接埠、對外連線與握手問題。即使訂閱更新成功,也只表示這次能連上訂閱網址,不代表其中的節點都能連線。

  1. 查看記錄

    桌面版以 v2rayN 7.x 為例,開啟主視窗,查看節點清單下方的資訊區。Android 上開啟 v2rayNG 或 v2flyNG,點選左上角「☰」,再選擇「記錄」(部分版本會顯示為「Logcat」)。記下用戶端版本,以及記錄啟動行中的核心版本;v2rayNG 使用 Xray,v2flyNG 使用 V2Fly 核心,錯誤訊息不一定相同。

  2. 調整為資訊層級

    在 v2rayN 中依序前往「設定」→「參數設定」,進入 Core 基本設定並找到「記錄層級」;Android 版則從「☰」→「設定」尋找記錄層級選項。介面名稱可能因版本而異。先選擇 info,儲存後重新連線;只有在資訊不足時,才短暫改用 debug。若介面沒有這項設定,先利用現有記錄排查。

  3. 重現一次問題

    記下點選連線的時間,等核心啟動後,用同一個應用程式開啟同一個無法連線的網址一次。不要同時重新測速、更新訂閱或切換節點。若網頁尚未開啟就出現錯誤,先保留啟動階段的記錄,不必繼續送出請求。

  4. 保留前後文

    複製錯誤行前後各約 5 行。若記錄中有連線編號,只串起相同編號的項目來看,避免把背景應用程式的錯誤當成這次測試的結果。排查完成後,將記錄層級恢復原狀;分享記錄前,請遮蔽訂閱網址、帳號識別資訊、節點位址與瀏覽的網域。

判斷問題出在哪個環節

應用程式請求本機入口路由比對對外連線協定握手

先確認請求是否進入核心,再查看它使用哪個對外連線。記錄中的 accepted 通常只代表核心已收到請求;若後續使用直連,就不會有節點握手記錄。若沒有請求記錄,先確認目前的記錄層級會記錄連線,再檢查系統代理、TUN 或 Android 的應用程式分流範圍。

常見錯誤原文、含義與處理方式

以下列出可用來搜尋的錯誤片段,並非特定版本的完整記錄。作業系統、核心版本和傳輸方式不同,錯誤訊息的前後內容可能有所差異。

bind: address already in use

原因:核心要監聽的位址和連接埠已被占用。處理方式:確認占用中的程式後,關閉重複執行的執行個體;或替目前的用戶端改用確認未占用的連接埠,並同步更新曾手動設定代理連接埠的應用程式。

connect: connection refused

原因:連線遭到明確拒絕,常見情況是目標連接埠沒有程式在監聽。處理方式:若目標是 127.0.0.1,確認核心是否已啟動,以及應用程式的連接埠設定是否正確;若目標是節點位址,核對訂閱中的節點連接埠,再向服務提供者確認服務狀態。

i/o timeout

原因:某次網路讀寫或連線操作未能在期限內完成,光看這段訊息無法確定節點是否無法連線。處理方式:先確認同一行是 lookup、dial tcp 還是讀寫逾時,再保持節點不變,改用已知可正常連線的網路測試。

no such host

原因:這次網域查詢未能取得可用的記錄。處理方式:找出解析失敗的網域;若是節點網域,先對照訂閱中的原始內容確認拼字;若是瀏覽網域,先確認解析工作由系統、核心還是遠端負責,再檢查相應的 DNS 設定。

remote error: tls: handshake failure

原因:對端拒絕了 TLS 握手,但這行記錄本身沒有說明具體原因。處理方式:依照訂閱中的原始設定核對節點連接埠、傳輸方式、TLS 開關與伺服器名稱;若仍失敗,將握手時間與已遮蔽敏感資訊的記錄提供給節點服務提供者確認。

x509: certificate has expired or is not yet valid

原因:依本機時鐘判斷,憑證不在有效期限內;可能是系統時間錯誤,也可能是憑證確實已過期。處理方式:先同步系統時間;若時間正確仍然失敗,請服務提供者檢查憑證,不要停用憑證驗證。

檢查本機連接埠與系統時間

假設記錄顯示核心嘗試監聽 127.0.0.1:10808,但繫結失敗。可在 Windows 的 PowerShell 查詢正在監聽該連接埠的處理程序。此處的 10808 僅為範例,實際操作時請替換為記錄中的連接埠。若錯誤涉及 UDP,則無法用這項 TCP 查詢確認是否有連接埠占用。

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

在工作管理員的「詳細資料」頁面,依照 OwningProcess 回傳的處理程序 ID 找出對應程式,不要直接結束不認識的處理程序。若要更換連接埠,例如改用已確認未占用的 10818,請儲存後重新啟動核心,並確認應用程式填寫的代理類型和連接埠。HTTP 與 SOCKS 入口若分開設定,必須各自對應;連接埠正在監聽,也不代表兩種入口可以互換。

依問題範圍選擇測試方式

記錄顯示已收到請求,為什麼網頁還是打不開?

繼續查看同一個請求後續的對外連線標記。若走直連但預期應使用代理,先核對目前的路由模式和比對到的規則;若走代理,再檢查相應的撥號或握手錯誤。使用同一個網址重新測試,不要同時變更分流模式和節點。

只有一個節點逾時,需要重新安裝用戶端嗎?

先不要重新安裝。保持裝置、網路、網址和路由模式不變,只換成另一個已知可用且使用相同協定的節點。若對照節點正常,優先核對故障節點的位址、連接埠和傳輸參數;若兩個節點都逾時,再檢查目前的網路和本機設定。

桌面版可以用,手機點選連線後為什麼沒有連線記錄?

先確認 Android 已核准目前用戶端的 VPN 連線,並檢查是否有其他 VPN 正在執行。若已啟用依應用程式分流,確認測試用的瀏覽器沒有被排除,或已加入僅代理清單。重新測試時維持同一個節點,避免混淆應用程式流量未被接管與節點故障。

剛更新訂閱就出現錯誤,該看哪一段記錄?

先確認訂閱請求是否明確顯示下載或解析失敗。若更新成功,確認目前啟用的是新群組中的節點,再中斷連線後重新連線,並查看核心啟動行。若核心能啟動,只有新節點握手失敗,請逐項比對更新前後的傳輸方式與 TLS 設定,不要整套套用舊參數。

下載用戶端