V2Ray 用戶端啟動閃退怎麼辦：.NET 執行階段、安全軟體封鎖與資料夾權限

先判斷：視窗關閉，還是核心沒有啟動

v2rayN 是圖形介面用戶端，Xray、V2Fly 等核心負責實際處理代理連線。介面程序退出與核心子程序退出是不同問題。前者應優先檢查桌面執行環境，後者則先確認核心檔案、產生的設定檔與監聽連接埠。這裡的 Windows 執行階段處理方式不適用於 Android 版 v2rayNG 或 v2flyNG。

• 視窗消失，但程序仍在：按 Ctrl + Shift + Esc 開啟工作管理員，在「詳細資料」中尋找 v2rayN.exe；也請展開工作列隱藏圖示，確認程式是否只是縮到系統匣。
• 主程序也已消失：記下點兩下啟動的時間，接著查看 Windows 事件檢視器與啟動錯誤，優先排查執行階段和存取權限。
• 視窗正常，記錄檔卻反覆出現錯誤：先保存核心記錄檔，並確認對應的核心檔案是否存在。這種情況下，反覆重裝 .NET 通常無法解決問題。

先不要刪除原本的資料夾。完全結束程式後，將整個資料夾複製到備份位置；使用獨立使用者資料資料夾的版本，也應備份實際資料位置。訂閱網址、節點認證資料與自訂路由可能都儲存在其中，不能只備份主程式。

.NET 桌面執行階段：依程式需求選擇版本與架構

需要外部執行階段的 Windows WPF 版本，應安裝相符的 .NET Desktop Runtime。它與名稱相近的基本 .NET Runtime、ASP.NET Core Runtime 不同；只安裝後兩者，程式仍可能無法啟動。自包含版本通常不依賴外部安裝的 .NET，因此不應要求所有安裝套件都補裝執行階段。

1. 確認套件類型

   確認下載頁選取的是 WPF 版或其他桌面版本，並查看是否標示為自包含。不要將其他介面版本的執行階段需求套用到目前使用的檔案。

2. 查看架構需求

   如果資料夾中有 v2rayN.runtimeconfig.json，請用記事本開啟，查看 runtimeOptions.framework 或 frameworks 中的 name、version。若套件未附上此檔案，請以該版本的說明和啟動提示為準。

3. 檢查本機環境

   開啟 PowerShell 並執行下方命令。需要 Windows 桌面架構的版本，應看到適用的 Microsoft.WindowsDesktop.App 版本，而不只是 Microsoft.NETCore.App。

4. 安裝後重新測試

   前往 Microsoft 官方 .NET 下載頁面，下載主版本與架構相符的 Desktop Runtime。安裝完成後重新啟動用戶端；若系統提示需要重新啟動，請先重新開機再測試。

dotnet --info
dotnet --list-runtimes

例如，設定檔要求 Microsoft.WindowsDesktop.App 的 8.0.0 時，通常可使用符合預設修補版本更新規則的 8.0 桌面執行階段；這只是說明如何查看欄位，不代表所有 v2rayN 版本都使用 .NET 8。不要將「已安裝較新主版本」視為符合需求，也不要為了消除錯誤而任意修改 runtimeconfig.json。

安全軟體封鎖：先核對紀錄，再還原檔案

若更新後突然無法啟動，或解壓縮後發現核心檔案不見，請先檢查隔離紀錄。Windows 安全性中心的路徑為「病毒與威脅防護」→「保護歷程記錄」。依故障時間尋找項目，核對受影響檔案的完整路徑；若使用其他安全軟體，也請在其隔離區或事件紀錄中進行相同核對。

不要關閉整台裝置的即時防護，也不要將整個下載資料夾或磁碟加入排除清單。還原隔離檔案前，請先確認下載來源、發行套件類型與檔案路徑；無法確認的檔案應維持隔離，並重新取得可信任的發行套件。只還原一個核心執行檔也可能不夠，因為壓縮檔中的相依檔案也可能缺漏。

• 在檔案總管中開啟「檢視」→「顯示」→「副檔名」，避免把名稱相似的檔案誤認為可執行檔。
• 在壓縮檔上按右鍵開啟「內容」；若有「解除封鎖」選項，確認來源可信後勾選，再完整解壓縮。
• 不要在壓縮檔預覽視窗中直接點兩下執行，請先將整個資料夾解壓縮到本機。

