Xray 核心啟動失敗怎麼辦？排查連接埠占用、JSON 格式與欄位錯誤

Desktop 與 WPF 的差異：先分清介面、套件與核心

v2rayN 是用來管理節點、訂閱和代理設定的用戶端，實際建立代理連線的是 Xray 或其他已設定的核心。Desktop 與 WPF 主要是 v2rayN 的桌面介面與發行套件選項；它們本身不是 VMess、VLESS 等協定，也不是兩種不同的代理服務。只要相應版本支援所需設定，匯入的訂閱與節點仍由用戶端產生設定，再交給核心處理。

簡單來說，WPF 是 Windows 專用的介面技術，適合已習慣傳統 Windows 桌面程式操作方式的使用者。Desktop 版本則通常採用不同的桌面介面框架，可能提供與其他桌面平台較一致的使用體驗。兩者的選單排列、視窗外觀和套件內容可能不同；不同發行版本也可能調整打包方式，因此不能只依名稱推斷一定需要額外安裝哪個執行環境。

表格中的平台與執行環境是選擇時的檢查方向，不應取代該次發行版本的套件說明。特別是「免安裝」或「自含執行環境」等描述，可能因套件組合而異。下載後若出現缺少執行環境的提示，先核對套件名稱和官方說明，再安裝對應元件；不要因為兩個版本的介面不同，就直接判定節點或訂閱不相容。

怎麼選版本：依使用情境，而不是看哪個名稱比較新

如果主要在 Windows 使用，而且希望操作方式貼近一般 Windows 桌面程式，可先選 WPF。若偏好另一種桌面介面，或想在不同桌面平台之間維持較接近的操作習慣，可考慮 Desktop。若手邊已有一個版本能正常匯入訂閱、更新節點並啟動核心，也沒有介面或相容性問題，通常沒有必要只為了更換外觀而重裝。

選擇前也要分辨問題屬於哪一層。介面無法啟動，可能是套件不完整、執行環境缺少或安全軟體隔離檔案；介面能開啟但節點連不上，則可能與核心、節點參數、網路或伺服器狀態有關。後者通常不能靠改用 Desktop 或 WPF 解決。若更換版本，先保留原有設定備份，並記下目前使用的用戶端與核心版本，方便遇到問題時比對。

若目前仍不確定，可先使用下載中心列出的 Windows 套件，確認檔案名稱、架構及安裝說明後再下載。第一次安裝時不建議同時放入兩套版本並一起啟動；不同程式可能使用相同的本機監聽連接埠，造成連接埠占用，讓人誤以為節點故障。

下載與安裝前準備：確認架構、資料夾與系統提示

前往下載中心後，先找到 v2rayN 的 Windows 項目，再依頁面標示選擇 Desktop 或 WPF。也要確認處理器架構與套件類型；多數近年的 Windows 個人電腦使用 64 位元架構，但仍應以「設定」→「系統」→「關於」中的系統類型為準。不要把其他平台的套件或架構不同的檔案，當成 Windows 安裝檔執行。

1. 確認系統資訊

   開啟 Windows「設定」→「系統」→「關於」，查看 Windows 版本與「系統類型」。下載前核對頁面標示的系統和處理器架構；若電腦由公司管理，先確認是否有軟體安裝限制。

2. 選擇套件

   在下載中心的 Windows 區確認 Desktop 或 WPF，再查看套件是否包含執行環境。若說明標示需要另外安裝 .NET，記下所需的執行環境類型與版本，勿用其他主要版本的 Runtime 代替。

3. 解壓到資料夾

   若下載的是壓縮檔，使用 Windows 內建功能或可信任的解壓工具，將完整內容解壓至有寫入權限的資料夾，例如個人使用者目錄下的應用程式資料夾。不要只從壓縮檔預覽視窗直接執行主程式。

4. 首次啟動

   在解壓後的資料夾中找到 v2rayN 主程式並啟動。若 Windows 顯示安全性確認，先核對檔案來源、名稱與數位簽章或下載頁資訊；無法確認來源時不要略過警告。

5. 建立設定備份

   確認介面正常開啟後，先記錄用戶端版本與核心資訊，再匯入訂閱或節點。將備份放在安全位置；分享設定或記錄前，移除訂閱網址、節點位址和認證資料。

