v2rayN 核心啟動失敗怎麼辦：從日誌逐行找出設定錯誤

先釐清 v2rayN 的啟動流程

按下啟動後，v2rayN 並不會直接建立代理連線。它會先讀取目前的伺服器、路由、DNS 與本機連接埠設定，產生一份供核心使用的設定檔，再啟動 Xray 或 V2Ray 核心程序。核心讀取設定、監聽本機連接埠後，才會嘗試連線至遠端伺服器。

因此，「核心啟動失敗」和「核心已在執行但網站無法開啟」是兩類問題。前者通常表現為程序剛出現便退出、系統匣狀態很快恢復，或日誌出現設定解析、監聽失敗。後者則往往已看到本機 SOCKS、HTTP 連接埠開始監聽，只是在交握、網域解析或路由階段失敗。

排查時先回答三個問題：

1. 核心程序是否確實啟動並持續執行？
2. 本機代理連接埠是否成功進入監聽狀態？
3. 第一個致命錯誤是在讀取設定、監聽連接埠，還是連線至遠端之後出現？

開啟日誌視窗，保留一次完整的啟動流程

在 v2rayN 主視窗中開啟日誌區域或日誌視窗，然後停止目前的核心。確認畫面乾淨後重新選擇目標伺服器並啟動一次，不要連續點擊啟動按鈕。連續重試會把多次紀錄混在一起，也可能留下短暫執行的舊程序，讓連接埠遭佔用的問題更難判斷。

閱讀日誌時，先確認時間戳記屬於剛才的操作，再區分 v2rayN 自身輸出與核心輸出。介面層負責產生設定並呼叫程序；Xray、V2Ray 的輸出則更接近真正的失敗點。常見線索大致分為以下幾組：

• 設定解析：出現 invalid、failed to parse、unexpected、unknown field 等關鍵字。
• 連接埠監聽：出現 bind、listen、address already in use 或 access denied。
• 協定參數：出現 UUID、security、flow、transport、Reality、TLS 等欄位名稱。
• 檔案與程序：出現 file not found、permission denied、cannot execute 或路徑錯誤。
• 遠端連線：出現 timeout、connection refused、handshake、certificate 或 DNS 查詢失敗。

如果日誌只顯示「程序退出」或一個退出代碼，請向上翻閱幾行。退出代碼能說明程序未正常完成，卻未必能告訴你具體欄位。真正可操作的資訊通常位於它之前。也可以暫時提高日誌層級，但修復後應恢復常用層級，避免大量除錯紀錄掩蓋關鍵錯誤。

將日誌分享給維護者前，應刪除訂閱網址、伺服器位址、使用者識別資訊、密碼、Reality 公鑰相關設定與完整分享連結。保留錯誤類型、欄位名稱、時間順序、客戶端版本與核心類型，通常已足以定位問題。

看到 bind 或 address already in use：處理連接埠遭佔用

v2rayN 需要監聽本機 SOCKS、HTTP 等入口連接埠。如果其他程式、舊核心程序或第二個 v2rayN 執行個體已佔用相同連接埠，新程序就會立即退出。日誌中通常能看到 bind failed、address already in use，或系統提示某個通訊端位址只能使用一次。

先在 v2rayN 設定中記下目前的本機連接埠。連接埠不一定是某個固定數字，應以目前介面和本次產生的設定為準。在 Windows 終端機中，可使用以下命令查看佔用者，將範例連接埠替換為實際值：

netstat -ano | findstr :10808
tasklist /FI "PID eq 程序編號"

第一個命令末尾會顯示程序編號，第二個命令可依此查詢程式名稱。若佔用者是上次異常殘留的核心程序，先從 v2rayN 正常停止核心，再確認程序是否已退出。若是其他代理工具或本機開發服務，應關閉衝突程式，或在 v2rayN 中改用未被佔用的連接埠。

修改連接埠後，還要同步檢查瀏覽器、終端機環境變數，以及需要手動填寫代理設定的應用程式。核心能啟動但應用程式仍指向舊連接埠，會產生「啟動成功卻無法存取」的第二層故障。不要為了避開衝突而連續隨機修改多個連接埠；每次只改一項，並記錄修改前後的數值。

看到 parse、invalid character：修正 JSON 與規則結構

v2rayN 通常會依照介面選項產生設定。如果使用自訂設定、手動編輯的出站、複雜路由規則，或匯入內容本身不完整，就可能產生核心無法解析的 JSON。典型日誌包括 unexpected end、invalid character、failed to parse config、unknown field 和 cannot unmarshal。

unexpected end 通常表示內容遭截斷，例如缺少右大括號或右方括號。invalid character 往往指向多餘逗號、中文標點、錯誤引號，或不應出現的註解。標準 JSON 的鍵名和字串必須使用英文雙引號，最後一項後面不能保留多餘逗號，也不能直接寫註解。

以下這類結構會因結尾多餘逗號而失敗：

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

修正時不要只盯著日誌回報的行號。解析器經常在「確認無法繼續讀取」的位置報錯，真正缺少的符號可能位於上一行。先檢查錯誤行前後的逗號、引號和括號是否成對，再檢查欄位類型。例如連接埠應為數字時，不應誤寫成含有額外字元的文字。

路由設定也容易出現結構正確但欄位內容無效的情況。網域規則、IP 規則和出站標籤代表不同含義；若規則引用不存在的 outboundTag，核心可能拒絕設定，也可能在執行階段無法依預期分流。若錯誤發生在新增規則之後，先停用最近加入的規則並重新啟動，而不是一次刪除全部訂閱。

使用自訂設定時，最穩妥的方式是保留原始檔案副本，再從最小可執行結構開始，逐段加入 DNS、路由和出站。每加入一段就啟動一次。如此能將錯誤範圍縮小到最近的修改，而不是在數百行設定中反覆猜測。

