v2rayN 核心啟動排查

先分辨核心未啟動與節點無法連線

v2rayN 是用戶端介面，Xray、V2Ray 等核心負責讀取設定、建立本機監聽並處理連線。主視窗顯示伺服器清單，不代表核心已成功執行；系統代理切換為開啟，也不表示相應的本機連接埠已有人監聽。排查應從這次啟動的日誌開始，而不是從瀏覽器的「無法連線至這個網站」著手。

如果日誌顯示讀取設定後立即退出，並出現 Failed to start、failed to load config 或連接埠繫結失敗等訊息，應優先檢查本機設定。如果核心持續執行、本機代理連接埠也已在監聽，只有存取目標時才發生逾時、憑證錯誤或連線遭拒，則應改查節點位址、TLS 與網路連線。日誌用語會因核心版本而異，以下列出常見錯誤片段，不必與整行文字完全相同。

• 載入設定階段：留意 config、json、line、offset，此時通常尚未建立代理監聽。
• 建立監聽階段：留意 listen、bind、本機位址與連接埠，優先排查連接埠占用與監聽位址。
• 處理請求階段：留意目標網域、遠端連接埠、timeout、x509，不要一開始就修改 JSON 標點。

保留這次日誌與實際設定檔路徑

先記下 v2rayN「說明」→「關於」中的用戶端版本，再記錄啟動日誌所列的核心名稱、版本與設定檔路徑。桌面版與 WPF 版的部分選項位置不同；本文提到的參數項目可從「設定」→「參數設定」進入，實際分組名稱請以目前介面為準。不要只根據介面版本推斷核心版本，也不要因為在安裝目錄找到同名檔案，就認定它是這次載入的設定檔。

1. 保存舊日誌

   先將目前錯誤複製到本機文字檔，再清空主視窗的日誌顯示區。重新選取目前伺服器並設為作用中伺服器，觸發核心重新啟動，只保留這次操作產生的連續日誌。

2. 確認核心

   查看啟動日誌中的執行檔名稱與版本。若剛修改核心選擇，請開啟「設定」→「參數設定」核對核心相關項目，並以實際啟動輸出為準。

3. 確認檔案路徑

   記下載入中設定檔的完整路徑。一般節點產生的設定檔與自訂設定檔處理方式不同；先複製一份目前出錯的檔案作為診斷副本，不要直接覆寫用戶端的持久設定。

4. 查看錯誤末端

   沿著同一串錯誤訊息，從外層提示一路讀到最後的原因。例如「設定載入失敗」後面的「檔案不存在」才是要修復的問題，不要只截取最前面的失敗提示。

一般節點的執行設定可能會在重新設為作用中伺服器、切換路由或重新啟動時重新產生。直接修改產生的 config.json，常會遇到「才修好又被還原」的情況。確認原因後，應回到節點編輯、路由設定或參數設定中修正來源；只有明確使用自訂設定時，才維護該自訂檔案。

連接埠占用：先找出監聽程序，再更改連接埠

最常見的情況是另一個用戶端執行個體或未清除的核心占用了本機監聽連接埠。以下以 Windows 上的 127.0.0.1:10808 為例；這只是排查示範，並非所有版本都使用這個連接埠。請在「設定」→「參數設定」核對本機監聽連接埠；若目前介面將 SOCKS、HTTP 或混合連接埠分開設定，請逐一檢查，不要照抄範例數字。

在 PowerShell 中執行以下命令，只篩選 TCP 監聽連線，避免將遠端連線中剛好出現的同號連接埠誤判為占用。輸出中的 OwningProcess 是程序識別碼；先查看程序名稱與程式路徑，再決定是否關閉。

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

Get-NetTCPConnection -State Listen -LocalPort 10808 |
  ForEach-Object { Get-Process -Id $_.OwningProcess }

若沒有任何結果，表示查詢當下未發現該連接埠有 TCP 監聽，並不代表設定一定正確。還要檢查日誌中的實際位址、是否有其他 UDP 衝突，以及是否出現 access permissions 之類的系統限制。若將連接埠改為 10809，需同步更新手動設定代理的瀏覽器與終端機；若系統代理由用戶端管理，請重新設定系統代理以更新連接埠。測試前也要確認備用連接埠未被占用。

JSON 語法錯誤：先修正結構，再檢查參數

JSON 解析失敗通常發生在手動撰寫自訂設定、複製片段或編輯路由規則之後。常見問題包括物件成員之間漏了逗號、字串使用中文引號、括號未成對，以及最後一個項目後多出逗號。不同載入器對註解等擴充語法的支援不一；跨版本排錯時，建議先將副本改寫為嚴格 JSON。

