v2rayN Windows 安裝設定完整流程：桌面版與 WPF 版怎麼選、常見問題一次排除

安裝前先分清桌面版、WPF 版與封裝方式

下載清單中的「桌面版」與「WPF 版」，主要描述介面技術與互動方式，不等同於代理協定或核心。兩者都能管理 VMess、VLESS 等設定；是否支援特定協定能力，取決於所選核心與節點參數，而不是介面名稱。只在 Windows 上使用、偏好傳統選單與視窗操作時，可優先考慮 WPF 版；想使用新版桌面介面並維持後續操作體驗一致時，則可選擇桌面版。

還要將介面版本與執行環境封裝方式分開判斷。檔名若包含 SelfContained，通常表示執行環境會隨程式一併提供，壓縮檔較大，但適合未預先安裝相應 .NET 執行環境的電腦；精簡包體積較小，首次啟動前可能需要安裝相符的 .NET Desktop Runtime。版本頁面的具體命名可能調整，應以下載項目說明為準，不要只憑壓縮檔大小猜測。

處理器架構同樣不能選錯。大多數 Windows 10、Windows 11 桌上型電腦與筆電使用 x64 套件；採用 ARM64 處理器的裝置則選擇 arm64 套件。可開啟「設定」→「系統」→「系統資訊」，查看「系統類型」。顯示「x64 型處理器」時選 x64，顯示「ARM 型處理器」時選 arm64。

正確解壓縮與首次啟動流程

v2rayN 的程式目錄需要長期保留，不能將壓縮檔內的主程式直接拖出來單獨執行。主程式、核心檔案、設定目錄與相依檔案必須維持原有的相對位置。建議先建立類似 D:\Tools\v2rayN 的固定目錄，再將壓縮檔完整解壓縮其中。不要長期放在瀏覽器的暫存下載目錄，也不要直接從壓縮軟體的預覽視窗啟動。

目錄權限會直接影響設定儲存與核心更新。將程式放入 C:\Program Files 後，標準使用者帳戶可能無法寫入某些檔案；放在桌面深層目錄、同步目錄或含有特殊權限政策的位置，也可能出現更新後檔案遭佔用的情況。固定的英文短路徑較容易排查，例如 D:\Apps\v2rayN。路徑可以包含中文，但若出現啟動異常，應先改用英文路徑重新測試。

1. 確認架構

   開啟「設定」→「系統」→「系統資訊」，依系統類型選擇 x64 或 arm64 下載項目，不要混用不同架構的程式與核心。

2. 完整解壓縮

   將壓縮檔完整解壓縮至 D:\Apps\v2rayN 這類固定目錄，確認主程式、核心目錄與其他檔案都同時存在。

3. 啟動程式

   雙擊主程式並觀察工作列通知區域。主視窗關閉後，程式可能仍在背景執行，可從系統匣圖示重新開啟。

4. 選擇核心

   進入「設定」→「參數設定」→「Core 類型」，依設定類型選擇可用核心。VLESS 與 Reality 設定通常使用 Xray 核心處理。

5. 匯入設定

   透過剪貼簿匯入單一連結，或在訂閱群組中新增訂閱網址；更新完成後選取一個設定並設為活動伺服器。

6. 開啟代理

   從系統匣選單選擇設定系統代理，再使用瀏覽器造訪目標網站進行驗證。測試結束後，可從相同選單清除系統代理。

訂閱、活動設定與核心參數如何設定

程式能順利開啟，不代表代理已經可用。至少需要完成三件事：匯入有效設定、將其中一個設定設為活動伺服器，以及啟動與該設定相容的核心。訂閱只是批次傳遞節點參數的方式；更新成功僅表示用戶端讀取到內容，不能證明其中每個設定都能連線。

新增訂閱時，先進入訂閱群組管理入口，建立新群組並貼上完整網址，再執行更新所有訂閱。網址前後多出的空格、只複製一半的參數，以及已失效的存取憑證，都可能造成更新失敗。若取得的是單一 vmess:// 或 vless:// 連結，應使用從剪貼簿匯入，不要誤將單一連結填入訂閱網址欄位。

匯入後檢查位址、連接埠、傳輸方式、TLS、SNI、Host、路徑與 Flow。VLESS + Reality 常見的關鍵項目包括目標位址、連接埠、公鑰、Short ID、Server Name、指紋與 xtls-rprx-vision Flow；VMess + WebSocket + TLS 則要重點核對 Host、路徑與 TLS 開關。任何欄位遭截斷，都可能呈現核心能啟動但連線逾時。

• 更新訂閱後，確認清單中確實出現設定，而不是只有一個空白群組。
• 雙擊目標設定，或使用選單將其設為活動伺服器，觀察目前選取狀態是否變更。
• 變更核心類型後重新啟動核心，讓新設定真正載入。
• 同時保留多個相似設定時，使用備註區分傳輸方式與入口位置，不要只看延遲排序。
• 訂閱更新覆蓋手動變更時，應回到訂閱來源修正參數，避免每次更新後重複修改。

