v2rayN 核心啟動失敗排除：查看日誌，找出連接埠占用與設定錯誤

一、先分辨核心退出與連線逾時

v2rayN 是圖形化管理介面，代理連線由它呼叫的核心處理。主視窗能開啟，不代表核心已在執行；反過來說，網頁無法開啟，也不一定是核心啟動失敗。請先查看主畫面下方的日誌區域：若啟動後出現讀取設定錯誤或監聽失敗，接著程序退出，才需要依本文流程排查。

如果日誌已顯示監聽成功，之後瀏覽網站才出現 i/o timeout，應優先檢查節點連線、DNS 與路由分流。別把執行期間的請求錯誤當成啟動錯誤，也不要在核心尚未成功啟動前反覆修改系統代理。系統代理只會決定應用程式將流量交給誰，無法修正核心的 JSON 語法。

1. 記錄目前狀態

   在「說明」→「關於」記下 v2rayN 版本，並從啟動日誌記錄實際使用的核心名稱與版本。不同介面版本的選單文字可能略有差異，請以目前畫面為準。

2. 重現一次錯誤

   選取目前節點，按 Enter 設為作用中伺服器。查看本次啟動時間附近的日誌，保留從讀取設定到程序退出的完整內容，不要只截取最後一句「啟動失敗」。

3. 找出最深層原因

   沿著 failed to、冒號或 > 串接的錯誤訊息往後讀，找出連接埠、欄位名稱、檔案路徑或行列位置。這些資訊比上層的概括訊息更有助於定位問題。

4. 一次只修改一項

   先備份設定或自訂設定，再只修改確認有問題的項目。重新啟用節點後比對新日誌，確認原本的錯誤已消失，再處理下一項。

二、連接埠占用：透過 PID 找出監聽程序

錯誤訊息中包含 listen tcp、bind 或 address already in use 時，請先檢查本機監聽連接埠。以下錯誤片段用於辨識問題類型；不同系統與核心版本的完整前綴可能有所不同。Windows 上的綁定錯誤也可能與連接埠保留或安全性原則有關，不能只看到 bind 就認定是某個程序占用了連接埠。

在 Windows 終端機執行以下兩個指令。第一個指令會搜尋包含 10808 的 TCP 記錄；從 LISTENING 那一行最右側讀取 PID，再將第二個指令中的 1234 換成實際 PID。也要核對「本機位址」欄，避免把遠端連接埠剛好是 10808 的連線誤認為本機監聽。

netstat -ano -p tcp | findstr ":10808"
tasklist /FI "PID eq 1234"

• 重複程序：先從系統匣正常結束另一個 v2rayN 執行個體，再重新查詢連接埠。若仍有殘留程序，請在工作管理員核對執行檔路徑後，再結束工作。
• 其他程式占用：開啟「設定」→「參數設定」，找到本機入站監聽連接埠欄位；確認 10818 未被占用後，可將原本的 10808 改為 10818。這只是範例數值，不保證所有電腦都能使用。
• 同步更新手動設定：如果瀏覽器或其他程式手動設定了 127.0.0.1:10808，修改監聽連接埠後也要一併更新；若使用 v2rayN 系統代理選單中的應用程式，請重新套用系統代理。
• 查不到監聽程序：若日誌顯示存取遭拒，而非位址已被占用，可執行 netsh interface ipv4 show excludedportrange protocol=tcp 檢查保留連接埠範圍。不要因此直接關閉防火牆或刪除系統保留項目。

三、JSON 語法錯誤：先修正格式，再檢查協定欄位

自訂設定啟動失敗時，先確認是否在 JSON 解析階段就已中斷。常見問題包括結尾多了一個逗號、字串使用全形引號、物件括號未成對，以及 Windows 路徑中的反斜線未跳脫。一般訂閱節點通常由 v2rayN 產生執行設定；若沒有手動編輯設定，也應檢查訂閱內容與產生過程，而不是憑感覺重寫整份檔案。