以下是合法的局部物件，示範數字連接埠、字串引號與陣列的閉合方式，不是可直接啟動的完整設定。將規則片段併入現有檔案時，應確認它所屬的父層欄位，不可直接將兩個完整 JSON 物件首尾相接。

{
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "udp": true
      }
    }
  ]
}

• 如果日誌提供行號與欄號，先檢查該位置，再往前檢查一行；解析器標示的位置可能只是「發現無法繼續解析」的地方。
• 如果日誌只提供位元組偏移量，別直接把它當成中文字元數。使用本機編輯器的 JSON 檢查功能定位，避免手動計數出錯。
• 不要將包含伺服器位址、使用者識別資訊或訂閱資訊的完整設定提交至線上格式化工具。分享錯誤訊息時，保留結構與欄位名稱，並遮蔽憑證。

未知欄位與不支援的設定值

JSON 能成功解析，只能證明檔案結構成立，不代表核心支援其中所有協定、傳輸方式或參數。v2rayN 的介面設定、V2Ray 設定與 Xray 設定並非同一種檔案。將用戶端儲存的設定檔當成核心設定，或直接匯入其他核心的設定，都可能造成載入失敗或行為異常。

還要注意，未知欄位不一定會引發錯誤，有些解析流程會忽略無法辨識的鍵。沒有出現「unknown field」，不能據此判斷欄位拼字正確。更常見的情況是某個設定值不受支援，例如 unknown transport protocol；此時應核對傳輸方式與實際執行的核心，而非只調整 JSON 標點。

• 先檢查層級：streamSettings 屬於相應的入站或出站設定物件，不可任意移到設定根層。
• 再檢查型別：布林值 true 與字串 "true" 並不相同；欄位要求的物件、陣列與數字，應依相應核心的定義填寫。
• 最後檢查相容性：新欄位可能需要較新版本的核心。更新時請確保用戶端與所需的核心元件完整，不要只替換來源不明的單一執行檔。

VMess、VLESS 是協定名稱，不能互相替換來「試試看」是否能修好。伺服器協定、傳輸方式與安全參數之間有明確的對應關係。若是從訂閱匯入的一般節點，請優先重新匯入有效設定並核對伺服器要求；若是自訂設定，請保留原始檔案，逐項比對可疑欄位與目前核心支援的範圍。

geo 檔案遺失：檢查檔案、路徑與分類名稱

路由使用 geoip:cn 或 geosite:cn 時，採用傳統 DAT 資料的設定通常需要相應的 geoip.dat、geosite.dat。錯誤訊息可能先顯示「建立路由規則失敗」，到末端才指出資料檔案無法開啟或分類不存在。前者是結果，後者才決定應補上檔案還是修改規則。

1. 從日誌複製完整資源路徑，不要假設工作目錄就是程式所在目錄。自訂啟動方式與資源路徑設定可能會改變搜尋位置。
2. 若檔案不存在，請檢查用戶端的資源更新入口與更新日誌；必要時從完整用戶端套件還原相應元件，再確認檔案確實已寫入目標目錄。
3. 若檔案存在但分類不存在，請核對規則中的分類名稱與資料來源。不同資料檔案包含的分類可能不同，重新命名檔案也無法增加分類內容。
4. 暫時停用引用該分類的自訂規則後，如果核心能啟動，可將問題範圍縮小至規則與資料相依性；恢復使用前仍應補齊資料並重新驗證分流。

修復後依相同步驟重新測試

每次只修改一個變數，然後重新啟動核心並保存新日誌。如果同時更換節點、修改連接埠、更換核心又刪除路由，即使恢復正常，也無法判斷真正原因。若使用自訂 Xray 設定，可用實際配套的 Xray 執行檔測試載入；以下命令應在診斷副本所在目錄執行，檔名為 config.json。

.\xray.exe run -test -config .\config.json

此命令適用於支援這種命令列格式的 Xray；其他核心請先查看自身說明，不要直接套用。測試時應使用與用戶端相同的資源環境，否則 geo 檔案搜尋路徑不同可能造成額外錯誤。設定測試通過不代表遠端連線正常，也不保證實際執行時能成功繫結連接埠，仍須回到用戶端驗證。

• 第一關：設定可載入。日誌不再出現解析失敗、設定建置失敗或資料檔案載入失敗。
• 第二關：監聽已建立。透過連接埠查詢確認預期位址、連接埠與程序相符，且核心沒有立即退出。
• 第三關：請求可正常通過。讓應用程式使用正確的本機代理，再檢查連線日誌；此時若出現 TLS 或逾時問題，應另行排查。
• 第四關：設定可保留。重新設為作用中伺服器並重新啟動用戶端，確認修正已套用至設定來源，而不只是修改了暫存檔案。

核心啟動失敗常見問題