解壓後的資料夾不要只保留主程式，旁邊的資源檔和元件也可能是程式正常運作所需。若打算移動資料夾，先完全結束 v2rayN，再移動整個資料夾並重新啟動。將程式放在需要系統管理員權限才能寫入的位置，可能導致設定或記錄無法正常儲存；一般使用者資料夾通常較方便管理。

本機連接埠可能因版本、設定或其他程式而不同，10808 只作為說明範例。遇到連接埠衝突時，應先查看 v2rayN「設定」→「參數設定」內目前的監聽設定，再依實際數值排查，不要直接把範例數字當成所有電腦的固定值。

首次啟動檢查：先確認介面正常，再測試代理

程式能開啟只代表介面啟動成功，並不等於節點已連線。首次使用時，先確認視窗沒有缺少元件的錯誤，再依序匯入訂閱或新增節點、更新節點清單、選取一個節點並啟動服務。若使用訂閱，請從可信任的服務來源取得訂閱網址，不要將包含帳號識別資訊的網址貼到公開討論區或不明網站。

• 先確認節點已匯入：更新訂閱後，檢查節點清單是否出現預期項目。更新成功只表示下載或解析流程完成，不保證節點本身可用。
• 再確認核心已啟動：查看 v2rayN 訊息或記錄區有無核心啟動失敗、設定載入錯誤或連接埠占用。不要把介面視窗仍開著，當成核心正在運作的證明。
• 最後確認流量入口：使用系統代理時，確認用戶端已開啟系統代理，並測試會遵循系統代理設定的應用程式。TUN 是另一種接管方式，第一次排查不必一開始就同時啟用多種模式。
• 測試一個目標：固定同一個節點與測試網站，記下測試時間和錯誤內容。若只有單一應用程式無法連線，還要確認該應用程式是否使用系統代理，或是否有自己的代理設定。

若要確認本機代理監聽是否存在，可在 Windows 終端機執行 netstat -ano -p tcp | findstr ":10808"，但須先把範例連接埠換成目前設定中的實際數值。看到 LISTENING 只能表示有程序在該連接埠監聽，不能單獨證明遠端節點或目標網站可用；若查到連接埠已被其他程序使用，先確認程序名稱，再正常關閉多餘的用戶端或調整本機監聽設定。

執行環境與防毒誤刪：按提示處理，不要盲目關閉防護

如果啟動時出現缺少 .NET 或執行環境的訊息，先確認目前執行的是 Desktop 還是 WPF，再查看該套件隨附的說明。需要 .NET 時，應安裝與程式要求相符的執行環境；桌面程式所需的 Desktop Runtime 不一定能由只包含命令列元件的 Runtime 取代。若下載頁提供自含執行環境的套件，也要核對套件名稱及架構，避免混用不同套件中的檔案。

如果 Windows 安全性或其他防毒軟體隔離了主程式、核心或資源檔，先不要整體停用防護。確認檔案是從本站下載中心提供的入口取得，重新查看下載檔名與解壓內容，再到安全性軟體的隔離或保護記錄查看偵測名稱和檔案路徑。若來源無法驗證、偵測內容不清楚，或檔案來自不明轉載頁面，應移除檔案並重新從可信任來源取得。

• 確認隔離的是 v2rayN 主程式、核心執行檔，還是解壓工具產生的其他檔案；不要只依「v2rayN 無法啟動」推斷是防毒誤判。
• 若確認檔案來源可信，按照防毒軟體的官方操作方式還原單一檔案，或僅針對已確認的程式路徑建立必要的例外。
• 重新啟動程式後查看記錄，確認核心是否仍缺少檔案或被阻擋；若問題持續，移除例外並重新取得完整套件，再尋求安全軟體廠商或程式發行說明協助。
• 不要為了安裝而關閉所有即時防護，也不要把整個下載資料夾、使用者目錄或所有核心程式一律加入排除清單。

若用戶端能開啟，但核心一啟動就退出，應查看錯誤訊息是否指向檔案遭隔離、缺少執行環境、設定格式錯誤或連接埠占用。必要時記下用戶端版本、核心名稱與版本、Windows 提示文字及錯誤發生時間。分享記錄前遮蔽節點位址、訂閱網址、使用者名稱及任何認證資訊，避免為了排錯而公開敏感資料。

常見問題

若仍無法啟動，先回到下載頁核對目前使用的套件，再依錯誤文字分辨是執行環境、檔案遭隔離、核心設定還是本機連接埠問題。一次只改一項設定，重現並記錄結果，比反覆重裝或同時修改多個參數更容易找出原因。