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

整理 v2rayN 日誌格式與級別,解析連線逾時、交握失敗、連接埠衝突及規則檔案遺失等錯誤,並說明排查順序。

本文重點

適合遇到核心啟動失敗、節點測試逾時或瀏覽器沒有回應的 v2rayN 使用者。先確認本機是否已建立監聽,再依序檢查位址解析、遠端連線、交握與路由。每次只測試一次、只調整一項設定,並用相同請求確認變更是否生效。

日誌級別與行格式

v2rayN 介面訊息和核心日誌屬於不同層級。介面顯示「啟動核心」,只代表用戶端已送出啟動指令;核心仍可能因設定解析失敗而結束。訂閱更新失敗則可能發生在用戶端取得訂閱的階段,不能直接視為目前節點的交握錯誤。

線索判讀方式
時間與請求編號先找出與測試時間相符的日誌;若有請求編號,優先追蹤同一編號,避免混入背景請求。
error / warning檢查失敗與異常。出現警告不代表核心已結束,還要確認後續是否仍在監聽或處理請求。
info / debug用來查看更完整的處理過程。短暫開啟以捕捉問題,蒐集資訊後還原原本級別,避免累積大量存取紀錄。
accepted存取日誌出現這類紀錄,表示核心已接收請求,不代表遠端已傳回回應。

錯誤鏈中的 > 常會串起外層操作與底層原因。看到「連線失敗」先別停下來,繼續查看後面的 lookup、dial tcp、x509 或檔案路徑。同一個錯誤可能由多個元件轉述;優先處理包含具體位址、連接埠或檔名的部分。

針對單次請求收集日誌

  1. 記下目前設定

    記錄目前選取的節點、實際使用的核心、系統代理狀態與 TUN 狀態。桌面版可在「設定」→「參數設定」查看本機監聽相關選項;若選單名稱因版本而異,請以設定頁顯示的連接埠及啟動日誌為準。

  2. 確認日誌級別

    在「設定」→「參數設定」查看目前版本提供的日誌選項;若有核心日誌級別,優先暫時選用 info。自訂 Xray 設定中的相關欄位為 log.loglevel。不要直接修改用戶端下次啟動時會重新產生的設定。

  3. 只送出一次請求

    確認核心仍在執行後,用瀏覽器開啟已知正常的測試頁面,並記下操作時間。先暫停批次測速,避免同時產生多筆連線。若問題只在更新訂閱時發生,就只執行一次更新,不要同時測試網頁。

  4. 找出第一個根本原因

    保留啟動行、失敗行及前後相鄰的錯誤鏈。對外分享前,遮蔽訂閱網址、節點位址、身分欄位與存取目標,保留錯誤關鍵字、連接埠類型及時間順序。調整後重做相同操作,確認舊錯誤已消失且請求確實成功。

連接埠衝突與本機代理入口

127.0.0.1
IPv4 迴環位址
10808
本機監聽連接埠範例
443
遠端 TLS 連接埠範例

先確認錯誤中的位址,不要只看連接埠號碼

若日誌顯示 listen tcp 127.0.0.1:10808,先檢查本機的監聽程序;若顯示 dial tcp 和遠端位址,則確認節點連接埠及連線狀況。變更本機代理連接埠無法解決遠端連線問題。

在 Windows PowerShell 中查詢指定連接埠的監聽程序。以下連接埠僅供示範,執行前請換成日誌中的本機連接埠。

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

在工作管理員的「詳細資料」頁面依 PID 確認程序。若是重複執行的用戶端,先正常關閉多餘的執行個體;若該連接埠屬於仍需使用的應用程式,請在 v2rayN 改用未占用的連接埠,並同步調整手動設定代理位址的應用程式。重新啟動核心後,確認新連接埠已開始監聽,且應用程式使用相同連接埠與正確的代理類型。

連線逾時、交握失敗與規則檔案遺失

以下關鍵字可能出現在完整錯誤鏈的不同位置,實際前綴與標點會因核心和平台而異。先確認錯誤描述的是哪個操作,再考慮調整設定。

