v2rayN Windows 安裝設定完整流程：桌面版與 WPF 版選擇及常見問題

v2rayN 是 Windows 上的圖形化用戶端，負責管理訂閱、節點、路由規則與系統代理，實際連線則由 Xray 或 v2fly 核心處理。安裝時最容易混淆的通常不是協定參數，而是安裝包執行環境、解壓縮目錄、代理模式和本機連接埠。只要依照「選擇安裝包、啟動、匯入、啟用、驗證」的順序操作，多數問題都能從記錄中找到原因。

如何選擇桌面版與 WPF 版

v2rayN 7.x 系列可能同時提供採用不同介面技術與執行環境組合的 Windows 安裝包。差異主要在圖形介面、系統執行環境需求和檔案大小，不會改變訂閱中的 VMess、VLESS、Trojan 等節點參數。相同節點使用同一版本的 Xray 核心時，連線能力通常取決於核心版本與伺服器設定，而不是介面類型。

判斷安裝包是否為自包含版，不能只看壓縮檔大小，還應查看檔名中的 SelfContained 標記和對應版本說明。若啟動時出現「需要安裝或更新 .NET」提示，表示目前安裝包依賴外部執行環境；安裝與系統架構相符的 x64 Desktop Runtime 後，再重新開啟 v2rayN。一般 x64 Windows 裝置不要混用 Arm64 執行環境。

解壓縮、首次啟動與設定目錄

v2rayN 通常以壓縮檔形式發佈。不要在壓縮軟體的預覽視窗中直接雙擊主程式，因為核心、語言檔案和設定元件可能尚未完整解壓縮。建議建立固定目錄，例如 D:\Apps\v2rayN\，完整解壓縮後再執行。目錄路徑盡量只使用一般字元，並確保目前 Windows 帳戶具有寫入權限。

1. 關閉舊版 v2rayN，並確認工作列通知區域沒有殘留程序。
2. 將壓縮檔完整解壓縮到獨立目錄，不要覆蓋仍在執行的舊目錄。
3. 首次執行主程式，觀察通知區域是否出現 v2rayN 圖示。
4. 開啟「設定」→「參數設定」，確認介面語言、開機啟動和本機監聽連接埠。
5. 開啟記錄視窗，確認核心尚未出現啟動失敗、設定解析失敗或連接埠占用訊息。

將程式放在桌面、下載目錄或系統保護目錄中，可能造成更新覆蓋、權限繼承和路徑變動。固定目錄更適合保留資料庫、訂閱和路由設定。若要從舊版遷移，不要先將所有舊檔案直接覆蓋到新版；較穩妥的做法是保留舊目錄，啟動新版後匯入訂閱，再逐項遷移自訂路由和參數。

首次啟動後看不到主視窗，不一定代表啟動失敗。v2rayN 可以最小化到工作列通知區域，雙擊圖示即可恢復視窗。若通知區域也沒有圖示，可在工作管理員中檢查主程式是否瞬間退出，再到 Windows 事件檢視器查看 .NET Runtime 或 Application Error 記錄。

建議安裝目錄：
D:\Apps\v2rayN\

常見本機監聽：
SOCKS  127.0.0.1:10808
HTTP   127.0.0.1:10809

實際連接埠以「設定」→「參數設定」中的本機監聽設定為準。

訂閱匯入、更新與節點選擇

訂閱網址用於批次取得節點設定。它不是單一 VMess 或 VLESS 連結，也不等於本機設定檔。匯入前應檢查網址是否完整，複製時不要帶入換行、中文引號或結尾空格。訂閱內容由伺服器提供，v2rayN 只負責讀取並轉換為本機伺服器清單。

常見操作路徑是「訂閱分組」→「訂閱分組設定」→「新增」，填寫別名和訂閱網址後儲存，再執行「訂閱分組」→「更新全部訂閱」。不同 7.x 小版本的選單文字可能略有調整，但核心步驟仍是先建立訂閱分組，再主動更新。若目前網路無法直接存取訂閱來源，可先連線到可用節點，再在訂閱設定中啟用透過代理更新。

節點匯入後不要只看延遲欄。延遲測試通常用於判斷目標是否能建立連線，不等於實際傳輸速度。可先選擇節點、執行實際延遲測試，再用瀏覽器存取目標服務。若清單中的所有節點同時失敗，優先檢查訂閱有效性、系統時間和核心記錄；若只有一個節點失敗，再核對該節點的網址、連接埠、UUID、傳輸層、TLS 與伺服器設定是否一致。

• VMess：重點核對使用者識別碼、伺服器連接埠、傳輸方式與 TLS 設定。
• VLESS：除了使用者識別碼外，還要核對 flow、SNI、Reality 公鑰及 short ID 等伺服器參數。
• WebSocket：路徑和 Host 必須與伺服器設定一致，多一個斜線也可能導致握手失敗。
• gRPC：服務名稱需要精確相符，不能用節點備註代替。