開啟系統代理後仍無法上網的排查順序

系統代理與核心程序是兩層設定。系統代理負責讓支援 Windows 代理設定的程式將流量送至本機連接埠，核心則負責接收這些流量並轉送至活動伺服器。只開啟系統代理但核心沒有監聽，會得到連線遭拒；核心已在執行但系統代理未開啟，則只有手動指定代理的應用程式會使用它。

本文以 SOCKS 127.0.0.1:10808、HTTP 127.0.0.1:10809 作為排查範例，不代表每個版本都採用相同的預設值。應在 v2rayN 的本機監聽設定中讀取實際連接埠，再檢查 Windows 代理頁面或應用程式代理參數是否一致。修改監聽連接埠後，舊的系統代理位址不會自動套用至所有手動設定的軟體。

先查看主介面日誌。若出現 address already in use，表示連接埠已被其他程序佔用；若出現設定欄位解析錯誤，應回頭核對節點參數；若核心正常啟動但遠端連線逾時，再檢查伺服器位址、連接埠、系統時間與網路環境。不要一開始就反覆重新安裝，日誌通常能將問題限定在本機監聽、設定解析或遠端連線其中一層。

netstat -ano | findstr :10808
tasklist /fi "PID eq 程序編號"
powershell -Command "Test-NetConnection 127.0.0.1 -Port 10808"

第一個指令用於確認 10808 是否處於 LISTENING 狀態並讀取 PID；第二個指令將 PID 對應至程序名稱；第三個指令檢查本機 TCP 連接埠是否能建立連線。若連接埠沒有監聽，先重新啟動核心並查看日誌。若監聽程序不是 v2rayN 使用的核心，可結束衝突程式，或進入參數設定修改本機連接埠，再同步更新系統代理。

高頻安裝問題：目錄、攔截、時間與舊設定

解壓縮不完整是首次啟動失敗的常見原因。有些使用者只複製主程式，遺漏核心與相依目錄；也有人直接在壓縮檔內雙擊執行，關閉壓縮工具後暫存檔案便失效。正確做法是重新建立空目錄，完整解壓縮後，再從新目錄啟動。排查期間不要同時保留多個背景執行個體，否則系統匣選單與主視窗可能對應到不同程序。

如果 Windows 對下載檔案顯示來源提示，可開啟壓縮檔或程式檔案的「內容」，查看是否有解除封鎖選項，確認檔案來源後再處理。安全軟體隔離核心檔案時，主介面可能仍能啟動，但點選連線後沒有本機連接埠。此時應查看隔離記錄與 v2rayN 日誌，確認實際被處理的檔案，再從可信任的下載來源重新取得完整套件。

系統時間錯誤會影響 TLS 與 Reality 連線。進入「設定」→「時間與語言」→「日期與時間」，開啟自動設定時間與自動設定時區，然後點選立即同步。時間相差數分鐘時，常見表現不是程式當機，而是節點握手失敗、連線提早關閉，或所有 TLS 設定同時逾時。

直接覆蓋舊版本更新，還可能留下不相容的設定。升級前先結束系統匣中的 v2rayN，保留設定備份，再將新版本完整解壓縮至獨立目錄測試。確認訂閱、核心與系統代理運作正常後，再移轉需要的資料。不要讓新舊主程式共用同一個正在寫入的設定目錄。

完成設定後的驗證清單

驗證不能只看系統匣圖示顏色或主介面狀態。應依「核心程序、本機連接埠、系統代理、目標存取」四個層次檢查。先確認日誌沒有持續報錯，再確認本機連接埠正在監聽，接著檢查 Windows 代理位址，最後使用瀏覽器實際造訪需要代理的網站。任何一層失敗，都應停在該層修復，不要同時修改多個參數。

還要測試清除系統代理後的行為。結束 v2rayN 前，先從系統匣選單清除系統代理，再檢查 Windows 代理頁面是否恢復。若程式異常結束後留下舊代理位址，瀏覽器會繼續嘗試連線已關閉的本機連接埠，導致所有網頁突然無法開啟。此時關閉 Windows 手動代理即可恢復直接連線。

1. 主介面已明確選取一個活動設定，備註與預期節點一致。
2. 核心日誌顯示設定載入完成，沒有連接埠佔用或欄位解析錯誤。
3. Test-NetConnection 127.0.0.1 -Port 10808 回傳本機連接埠可連線，或使用實際監聽連接埠測試。
4. Windows 系統代理中的位址與 v2rayN HTTP 監聽設定一致。
5. 瀏覽器在開啟代理時能造訪目標網站，清除代理後恢復原有的直接連線行為。
6. 重新啟動 v2rayN 後，訂閱群組、活動設定與核心選擇仍能正確讀取。