設定可解析，但協定參數不相容

JSON 語法正確不代表連線參數正確。VMess、VLESS 是不同協定，驗證欄位、傳輸設定與加密相關選項不能互換。匯入訂閱後，v2rayN 會依條目產生出站設定；若訂閱內容過時、欄位缺漏，或手動修改時選錯協定，日誌可能在啟動檢查或首次連線時回報參數無效。

核對 VLESS 條目

VLESS 條目至少要核對伺服器位址、連接埠、使用者識別資訊、傳輸方式與安全層。若使用 REALITY，還要核對 serverName、公鑰、shortId、指紋和 flow 等欄位是否與伺服器端提供的資訊一致。常見的 flow 值與具體傳輸組合有關，不能因為其他節點使用某個值就直接照抄。

若日誌提到 unsupported flow、invalid public key 或 Reality handshake，先回到訂閱來源更新條目，不要憑感覺補上欄位。伺服器位址能解析、連接埠能連通，只能證明網路已抵達目標，不能證明 REALITY 參數一致。

核對 VMess 條目

VMess 同樣依賴正確的使用者識別資訊、連接埠和傳輸參數。較舊設定中可能出現 alterId 等歷史欄位，新版伺服器通常採用不同的建議設定。客戶端條目應以目前伺服器設定為準，不要把舊節點參數拼接到新節點上。若訂閱更新後只有某一個 VMess 節點失敗，可複製該節點進行對照，但不要修改原條目後失去參照。

核對傳輸層

TCP、WebSocket、gRPC 等傳輸方式對應不同欄位。WebSocket 通常涉及路徑和 Host；gRPC 涉及服務名稱；TLS 還涉及 serverName。路徑多一個斜線、服務名稱大小寫不同、Host 指向錯誤，都可能讓核心正常啟動，卻在交握階段失敗。

要判斷是節點問題還是全域設定問題，可以選擇同一訂閱中的另一台已知可用伺服器進行測試。若所有節點都在核心啟動前失敗，優先檢查本機設定、連接埠和核心檔案。若只有單一伺服器在連線階段失敗，優先核對該條目的協定參數與伺服器端狀態。

檢查核心類型、檔案路徑與讀寫權限

v2rayN 是管理介面，實際的網路處理由 Xray 或 V2Ray 核心完成。某些協定能力和欄位只有特定核心版本支援。如果日誌出現 unknown field、unsupported security，或無法辨識某項 Reality 設定，應先確認目前條目選用的核心類型，再確認核心版本是否具備相應能力。

不要藉由反覆切換核心來掩蓋設定錯誤。VLESS 與 REALITY 情境通常需要相符的 Xray 能力；一般 VMess 設定則仍要確保欄位符合所選核心的格式。切換後若錯誤關鍵字從「未知欄位」變成「交握失敗」，表示設定已進入下一階段，但遠端參數仍需核對。

file not found 或 cannot execute 通常指向核心檔案遺失、路徑變更，或程式沒有執行權限。先在 v2rayN 設定中確認核心目錄，再檢查對應檔案是否確實存在。若曾搬移整個程式目錄、只複製部分檔案，或從舊版本覆蓋升級，介面記錄的路徑可能仍指向原本的位置。

設定目錄也必須可寫入。v2rayN 會在啟動前產生暫存或執行設定；若程式位於目前帳戶無法寫入的位置，就可能在啟動核心前失敗。將程式放入目前使用者可正常讀寫的目錄，重新啟動後觀察日誌是否能產生設定。不要只依賴高權限執行作為長期方案，這可能改變設定檔的擁有者，也會讓後續以一般權限啟動時出現新的讀寫差異。

安全性軟體或系統政策攔截程序時，日誌有時只會留下啟動失敗或檔案存取錯誤。此時應根據系統安全性紀錄確認實際遭攔截的檔案與規則，再決定是否允許該程式執行。不要關閉整套防護設定來測試；縮小到明確的檔案、目錄和程序，更容易復原，也更有利於確認原因。

一套可重複的排查順序

同時修改連接埠、節點、路由和 DNS，會讓結果失去可比性。依照以下順序操作，每一步都重新啟動一次，並記錄日誌中的第一個錯誤。

1. 保存現場。記下 v2rayN 版本、核心類型、目標伺服器備註、本機連接埠和第一個錯誤。複製日誌時先清除敏感的連線資訊。
2. 停止舊程序。從介面停止核心，確認沒有第二個 v2rayN 執行個體，也沒有殘留核心持續監聽相同連接埠。
3. 檢查本機監聽。遇到 bind 或 access denied，先解決連接埠與權限問題，不要提前修改遠端協定參數。
4. 撤回最近的修改。暫停剛加入的自訂路由、DNS 或出站設定，恢復到修改前的狀態。
5. 更新訂閱。從現有訂閱群組執行更新，再選擇更新後的條目。不要將訂閱網址當作單一節點分享連結匯入。
6. 換另一台同類型伺服器測試。區分單一節點參數錯誤與全域設定錯誤，測試期間保持本機連接埠和路由不變。
7. 核對核心能力。遇到 unknown field 或 unsupported 時，確認條目所需的協定能力與目前核心相符。
8. 恢復分流設定。核心穩定執行後，再逐項啟用路由和 DNS。每次只恢復一組規則。

如果需要建立最小測試環境，可以暫時使用預設路由、預設 DNS 和一台確認參數完整的伺服器，關閉額外的自訂入站與出站。最小設定能啟動後，再依序加入訂閱群組、網域分流、IP 規則和自訂 DNS。問題出現在哪一步，範圍就落在哪一組設定中。

常見問題