V2Ray 日誌怎麼看？常見錯誤訊息與排查方式

先確認日誌來自哪個層級

v2rayN、v2rayNG、v2flyNG 是客戶端；V2Ray、Xray 則是處理連線的核心。訂閱下載失敗可能發生在客戶端的更新程式中，此時核心尚未收到請求。反之，日誌若出現 proxy/vless/outbound、transport/internet 等模組路徑，通常表示請求已進入核心處理階段。這兩類問題的排查起點不同。

v2rayN 可先查看主視窗的日誌區域，再到「設定」→「參數設定」尋找日誌相關選項。v2rayNG 可從主畫面的選單進入「日誌」，並在「設定」中檢查日誌等級；不同版本的選項位置與名稱可能有所不同。請記下客戶端版本，以及啟動日誌中的核心名稱與版本，不要只寫「使用 V2Ray」。v2rayNG 使用 Xray 核心，v2flyNG 使用 v2fly 核心，不能只根據應用程式名稱推斷錯誤格式。

日誌等級與錯誤鏈的閱讀方式

V2Ray/Xray 常見的 loglevel 值包括 debug、info、warning、error、none。排查問題時可暫時設為 info；若資訊不足，再提高至 debug。只顯示 error 會過濾警告與一般資訊；設為 none 後，沒有輸出並不能證明連線正常。

{
  "log": {
    "loglevel": "info"
  }
}

以上只是核心設定中的日誌片段，並非可直接取代整份設定檔的內容。若使用客戶端產生設定檔，請優先修改介面中的選項；暫時手動修改產生的檔案，切換節點後可能會被覆寫。存取日誌與錯誤日誌的輸出位置，另由 access、error 等欄位及客戶端的啟動方式決定；提高日誌等級不保證一定會產生磁碟檔案。

1. 先看時間。記下點擊測試或重新整理網頁的時間，查看前後約 10 秒的記錄，避免混入背景應用程式的請求。
2. 再看關聯資訊。若有方括號括住的連線編號，請用相同編號串起多行記錄；若沒有編號，則依目標位址、連接埠與時間判斷。
3. 由外往內讀。failed to process outbound traffic 通常只是外層摘要，後面的 connection refused 或 lookup ... 才更接近直接原因。
4. 回頭找第一個異常。程序啟動失敗可能導致後續所有測試逾時。先修正啟動錯誤，再分析實際請求為何失敗。

流程鏈用來判斷檢查層級，不代表所有協定都會嚴格依照相同順序執行。例如，伺服器位址若已是 IP，就不必先解析該位址；路由規則也可能觸發獨立的網域解析。請以目前的設定與日誌為準。

連線逾時、遭拒與解析失敗

「逾時」表示等待時間超過限制，但無法單憑這個錯誤判斷問題出在本機 DNS、遠端連接埠還是交握回應。先確認錯誤中的目標：它可能是代理伺服器，也可能是直連網站或訂閱伺服器。不要只看到任一處出現 timeout，就更換所有 DNS 與路由規則。

在 Windows 分別測試網域解析與連接埠

以下命令使用保留的示範網域，只用來說明檢查方式。執行前，請將網域與連接埠換成目前節點的實際伺服器位址及連接埠；不要填入瀏覽器要造訪的網站，也不要填 TLS 的 serverName，除非它剛好就是伺服器位址。

Resolve-DnsName server.example.com
Test-NetConnection server.example.com -Port 443

• Resolve-DnsName 檢查的是系統解析路徑，不等同於核心內建 DNS 的解析結果。若系統可以解析但核心失敗，請繼續檢查核心 DNS 伺服器與路由。
• TcpTestSucceeded : True 只代表該次 TCP 連線成功，不表示 UUID、TLS、WebSocket 路徑或遠端轉送設定都正確。
• TCP 測試失敗不能直接用來判斷以 UDP 為基礎的傳輸。請先確認實際使用的傳輸類型，再選擇相應的診斷方式。

TLS 交握失敗與時間不同步

交握失敗表示連線在安全協商或協定初始化階段中止，但原因不一定是憑證。TCP 可連線後，才依序核對安全類型、伺服器名稱、憑證、傳輸參數與驗證欄位。VLESS 的 UUID 驗證與 TLS 憑證驗證屬於不同層級；修正憑證名稱不代表 UUID 也正確。

