· 疑難排解 · 約 10 分鐘

V2Ray 日誌查看與錯誤排除：常見訊息解析及排查步驟

了解如何調整 loglevel、查看日誌位置，並解析 connection refused、i/o timeout、invalid user 等錯誤，依序找出問題所在。

本文重點

先保留一次連線失敗前後的日誌，再依序檢查本機監聽、網域名稱解析、遠端連線與身分驗證。本文適合遇到啟動失敗、連線逾時或網頁無法開啟的使用者，說明 v2rayN 與 v2rayNG 的日誌位置、V2Ray/Xray 日誌層級，以及各類錯誤的後續檢查方向。

先重現問題，再查看對應日誌

先記下問題發生時間，暫停下載與背景更新，只開啟一個要測試的網頁。日誌中的多筆連線可能交錯出現；沒有時間與目標位址作為對照，很容易把背景程式的失敗誤認為目前網頁的問題。別只截取最後一行，保留錯誤前後約 10～20 行，通常更容易看出原因脈絡。

  1. v2rayN 桌面版：先查看主視窗中的執行資訊或日誌區域，分辨用戶端啟動訊息與核心輸出。若要提高日誌詳細程度，請前往「設定」→「參數設定」，尋找核心或日誌相關選項；不同版本的分類名稱可能不同，可依介面中的「日誌等級」或 loglevel 欄位確認。
  2. v2rayNG Android 版：開啟主畫面選單中的「日誌」，啟動服務後再重現問題。如果目前版本的「設定」提供日誌等級選項，可暫時提高等級並重新啟動服務；別把 Android 的 VPN 授權提示誤認為核心錯誤。
  3. 自訂 V2Ray/Xray 設定：檢查實際啟動設定中的 log 區段。error 指定錯誤日誌檔，access 指定存取日誌檔；若未指定檔案，輸出位置也會受到啟動方式及用戶端如何接收主控台輸出的影響。
  4. 找不到日誌檔：先確認是否真的設定了寫入檔案。桌面用戶端的執行檔目錄、工作目錄與設定目錄可能各不相同，不能一概認為日誌都在安裝目錄。相對路徑也要依實際工作目錄確認。

調整 loglevel：先用 info，必要時短暫開啟 debug

loglevel 代表日誌詳細程度。先改為 info，儲存後重新啟動核心，再重現一次；資訊不足時才短暫使用 debug。日誌等級不是網路模式，提高等級不會修復連線，也不會讓代理自動接管更多應用程式。

等級適用情境查看重點
debug短時間追查複雜問題詳細脈絡；可取得的細節視核心與版本而定。
info一般連線問題排查啟動、連線與路由相關資訊。
warning日常查看異常警告及更嚴重的問題；一般連線資訊較少。
error只查看錯誤可能無法看到請求進入核心的完整過程。
none關閉這類日誌輸出不適合在重現問題時使用。

以下是可合併至現有頂層設定的日誌片段，並非完整的代理設定。範例不指定檔案路徑，避免第一輪排查就遇到目錄權限問題。如果設定由用戶端產生，建議優先透過介面修改；直接編輯產生的檔案，可能會在下次啟動時被覆寫。

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

看懂錯誤層級：先找出連線卡在哪個步驟

核心是實際處理代理流量的程式。入站負責接收本機應用程式的請求，出站則負責將請求傳送至直連目標或代理伺服器。先確認請求是否進入入站，再檢查出站選擇與網路交握，比逐一更換設定有效。

應用程式請求 本機入站 路由選擇 遠端連線 通訊協定交握

一行錯誤訊息通常會串起多個原因：外層可能寫著「處理出站流量失敗」，內層才是 connection refused 或 i/o timeout。先看最內層的具體原因，再確認連線的位址。日誌中的目標可能是代理伺服器、直連網站或 DNS 伺服器，不能一概認定是節點故障。

10808
以下範例使用本機 SOCKS 通訊埠，使用前請先確認
443
常見的 HTTPS 目標通訊埠，不代表節點固定使用此通訊埠
53
傳統 DNS 常用通訊埠，不代表所有解析方式

