適合遇到核心啟動失敗、節點測試逾時或瀏覽器沒有回應的 v2rayN 使用者。先確認本機是否已建立監聽,再依序檢查位址解析、遠端連線、交握與路由。每次只測試一次、只調整一項設定,並用相同請求確認變更是否生效。
日誌級別與行格式
v2rayN 介面訊息和核心日誌屬於不同層級。介面顯示「啟動核心」,只代表用戶端已送出啟動指令;核心仍可能因設定解析失敗而結束。訂閱更新失敗則可能發生在用戶端取得訂閱的階段,不能直接視為目前節點的交握錯誤。
| 線索 | 判讀方式 |
|---|---|
| 時間與請求編號 | 先找出與測試時間相符的日誌;若有請求編號,優先追蹤同一編號,避免混入背景請求。 |
error / warning | 檢查失敗與異常。出現警告不代表核心已結束,還要確認後續是否仍在監聽或處理請求。 |
info / debug | 用來查看更完整的處理過程。短暫開啟以捕捉問題,蒐集資訊後還原原本級別,避免累積大量存取紀錄。 |
accepted | 存取日誌出現這類紀錄,表示核心已接收請求,不代表遠端已傳回回應。 |
錯誤鏈中的 > 常會串起外層操作與底層原因。看到「連線失敗」先別停下來,繼續查看後面的 lookup、dial tcp、x509 或檔案路徑。同一個錯誤可能由多個元件轉述;優先處理包含具體位址、連接埠或檔名的部分。
針對單次請求收集日誌
記下目前設定
記錄目前選取的節點、實際使用的核心、系統代理狀態與 TUN 狀態。桌面版可在「設定」→「參數設定」查看本機監聽相關選項;若選單名稱因版本而異,請以設定頁顯示的連接埠及啟動日誌為準。
確認日誌級別
在「設定」→「參數設定」查看目前版本提供的日誌選項;若有核心日誌級別,優先暫時選用
info。自訂 Xray 設定中的相關欄位為log.loglevel。不要直接修改用戶端下次啟動時會重新產生的設定。只送出一次請求
確認核心仍在執行後,用瀏覽器開啟已知正常的測試頁面,並記下操作時間。先暫停批次測速,避免同時產生多筆連線。若問題只在更新訂閱時發生,就只執行一次更新,不要同時測試網頁。
找出第一個根本原因
保留啟動行、失敗行及前後相鄰的錯誤鏈。對外分享前,遮蔽訂閱網址、節點位址、身分欄位與存取目標,保留錯誤關鍵字、連接埠類型及時間順序。調整後重做相同操作,確認舊錯誤已消失且請求確實成功。
連接埠衝突與本機代理入口
先確認錯誤中的位址,不要只看連接埠號碼
若日誌顯示 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 錯誤。先分辨虛擬網卡未建立,還是已建立但請求未正確轉送,再決定要檢查哪項設定。