錯誤:i/o timeout

原因:某次讀取、寫入或連線等待逾時,單看這段訊息無法判斷故障位置。

解法:若前面是 dial tcp,先確認遠端位址與連接埠;若前面是 lookup,先檢查網域名稱解析及 DNS 路徑。

錯誤:connection refused

原因:連線遭到拒絕,常見原因是對端未在該連接埠監聽,也可能是中間設備主動拒絕連線。

解法:先確認目標是迴環位址還是節點位址,再分別檢查本機監聽狀況,或向服務提供者確認遠端服務連接埠。

錯誤:x509: certificate signed by unknown authority

原因:TLS 用戶端無法驗證對端憑證鏈是否連結至受信任的根憑證。

解法:確認連線對象是預期的服務,並請服務維護人員檢查憑證鏈;若使用組織內部憑證,請依管理員提供的流程設定信任。不要關閉憑證驗證。

錯誤:address already in use

原因:要繫結的本機位址與連接埠已被現有監聽程序使用。

解法:依錯誤中的連接埠查找監聽程序,確認多餘的執行個體後將其關閉,或變更本機入站連接埠並同步調整應用程式的代理設定。

錯誤:failed to load geoip

原因:核心無法載入設定引用的 IP 規則資料,可能是檔案無法開啟,也可能是無法從資料中讀取指定分類。

解法:查看內層錯誤提供的路徑與分類名稱;若系統提示找不到檔案,請檢查實際資源目錄,並還原與規則設定相符的資料檔;若提示分類不存在,則確認規則引用是否正確。

geoip.dat 用於 IP 分類,geosite.dat 用於網域分類。自訂設定也可能引用其他資料檔。用戶端資料夾中有同名檔案,不代表目前執行的核心會從該資料夾讀取;請以錯誤鏈中的路徑為準。若日誌顯示權限錯誤,請確認執行帳戶能否讀取檔案,而非重複下載。若核心在載入規則時已結束,應先修復啟動問題,再測試節點。

TCP 已建立但 TLS 交握失敗時,請再確認節點設定中的傳輸安全類型、serverName 是否符合服務端要求。若憑證有效期錯誤,也要檢查系統日期與時間同步。連接埠可連通只代表 TCP 連線已建立,無法證明 TLS、節點驗證或應用程式請求成功;不要以單次連接埠測試取代實際連線測試。

常見日誌問題

節點測試有延遲,為什麼網頁還是無法開啟?

先確認測試使用的節點與目前啟用的節點相同。接著開啟一個網頁,找出同一時間的核心存取紀錄。若有紀錄,檢查路由及出站錯誤;若沒有,先確認存取日誌已啟用,再檢查瀏覽器是否使用系統代理,或是否仍保留舊的手動代理連接埠。

只有更新訂閱時逾時,該檢查節點嗎?

先確認逾時的是訂閱請求還是節點連線。記下一次手動更新的時間,檢查訂閱群組中的網址、更新時選用的連線方式,以及該方式目前是否可用。若現有節點仍可使用,不要為了解決更新問題就先刪除整個訂閱群組。

日誌出現 accepted,如何判斷是否走錯出站?

查看同一請求後續顯示的出站標籤;若目前日誌沒有顯示標籤,可暫時提高日誌級別。對照實際生效設定中的規則比對順序,確認 routing.rules 的 outboundTag 是否指向預期的 outbounds 標籤。不要只憑接收紀錄判斷分流結果。

只有啟用 TUN 才出問題,該從哪一行開始看?

先保留故障發生時的狀態,再關閉 TUN,使用同一節點透過系統代理測試同一個頁面。若只有 TUN 失敗,回頭查看啟用時最早出現的虛擬網卡、權限、路由或 DNS 錯誤。先分辨虛擬網卡未建立,還是已建立但請求未正確轉送,再決定要檢查哪項設定。

下載v2rayNWindows / macOS / Android / Linux