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

一、先分辨記錄來源，再重現一次要求

v2rayN 是用戶端，V2Ray 或 Xray 則是實際處理連線的核心。訂閱下載失敗、介面設定儲存失敗屬於用戶端事件；監聽連接埠失敗、代理交握失敗通常來自核心。Android 上的 v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心。不同核心與版本的記錄用詞可能不同，不能只靠整行文字搜尋答案。

核心記錄又分為存取記錄與錯誤記錄。存取記錄可用來確認要求是否進入入站、存取哪個目標，以及符合哪個出站；錯誤記錄則用來查看啟動與連線階段的異常。出現 accepted 通常只代表要求已被入站接受，不代表已成功連上遠端，也不代表網頁內容已經傳回。

上述連線流程用來區分排查階段，並非每個連線都會依相同順序解析網域名稱。DNS 可能在路由判斷時解析，也可能交由遠端處理。第一步應先找出失敗要求停在哪個階段，不要同時修改 DNS、路由與節點參數。

1. 儲存目前設定，記下系統時間、選用的節點及實際啟用的核心。
2. 開啟用戶端提供的記錄檢視畫面，確認看到的是核心執行輸出，而不只是訂閱更新訊息。
3. 暫時停止其他應用程式的網路要求，存取一個固定目標，只重現一次失敗。
4. 保留失敗前後連續的記錄，依時間、目標位址與連線識別碼比對同一次要求。

二、如何選擇 loglevel：日常用 warning，排查時暫用 debug

log.loglevel 控制錯誤記錄的詳細程度，不是連線速度設定，也不等同於存取記錄的開關。日常可使用 warning 減少雜訊；重現問題時，則短暫切換為 info 或 debug。找到問題後請恢復原本級別，避免記錄持續增加或暴露更多連線資訊。

以下是 V2Ray 風格設定中的頂層 log 物件片段，並非完整可執行的設定。使用圖形介面用戶端時，建議優先透過記錄設定調整；用戶端產生的設定檔可能會在下次啟動時遭到覆寫。輸出至檔案或主控台，還取決於記錄路徑設定與用戶端擷取輸出的方式。

{
  "log": {
    "loglevel": "debug"
  }
}

三、connection refused 與連接埠占用：先確認位址在哪一端

connection refused 表示連線遭到主動拒絕，常見原因是目標連接埠沒有服務在監聽，或防火牆主動拒絕連線。先查看錯誤訊息中的 IP 與連接埠：若指向 127.0.0.1，請檢查本機入口；若指向節點伺服器，則檢查遠端服務。混淆這兩種情況，可能會造成修改節點後仍無法連上本機代理。

以下數字僅用於說明常見設定組合，不代表目前版本的固定預設值。有些設定會將 HTTP 與 SOCKS 合併至同一個混合入口；請以用戶端實際顯示的監聽項目為準。遠端使用 443 也不代表服務一定採用 TLS。

Windows 可使用以下命令查詢這兩個本機連接埠。輸出最末欄是 PID；請特別確認 TCP 項目是否處於 LISTENING 狀態。接著到工作管理員的「詳細資料」頁面確認程序名稱，不要只憑連接埠號碼就結束不熟悉的程序。

netstat -ano | findstr ":10808"
netstat -ano | findstr ":10809"

• 完全沒有監聽：先排除核心啟動錯誤，再測試瀏覽器或終端機。
• 有監聽但協定不符：HTTP 代理位址不能任意指向只接受 SOCKS 的連接埠。
• 連接埠改為 10810 後：若應用程式仍指向 10808，連線就會持續失敗；系統代理與終端機環境變數需要分別確認。

四、timeout 與 DNS 錯誤：從最內層原因判斷

i/o timeout 表示某次讀寫超過等待時間；context deadline exceeded 表示操作超過截止時間。這兩者都不能直接說明「節點已失效」。DNS 查詢、TCP 建立連線、TLS 交握或等待回應，都可能發生逾時。應沿著錯誤訊息找出最具體的子錯誤，確認逾時發生在哪個位址及階段。

例如瀏覽器無法存取，但記錄只出現節點網域的解析錯誤，表示尚未建立與節點的連線，此時不應先修改目標網站的分流規則。反過來說，若節點已連線，只有特定目標網域無法存取，就應檢查該目標的解析與路由結果。

1. 確認節點的 address 是網域名稱還是 IP，並確認連接埠與伺服器設定一致。
2. 使用系統工具查詢網域，初步確認本機解析是否正常；Windows 可在 nslookup 後輸入實際的節點網域名稱。
3. 系統查詢成功不代表核心的 DNS 解析一定正常。請繼續檢查 dns.servers、解析器是否可連線，以及相關路由。
4. 每次只變更一個項目，並記錄修改前後的錯誤訊息，避免無法判斷是哪項設定生效。

五、TLS 交握失敗：檢查時間、憑證名稱與傳輸參數

TCP 連線成功只代表可以連上遠端連接埠。之後 TLS 仍可能因憑證、伺服器名稱或協定協商失敗而中斷。確認 streamSettings.security 與伺服器要求一致；使用一般 TLS 時，還要檢查 tlsSettings.serverName。伺服器位址與憑證名稱可以不同，但必須符合伺服器的部署方式。

TLS 成功後仍可能發生傳輸或驗證錯誤。WebSocket 的 path、要求中的 Host，以及 gRPC 的 serviceName 都必須與伺服器設定相符。websocket: bad handshake 常見原因包括路徑、Host、反向代理轉送或傳輸類型不符，不能一概視為憑證問題。

六、從記錄定位設定欄位：依故障階段修改

應依故障階段選擇要檢查的欄位。啟動時就出現監聽失敗，先檢查入站；遠端連線失敗，先檢查出站位址；要求走錯路徑，再檢查路由標籤。下表以常見的 V2Ray 風格 JSON 為例，實際結構請以所用核心及用戶端產生的設定為準。

VMess、VLESS、Trojan、Shadowsocks 的驗證欄位各不相同。只有進入協定驗證階段後，才需要檢查 UUID、密碼或加密方式；不要把所有錯誤都歸咎於「密碼錯誤」。反覆出現 EOF 也只代表讀取時連線已結束，需依它發生在交握前或資料傳輸後來判斷。

• 修改前：備份設定，保留錯誤訊息原文與發生時間。
• 修改：只修改與目前故障階段直接相關的項目；使用訂閱管理的節點時，也要留意更新可能會覆寫手動修改。
• 驗證：重新啟動核心使設定生效，並使用相同的應用程式及目標再次測試。
• 完成後：確認連線恢復後，調低記錄級別並清除不再需要的診斷檔案。

七、記錄排查常見問題