資料夾權限：確認能否寫入，勿長期以系統管理員身分執行

用戶端不只會讀取程式檔案，也可能寫入記錄檔、設定資料庫和產生的核心設定檔。若放在 C:\Program Files、唯讀共用資料夾或受控資料夾中，可能會出現介面剛顯示就退出的情況。請先確認錯誤訊息指出的具體拒絕存取路徑，不要直接開放整個資料夾的所有權限。

1. 完全結束用戶端，建立僅供目前使用者測試的本機資料夾，例如 C:\Users\Public\Downloads\v2rayN-test。這個公用資料夾只適合暫時排查，不適合長期存放訂閱或認證資料。
2. 將可信任的發行套件完整解壓縮到測試資料夾，第一次啟動時先不要複製舊設定，並以一般使用者身分執行。
3. 在程式實際寫入的資料夾中，嘗試建立並刪除一個文字檔。若操作失敗，請檢查右鍵「內容」→「安全性」中的目前帳戶權限，以及安全性中心的受控資料夾紀錄。
4. 若程式能在暫存資料夾中啟動，請將它移至目前使用者可寫入的專用資料夾，再分批還原備份。若版本將資料存放於使用者設定檔位置，也要檢查該處的權限。

檔案總管中的資料夾「唯讀」核取方塊，無法單獨證明資料夾不能寫入。真正有用的依據是建立檔案測試、存取控制清單，以及錯誤訊息中顯示的目標檔案路徑。若新資料夾可用、原資料夾不可用，應優先處理環境差異，不必立刻更換節點或重建訂閱。

視窗仍開著但連線失敗：檢查核心、連接埠與設定

主介面正常時，先前往「設定」→「參數設定」核對本機監聽設定，並查看目前版本提供的記錄檔區域。不同版本可能將核心與連接埠選項放在不同分頁，請以介面實際顯示的欄位為準。不要將用戶端設定項目直接當成 Xray JSON 欄位複製到設定檔。

若記錄檔出現 address already in use 或 Only one usage of each socket address，請檢查相同位址與連接埠是否已被使用。下列命令以 10808 為例；若實際連接埠不同，請改用參數設定中的數值。輸出中的程序識別碼可在工作管理員「詳細資料」中核對，請勿直接結束不明的系統程序。

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

• 核心不相容：檢查節點使用的協定與傳輸設定是否受目前核心支援。v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心，但不能因此推定兩者支援的設定完全相同。
• 節點欄位錯誤：VLESS、VMess 設定錯誤通常會反映在核心載入或連線記錄中。若切換到另一組已知可用的設定後恢復正常，請檢查原節點參數，而不是繼續修復桌面執行階段。
• 自訂路由錯誤：先還原為最精簡的可用規則，再檢查產生的設定檔中 routing.rules 與所引用的 outboundTag 是否相符。欄位說明請參閱路由設定參考。
• 只有 TUN 無法啟動：先關閉 TUN，測試一般代理，再檢查權限提示、虛擬網卡與相關核心記錄。TUN 並非所有核心共用的單一 JSON 開關。

保留問題證據：事件檢視器與乾淨資料夾比對

若點兩下後沒有任何提示，請按 Win + R，輸入 eventvwr.msc，前往「Windows 記錄」→「應用程式」。依剛才記錄的時間，尋找來源為 Application Error、.NET Runtime 等項目。事件識別碼只是線索，還需查看故障應用程式路徑、模組名稱與例外訊息。

新資料夾能正常開啟後，先關閉程式並備份這份可用狀態，再逐項還原訂閱、節點與自訂規則。每次只還原一類資料，並重新啟動測試。若故障在某次還原後重現，就能將問題範圍縮小到相應設定或資料庫，避免直接刪除所有訂閱。訂閱管理說明請參閱訂閱設定參考。

向維護者或裝置管理員回報時，請提供作業系統版本、用戶端版本類型、程序架構、執行階段清單、重現時間與例外堆疊。記錄檔中的訂閱 URL、存取權杖、UUID、密碼與伺服器位址應先遮蔽敏感資訊；保留錯誤類型、模組名稱與必要的路徑結構即可，不要上傳整個使用者資料資料夾。

常見問題：更新、舊設定與啟動權限