本文速覽

核心啟動失敗大多是設定問題。排查主線:先開啟 v2rayN 日誌視窗看錯誤,再按「JSON 語法錯誤 → 連接埠占用 → 憑證設定 → 核心檔案缺失」四條線逐項定位。本文給出每條線的判斷方法與修復步驟。

為什麼核心會啟動失敗

V2Ray 核心啟動失敗是使用過程中最常見的問題之一。核心負責解析設定檔、建立連線、轉發流量,任何設定錯誤都可能導致核心無法啟動。v2rayN 會透過日誌視窗顯示核心輸出,這些日誌是排查問題的第一手資料。

常見的啟動失敗原因

設定檔 JSON 語法錯誤、連接埠被占用、憑證設定錯誤、核心檔案缺失等。下面逐一分析如何定位和修復。

JSON
語法錯誤:逗號、引號、括號不對稱
連接埠
10808 / 10809 被其他程式占用
憑證
serverName 不符或 allowInsecure 設定不當
核心
xray.exe / v2ray.exe 檔案缺失

開啟日誌視窗

在 v2rayN 中,日誌視窗位於主介面底部。如果日誌視窗沒有顯示,可以在「設定」→「參數設定」中開啟「顯示日誌視窗」。日誌會即時顯示核心輸出,包括啟動資訊、連線狀態、錯誤資訊。

錯誤訊息長什麼樣

啟動失敗時,日誌中會出現類似 failed to startinvalid config 的錯誤。這些錯誤訊息會指出具體的錯誤位置,例如設定檔路徑、欄位名稱等。

開啟日誌視窗

在「設定」→「參數設定」中勾選「顯示日誌視窗」,主介面底部會顯示核心輸出。

記錄錯誤訊息

啟動失敗時,複製日誌中的錯誤行,如 failed to start 或 invalid config。

判斷錯誤類型

根據錯誤關鍵字判斷是 JSON 語法、連接埠、憑證還是核心檔案問題。

逐項修復

按下文四條線逐項定位並修復,修復後重新啟動核心驗證。

定位 JSON 語法錯誤

設定檔是 JSON 格式,語法錯誤會導致核心無法解析。常見的語法錯誤包括:缺少逗號、引號不匹配、括號不對稱。在 v2rayN 中,可以點擊「設定」→「開啟設定目錄」找到 config.json,使用支援 JSON 語法高亮的編輯器檢查。

小技巧:看報錯行號

錯誤訊息裡通常會給出「第幾行第幾列」。例如 invalid config: line 12, column 5,說明錯誤就在第 12 行附近。回到編輯器,重點檢查那一行的逗號、引號與括號是否配對。如果報錯只給出行號沒有列號,可以先把設定格式化(縮排對齊)再看,結構一目了然。

{
  "inbounds": [
    {
      "port": 10808,
      "protocol": "socks"
    }
  ]
}

上面的範例是一個簡化設定,儲存為 config.json 後,核心可以正常啟動。如果修改設定時漏掉了一個逗號,核心會報 invalid config 錯誤。

注意:別把真實伺服器資訊上傳到第三方

如果設定檔很長,可以將內容貼到線上 JSON 驗證工具中檢查。但需要注意,不要在設定中保留真實伺服器資訊後再上傳到第三方工具。

開啟日誌 看報錯關鍵字 定位錯誤類型 修改設定 重新啟動核心 驗證連線

檢查連接埠占用

連接埠被占用是另一個常見原因。v2rayN 預設使用 10808 連接埠作為 SOCKS 入站,10809 連接埠作為 HTTP 入站。如果這些連接埠已被其他程式占用,核心啟動會失敗。

怎麼查連接埠占用

在 Windows 上,可以使用 netstat -ano | findstr 10808 指令查看連接埠占用情況。如果輸出結果不為空,說明連接埠已被占用。可以透過修改 v2rayN 的入站連接埠來避開衝突,或者關閉占用連接埠的程式。

修改連接埠後需要同步更新系統代理

在 Windows 中,系統代理設定位於「設定」→「網路和 Internet」→「代理」。確保 SOCKS 連接埠和 HTTP 連接埠與設定一致。

憑證設定錯誤

使用 TLS 或 REALITY 傳輸時,憑證設定錯誤會導致連線失敗。常見的錯誤包括:serverName 與憑證不符、憑證過期、allowInsecure 設定不當。

REALITY 協定的特殊要求

REALITY 協定對憑證的要求更特殊:它不需要真實憑證,但要求 serverName 指向一個真實存在且可存取的網域(如某個大型網站),否則握手會被拒絕。如果你用的是 REALITY 節點卻報憑證錯誤,先檢查 serverName 是否填了真實網域,再檢查 shortIdpublicKey 是否與節點資訊一致。

自簽憑證怎麼處理

在 v2rayN 中,可以透過「節點設定」→「傳輸安全」檢查憑證設定。如果使用自簽憑證,需要將 allowInsecure 設定為 true,但這會降低安全性。正常使用時建議使用有效的 CA 憑證。

核心檔案缺失

如果日誌顯示找不到核心檔案,說明 v2rayN 的設定目錄中缺少 xray.exev2ray.exe。在 v2rayN 的「設定」→「核心設定」中可以檢查核心路徑。如果核心檔案缺失,需要重新下載用戶端並確保核心檔案完整。

核心版本不符怎麼辦

還有一種情況:核心檔案存在,但版本與用戶端不符。例如 v2rayN 更新後,舊核心可能不相容新設定格式。此時在「核心設定」中點擊「更新核心」或重新下載對應版本的核心即可。另外,防毒軟體可能誤刪核心檔案,如果核心反覆「消失」,請把 v2rayN 目錄加入防毒軟體白名單。

Xray 核心

推薦

v2rayN 預設使用 Xray 核心,支援 VLESS、REALITY 等較新協定,效能更好。

適用:大多數使用者

V2Ray 核心

經典核心,相容舊協定。若節點只支援舊協定,可切換回 V2Ray 核心。

適用:舊協定節點

總結排查流程

報 invalid config

JSON 語法錯誤。開啟 config.json 檢查逗號、引號、括號,或用驗證工具檢查。

報 port already in use

連接埠被占用。用 netstat 查詢占用程式,修改入站連接埠或關閉占用程式。

報 certificate 相關錯誤

憑證設定錯誤。檢查 serverName 與憑證是否相符,allowInsecure 是否設定正確。

報找不到核心檔案

核心檔案缺失。在「核心設定」中檢查路徑,重新下載用戶端並確認檔案完整。

排查心法

日誌是核心的「自白」。遇到啟動失敗,先別急著改設定,把日誌裡第一行錯誤讀清楚,它往往直接指向問題欄位。按「語法 → 連接埠 → 憑證 → 核心檔案」的順序排查,絕大多數問題都能在幾分鐘內定位。

改完設定後核心還是啟動失敗?

確認修改已儲存,並在 v2rayN 中點擊「重新啟動核心」或重新啟動用戶端。有時設定快取未刷新會導致舊設定仍被載入。

日誌視窗是空的怎麼辦?

在「參數設定」中確認「顯示日誌視窗」已勾選,並檢查核心是否真的有被啟動。如果核心路徑錯誤,日誌可能不會輸出。