這些數字僅供辨識連線用途參考，不是建議一律修改的設定。實際監聽通訊埠以用戶端設定為準，遠端通訊埠則以伺服器提供的資訊為準。只看到日誌出現 443，無法判斷該連線是否經過代理。

連線錯誤：拒絕、逾時與沒有可用目標

錯誤：connection refused

原因：連線遭到明確拒絕，常見情況是目標通訊埠沒有服務監聽，或防火牆主動拒絕連線。

解法：先查看目標位址；若為 127.0.0.1:10808，請檢查本機核心是否啟動及監聽通訊埠；若是遠端位址，請確認節點通訊埠及伺服器監聽狀態。

錯誤：i/o timeout

原因：某次網路讀寫未能在期限內完成，可能發生於建立連線、TLS 交握或等待回應時。

解法：根據錯誤前綴確認逾時發生階段，再使用同一個節點切換 Wi-Fi 與行動網路進行比較；別將所有逾時都歸咎於 DNS。

錯誤：failed to find an available destination

原因：目前目標經過多次嘗試後，仍未建立可用連線；這通常是彙總錯誤，無法單憑這則訊息判斷根本原因。

解法：繼續查看同一段原因鏈中的解析失敗、連線遭拒或逾時訊息，再分別檢查網域名稱、通訊埠與連線路徑。

錯誤：no such host

原因：相關解析器無法取得該網域的有效位址，也可能是位址拼寫錯誤或 DNS 查詢走錯路徑。

解法：先確認日誌中的網域屬於節點還是目標網站，再檢查實際使用的 DNS 伺服器與分流規則。

使用 v2rayN 的 Windows 使用者，可以先確認範例中的本機通訊埠是否正在監聽。以下指令只會查詢 TCP 狀態，不會變更系統設定。查不到結果不代表遠端節點故障；請先回到用戶端查看啟動錯誤，並確認通訊埠確實為 10808。

Get-NetTCPConnection -State Listen -LocalPort 10808

確認該通訊埠提供 SOCKS 代理後，再執行一次明確指定代理的請求。socks5h 表示將目標網域交由代理端解析；此處的 15 秒是手動設定的測試上限，並非核心預設的逾時時間。

curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 15 --max-time 30 -I https://example.com/

身分驗證與 TLS 錯誤：核對設定，勿略過驗證

TCP 連線建立只代表通訊埠可連線，不代表代理通訊協定驗證成功。UUID 是部分代理通訊協定用來識別使用者的憑證；TLS 則用於驗證伺服器身分並加密傳輸。這兩類問題應分別處理，調高日誌等級或更換本機通訊埠通常無法解決。

錯誤：invalid user

原因：使用者驗證失敗；這類訊息常見於伺服器日誌，可能與憑證不符、使用者已移除或通訊協定參數不一致有關。

解法：核對伺服器與用戶端的使用者識別碼及通訊協定；VMess 也應檢查系統時間，必要時請維護者比對同一時間的伺服器日誌。

錯誤：x509: certificate has expired or is not yet valid

原因：憑證有效期間與目前系統時間不符，可能是憑證已過期，也可能是裝置日期錯誤。

解法：先開啟裝置的自動設定日期與時間，再請伺服器維護者檢查憑證有效期間及部署狀況。

錯誤：x509: certificate signed by unknown authority

原因：目前環境無法建立受信任的憑證鏈，可能是中繼憑證缺失、使用自簽憑證，或網路上的憑證遭到替換。

解法：檢查伺服器的完整憑證鏈與系統信任狀態，向維護者確認預期使用的憑證；勿將關閉驗證當作長期解法。

錯誤：EOF

原因：連線在讀取完成前就已關閉，單獨出現這則訊息，無法證明是驗證失敗。