以下是刻意保留錯誤的片段："warning" 後面的逗號不應出現在物件的最後一個欄位之後。這只是語法示範，不是可執行的代理設定。

{
  "log": {
    "loglevel": "warning",
  }
}

移除這個逗號後，片段的 JSON 語法才正確。語法正確不代表核心設定有效：還要繼續檢查欄位名稱、欄位型別與協定支援範圍。路徑應寫成 "C:\\Tools\\v2rayN\\rules"，不能在 JSON 字串中直接放入單一反斜線。

{
  "log": {
    "loglevel": "warning"
  }
}

四、未知欄位：確認實際使用的核心與設定來源

JSON 可以解析，但核心不接受某個欄位或協定時，請檢查設定所對應的核心及其版本。v2rayN 版本與核心版本是兩回事，更新介面程式不代表所有核心都已更新。應以日誌中實際啟動的執行檔及版本作為判斷依據。

Xray 與 V2Fly 的設定架構有部分共通之處，但不代表每個欄位都能互換。例如 REALITY 與 XTLS Vision 是 Xray 相關功能，含有這些設定的設定檔不能直接交由 V2Fly 使用。即使使用 Xray，較舊的核心也可能不認得較新的設定項目。

• 在「設定」→「參數設定」尋找核心相關選項，確認目前節點使用的核心；若介面配置不同，請以啟動日誌顯示的名稱為準。
• 透過「檢查更新」中對應的核心更新入口處理版本問題。更新後重新啟動節點，並查看新的版本日誌，確認更新確實生效。
• 手動設定請先確認欄位所在的物件，再確認值的型別。數字、字串與陣列不能任意互換；不同解析器對未知欄位的處理方式也可能不同。
• 若只有一個訂閱節點失敗，其他節點都能正常啟動，請先比較該節點的協定、傳輸方式與安全設定，不要直接重設整個用戶端。

五、geo 檔案缺失：依日誌路徑還原規則資源

設定中的 geoip: 與 geosite: 規則通常需要對應的資源檔案。規則初始化發生在啟動階段，因此資源缺失、讀取權限不足或檔案格式不符，也可能導致核心立即退出。日誌出現檔名時，請先檢查實際讀取路徑，不要只確認下載資料夾中有同名檔案。

1. 確認讀取的檔案。從錯誤訊息中記下檔名與路徑，分辨讀取的是核心設定、規則資源還是執行檔；「找不到檔案」不一定代表 geo 資源有問題。
2. 還原目錄結構。如果最近搬移過程式，請確認是否只複製了主程式。備份設定後還原相關檔案，避免從不同來源任意拼湊資源。
3. 更新資源。在「檢查更新」中找到 Geo 檔案相關更新項目，等待更新完成後再重新啟動核心；若介面將不同資源分開列出，請分別確認更新結果。
4. 檢查項目名稱。檔案存在卻提示找不到某個分類時，請核對路由規則中的分類名稱是否與目前資料檔內容相符。重新下載無法修正原本就不存在的分類名稱。

六、修復後驗證：先確認監聽，再測試連線

判斷修復是否有效，要確認同類錯誤已消失，而不是只看視窗是否仍開著。重新啟用節點後，先確認核心沒有立即退出，再檢查監聽連接埠，最後套用系統代理並測試連線。若此時出現 TLS、DNS 或逾時錯誤，表示已進入連線階段，請依新的錯誤類型繼續排查。

• 程序層：日誌不再反覆顯示啟動後退出，核心程序持續執行。
• 監聽層：執行 netstat -ano -p tcp | findstr ":10808"，將連接埠替換為實際設定值，確認本機位址有出現預期的監聽狀態。
• 應用程式層：在系統匣的「系統代理」中選擇「自動設定系統代理」，再用瀏覽器實際送出一次請求。若手動設定代理，請核對位址與連接埠。
• 設定持續性：切換到其他節點後再切回，確認修復仍然有效。若錯誤再次出現，請檢查是否只修改了會被自動覆蓋的產生檔案。