先校正時間，再核對節點欄位

1. 在 Windows 中前往「設定」→「時間與語言」→「日期與時間」，開啟自動設定時間並執行同步。可使用 w32tm /query /status 查看時間服務狀態；此命令出錯也可能只是時間服務尚未執行。
2. 在 Android 中開啟系統「設定」，搜尋「日期與時間」，並啟用自動設定時間。請核對實際日期與時間；單純切換顯示時區並不能校正系統時鐘。
3. 使用 VMess 時，客戶端與伺服器的時鐘偏差可能導致驗證失敗。兩端都應校正時間，不要只調整手機顯示的時區。VLESS 不適用相同的 VMess 時間驗證說明，但 TLS 連線仍需要正確時間來驗證憑證。
4. 逐項比對伺服器位址、連接埠、UUID、安全類型、serverName、WebSocket 的 path 與 Host，或 gRPC 的 serviceName。各欄位請依伺服器提供的值填寫，不要反覆隨機修改來試錯。

連接埠占用：先讓核心正常啟動

日誌若出現 bind、address already in use，或 Windows 的 Only one usage of each socket address，請先檢查本機監聽位址。若本機入站建立失敗，即使瀏覽器已啟用系統代理，也沒有可用的連線入口。這與遠端伺服器連接埠是否開放是兩回事。

以日誌顯示 127.0.0.1:10808 綁定失敗為例，請在 PowerShell 中查詢監聽程序。若實際錯誤的連接埠不同，也要同步修改命令中的連接埠。

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

Get-Process -Id 1234

第二個命令中的 1234 是示範程序編號，請替換為第一個命令結果中的 OwningProcess。若查不到記錄，也請檢查日誌是否對應 UDP 監聽、程序是否已結束，或錯誤是否來自舊的啟動記錄。

1. 若監聽者是重複啟動的客戶端，請先從系統匣正常結束多餘的執行個體，再啟動一個執行個體進行驗證。
2. 若監聽者是需要保留的其他程式，請在客戶端的參數設定中調整本機監聽連接埠，並讓使用手動代理的應用程式同步改用新連接埠。
3. 修改後請重新啟動核心，確認出現正常的啟動訊息，再測試網頁。不要直接終止不熟悉的系統程序。
4. 若錯誤是 permission denied 或 access permissions，也可能涉及系統連接埠保留與安全性政策，不能一概歸因於重複程序；也不要長期只靠系統管理員權限執行來掩蓋原因。

如何記錄可重現的排查過程

同時切換節點、修改 DNS、啟用 TUN 並調整路由，即使連線恢復，也無法判斷是哪項修改生效。較可靠的做法是固定一個目標、一個節點與一種連線方式，並將每次測試與日誌時間對照。以下流程適用於桌面端與 Android 上的同類問題。

1. 記錄基準資訊：記下客戶端版本、核心版本、目前網路、代理連線方式與目標位址，並暫停不必要的背景下載。
2. 確認啟動狀態：重新啟動連線，先處理設定解析失敗、監聽失敗與缺少資源等啟動階段錯誤。
3. 送出單次請求：記下時間，只重新整理同一個頁面一次，並保留請求前後約 10 秒的日誌。
4. 找出最深層錯誤：先判斷問題出在本機監聽、網域解析、遠端連線、TLS 還是協定驗證，再選擇相應的檢查項目。
5. 一次只改一項：例如只校正時間，或只修正錯誤的連接埠；以相同目標重新測試，比較具體錯誤是否消失，或轉移到下一個階段。
6. 還原日誌設定：排查完成後，退出除錯等級並記錄有效的修改。分享日誌前，請刪除 UUID、訂閱權杖、完整訂閱網址與個人存取記錄，保留模組名稱與錯誤鏈結構。

如需進一步了解出站標籤與規則的關係，請參閱設定欄位說明。若日誌顯示請求走直連出站，應檢查路由比對，不要將直連目標的連線失敗誤認為代理伺服器連線失敗。

常見問題：哪些日誌不能直接下結論？