解法：搭配前後日誌核對 TLS、傳輸方式與伺服器回應；若只有用戶端的這一行，請維護者提供對應的伺服器紀錄。

  1. 先更新訂閱，再重新選取要使用的設定。更新訂閱只是重新整理清單，不一定會自動切換目前的連線。
  2. 逐項核對伺服器位址、通訊埠、通訊協定、使用者識別碼、傳輸方式與 TLS 開關。使用 WebSocket 時，再核對路徑與 Host；使用其他傳輸方式時，不要照搬這些欄位。
  3. 確認 SNI，也就是 TLS 交握時宣告的伺服器名稱。它不一定等於連線使用的 IP 位址，請以伺服器設定要求為準。
  4. 使用 REALITY 時，請依伺服器要求核對公鑰、短識別碼與伺服器名稱，勿套用一般憑證錯誤的處理方式。

啟動失敗：先處理通訊埠占用與設定解析

若服務啟動後立即退出，請先處理啟動日誌，暫時不要測試網頁。核心未成功監聽時，瀏覽器出現代理連線失敗只是後續結果。切換節點無法修復本機設定語法錯誤或監聽位址衝突。

錯誤：address already in use

原因：監聽位址與通訊埠已被其他程序占用，或核心遭到重複啟動。

解法：查詢占用通訊埠的程序，並正常關閉重複的執行個體；若變更本機監聽通訊埠，也要同步修改使用該通訊埠的應用程式設定。

錯誤：failed to load config files

原因：設定載入失敗；可能是路徑無法讀取、JSON 語法錯誤，或目前核心不支援某個欄位。

解法：接著查看後續的檔名、欄位名稱與行列提示，還原最近一次可用的設定，並確認設定與核心相容。

在 Windows 上，可沿用前面的通訊埠查詢指令查看 OwningProcess，再用下列指令確認程序。確認所屬應用程式後，請正常關閉；別一看到占用就強制結束不明的系統程序。

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

Get-Process -Name *v2ray*, *xray* -ErrorAction SilentlyContinue

常見問題：有警告、沒有日誌或測速正常時怎麼辦？

日誌出現 warning，但網頁能開啟，需要立即修改設定嗎？

先核對警告發生時間與目標。背景程式取消請求，或某個直連目標連線失敗，都可能與目前頁面無關。只處理能穩定重現且確實影響使用的錯誤；保留日誌比對，不要以警告數量判斷節點品質。

開啟 info 後，瀏覽網頁仍完全沒有新紀錄？

先確認核心已啟動，再使用明確指定代理的指令測試已確認的本機通訊埠。若明確指定代理後有紀錄、瀏覽器卻沒有，請重新檢查瀏覽器或系統代理；v2rayNG 則檢查 VPN 服務狀態，以及分應用程式代理是否排除了該應用程式。

延遲測試正常，為什麼實際連線還是逾時？

先確認測速類型。TCP 延遲只能驗證部分連線流程，無法保證身分驗證、TLS 或目標網站都能順利存取。請用同一個節點實際開啟一次網頁，再依日誌判斷是卡在遠端連線，還是後續交握；不要只憑延遲數值就排除節點設定問題。

把完整訂閱和日誌一起傳給維護者會比較方便嗎？

先隱藏訂閱連結、使用者識別碼、權杖、密碼與個人位址，只保留錯誤原文、時間及必要脈絡。保留「本機位址」「節點位址」「目標位址」等角色說明，直接刪除敏感欄位並註明已隱藏；不要傳送完整設定截圖。

整理排查結果，讓下一次測試有明確結論

完成一輪排查後，使用同一個節點、目標與網路重新測試。成功一次只能證明當下這次請求可用；若原本的問題是間歇性逾時，還需在原本的使用情境中持續觀察。回報維護者時，寫清楚操作與結果，比只說「還是不行」更有助於找出問題。

最後恢復日常使用的日誌等級，並保留可用的設定副本。連線遭拒先檢查監聽狀態與通訊埠；逾時先確認發生階段；身分錯誤先檢查憑證與通訊協定；憑證錯誤先檢查時間與信任鏈。依層次排查，才能避免在無關設定間反覆切換。

下載用戶端