啟用系統代理並驗證流量路徑

選取節點並啟動核心，只代表本機代理連接埠已在監聽，不代表 Windows 應用程式一定會將流量交給它。瀏覽器和遵循系統代理的桌面程式通常還需要啟用系統代理；不讀取系統代理的程式則要個別填寫 SOCKS 或 HTTP 位址，或使用 v2rayN 提供的其他接管方式。

1. 在伺服器清單中選取一個節點，並設為作用中伺服器。
2. 右鍵按一下通知區域圖示，選擇「系統代理」→「自動設定系統代理」。
3. 確認執行狀態顯示核心已啟動，記錄中沒有連續重新啟動。
4. 在 Windows「設定」→「網路和 Internet」→「代理」中確認指令碼或代理狀態已變更。
5. 開啟新的瀏覽器視窗進行測試，避免舊連線重用造成誤判。

v2rayN 常見的預設基準連接埠是 SOCKS 10808，HTTP 連接埠通常為 10809，但使用者修改、連接埠遞增規則和版本設定都可能改變實際值。準確值應以「設定」→「參數設定」顯示的本機監聽設定和啟動記錄為準。手動設定其他軟體時，伺服器位址應填寫 127.0.0.1，不應填寫遠端節點位址。

系統代理模式適合瀏覽器和多數遵循 Windows 代理設定的軟體。全域或規則模式則決定進入 v2rayN 的請求從哪個出站發出，兩者不是同一層級的設定。排查時先使用明確的代理模式確認連線，再恢復依網域和 IP 判斷的路由規則，可以減少 GeoSite、GeoIP 或自訂規則造成的干擾。

常見故障：執行環境、連接埠與安全性原則

安裝完成卻無法使用，通常可歸納為四類：主程式未啟動、核心未啟動、本機連接埠無法監聽、應用程式流量未進入代理。不要同時修改訂閱、DNS、路由和系統代理；每次只變更一項，並保留修改前的記錄，才能判斷故障發生在哪一層。

連接埠衝突經常來自另一個 v2rayN、其他本機網路工具，或上次異常退出後殘留的核心程序。在工作管理員中結束程序前，應先根據 PID 確認程式身分。直接將連接埠從 10808 改為 10818 可以避開衝突，但瀏覽器擴充功能、下載工具和開發工具中儲存的代理位址也要同步修改。

安全性軟體處理核心檔案後，v2rayN 主介面仍可能正常開啟，但按一下節點時核心會立即退出。此時記錄中常見「找不到檔案」、「啟動程序失敗」或路徑存取遭拒。應先確認遭處理的具體檔案，再從完整安裝包復原相應版本，避免將不同版本的核心和資源檔案混入同一目錄。

• 主介面錯誤：優先檢查 .NET Desktop Runtime、系統架構和目錄權限。
• 核心錯誤：優先檢查設定語法、核心檔案、連接埠占用和版本相容性。
• 訂閱錯誤：優先檢查網址完整性、網路可達性、系統時間和透過代理更新選項。
• 網頁錯誤：優先檢查系統代理狀態、瀏覽器代理設定、DNS 與路由命中結果。

升級遷移與最終檢查

從舊版本升級時，最穩妥的方式是讓新舊目錄並存。先退出舊版，將其目錄完整備份；再把新版解壓縮到新目錄並獨立啟動。確認訂閱、節點、路由和系統代理運作正常後，再決定是否遷移舊設定。即使新版讀取舊欄位失敗，也能立即回到原目錄重現問題並比對。

自訂路由尤其需要單獨核對。舊設定中的網域規則、GeoSite 標籤、GeoIP 標籤或出站名稱，可能因資料檔案和核心版本變更而不相符。升級後至少測試一個應直連的網站、一個應走代理的網站和一個應封鎖的網域，並從記錄確認實際出站，不要只看頁面能否開啟。

1. 確認安裝包架構與 Windows 架構一致。
2. 確認框架相依版具備相應的 .NET Desktop Runtime。
3. 確認 v2rayN 已完整解壓縮到固定且可寫入的目錄。
4. 確認訂閱更新完成，目前節點參數完整。
5. 確認 Xray 或 v2fly 核心啟動後沒有反覆退出。
6. 確認本機 SOCKS、HTTP 連接埠處於監聽狀態。
7. 確認系統代理模式與目前使用情境一致。
8. 確認瀏覽器請求進入記錄並命中預期路由。
9. 確認退出前清除系統代理，或保留明確的開機啟動策略。

完成這些檢查後，v2rayN 的安裝狀態就不再只依賴「圖示是否變色」這項單一訊號，而是由程序、連接埠、代理設定、記錄和實際請求共同驗證。之後遇到訂閱或節點變更時，也能沿用同一套順序，快速區分本機故障與遠端設定問題。