v2rayN Windows 安裝與設定教學：桌面版和 WPF 版怎麼選？常見問題一次整理

一、桌面版與 WPF 版：先選介面，再確認架構

v2rayN 是用來設定與管理的介面，實際連線則由它呼叫的代理核心負責。桌面版採用跨平台介面；經典 WPF 版則採用 Windows 介面技術。兩者主要差異在介面配置、操作方式與安裝包依賴項目，不能只看「桌面版」或「WPF」就判斷能否連上特定伺服器。

下載前，請開啟 Windows「設定」→「系統」→「關於」，查看「系統類型」。若顯示 x64 型處理器，請選擇 x64 安裝包；ARM64 裝置則優先選用對應架構的版本。介面程式能透過相容層啟動，不代表安裝包內的核心也一定相容，因此不能只憑主視窗是否出現來判斷。

• 介面版本：決定按鈕配置，不等於通訊協定類型。
• 處理器架構：主程式與核心都必須符合裝置架構，不能任意混用不同架構的檔案。
• 安裝包依賴項目：自包含版本通常已附帶所需執行階段；依賴外部執行階段的版本則須安裝相應元件，請以所選安裝包說明及啟動提示為準。

二、完整解壓縮並首次啟動

請將壓縮檔完整解壓縮至可寫入的資料夾，例如 D:\Tools\v2rayN。不要在壓縮軟體的預覽視窗中直接雙擊主程式，也不要只抽出單一執行檔。介面、核心與資料檔案都必須維持安裝包原有的資料夾結構。

1. 確認安裝包

   從本站下載頁選擇適用於 Windows 的架構與介面版本。記下所選版本；排除問題時，請勿將不同版本的檔案覆蓋到同一個資料夾。

2. 解壓縮所有檔案

   在檔案總管中對壓縮檔選擇「全部解壓縮」，將完整資料夾放在目前帳戶可寫入的位置，避免直接解壓縮到受保護的程式資料夾。

3. 啟動主程式

   進入解壓縮後的資料夾，執行 v2rayN.exe。先確認主視窗和系統匣圖示都已出現；此時尚未設定伺服器，還不能判斷連線是否正常。

4. 查看啟動記錄

   查看主介面的記錄或資訊區域。若出現缺少執行階段、找不到核心或拒絕存取等提示，請先排除這些問題，再匯入訂閱。

按下視窗的關閉按鈕後，程式可能仍在系統匣中執行。再次啟動前，請先檢查工作列通知區域，避免把「視窗已隱藏」誤認為「程式啟動失敗」。之後升級或替換檔案時，請透過系統匣選單結束程式，並確認相關核心處理程序也已關閉。

三、匯入訂閱：儲存網址後還要更新

訂閱網址用來取得一組設定，不是伺服器位址，也不是一般網頁連結。網址可能包含帳戶識別資訊或存取權杖，請妥善保管，如同保護密碼一樣。新增訂閱群組只代表網址已儲存；必須執行更新，伺服器清單才會顯示項目。

1. 新增群組

   開啟主介面的「訂閱群組」→「訂閱群組設定」，新增項目並填入方便辨識的名稱及訂閱網址，然後儲存。不同版本的新增入口可能標示為「新增」或加號。

2. 更新訂閱

   回到「訂閱群組」選單，選擇「更新所有訂閱（不透過代理）」。首次設定尚無可用連線時，請先嘗試直接取得訂閱，並查看記錄中的請求結果。

3. 確認設定

   確認伺服器清單中是否出現項目，並檢查類型、位址和連接埠是否合理。若目前套用了群組篩選，請切換至正確群組，避免將篩選後清單空白誤認為匯入失敗。

4. 設為作用中伺服器

   在伺服器清單中對目標項目按一下滑鼠右鍵，選擇「設為作用中伺服器」。只選取一列不一定代表已切換作用中設定，請以作用中標記及接下來產生的核心記錄為準。

若目前已有可用連線，而訂閱服務要求透過代理存取，可再嘗試選單中的「透過代理更新」選項。尚未有任何可用伺服器時，請勿反覆選擇此項目：更新請求本身也需要可正常運作的代理出口。

• 請求失敗：確認網址是否因換行而截斷、權杖是否過期，以及本機日期和時間是否正確。
• 取得成功但沒有項目：確認回應內容是否為登入頁面、錯誤頁面，或用戶端無法辨識的訂閱格式。
• 只有一個分享連結：複製完整連結，再選擇「伺服器」→「從剪貼簿匯入批次 URL」；這與儲存訂閱網址是不同的操作流程。

VMess、VLESS 等類型必須與伺服器端設定一致。連接埠、使用者識別資訊、傳輸方式、TLS、伺服器名稱等參數不能憑經驗自行補上。更新訂閱可能覆蓋手動修改的項目；若需暫時調整，請先複製成獨立設定，並保留原始群組以供比較。

四、系統代理與路由：分別處理流量入口與出口

選好作用中伺服器後，請在主介面底部或系統匣選單的「系統代理」中選擇「自動設定系統代理」。這會將 Windows 的代理入口指向本機監聽位址。路由模式則是在流量進入核心後，決定使用代理、直接連線或其他已設定的出口；兩者不是同一個開關。

初次排查時不必同時啟用 TUN、修改 DNS 或開放區域網路存取。先讓一個遵循系統代理設定的瀏覽器成功連線，再視需要擴大測試範圍。TUN 的接管方式不同，還涉及虛擬網路介面、權限與路由，不宜和基本安裝問題混在同一次測試中。

結束前建議先在用戶端選擇「清除系統代理」，再透過系統匣選單結束程式。若程式異常關閉後瀏覽器無法上網，請回到 Windows 代理設定，確認是否仍指向已停止監聽的本機連接埠；只移除本次測試所設的項目，不要覆寫公司或其他軟體管理的代理設定。

五、本機連接埠：先確認監聽狀態，再查占用程序

不同版本及既有設定的監聽連接埠可能不同。以下兩個數字僅供辨識常見設定，不代表所有版本都必須改成相同數值。開啟「設定」→「參數設定」，查看本機監聽連接埠與入站類型，並與核心啟動記錄核對。

若記錄出現 address already in use 或監聽綁定失敗，請先確認該連接埠是否已被另一個用戶端執行個體或其他程式占用。在 PowerShell 中執行以下唯讀查詢；若實際使用的連接埠不同，請修改查詢中的連接埠數字。

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

Get-Process -Id 1234

第二個指令中的 1234 是範例處理程序識別碼，請替換成上一個指令輸出的 OwningProcess。若沒有輸出，表示查詢當下未發現該 TCP 監聽；它可能尚未啟動，因此不能據此判定連接埠遭到占用。

• 占用者是舊執行個體：透過系統匣正常結束舊執行個體，再啟動要使用的版本。
• 占用者是其他程式：先確認該程式的用途，不要直接結束不熟悉的處理程序。也可以在 v2rayN 中改用閒置連接埠，例如 10818。
• 修改連接埠後：重新載入設定或重新啟動核心，再次設定系統代理；應用程式中手動填寫的代理連接埠也要一併更新。
• 僅供本機使用：建議維持迴路位址監聽，例如 127.0.0.1，不要為了排查本機問題而任意開放給區域網路。

六、執行階段缺漏與核心啟動失敗

雙擊後完全無法開啟，和視窗正常出現但無法連線，是兩種不同問題。前者先檢查介面程式的依賴項目，後者先查看核心記錄。重複匯入訂閱無法補上缺少的執行階段；安裝執行階段也無法修正伺服器端驗證參數錯誤。

不要照著其他版本的教學，直接安裝某個固定的大版本 .NET。框架依賴會隨發行版本變動，請以目前的啟動提示為準；若要檢查已安裝的元件，可在命令提示字元中執行 dotnet --list-runtimes。若無法執行此指令，也不能因此判定自包含安裝包無法啟動。

v2rayN、V2Fly 和 Xray 並非同一層級的軟體：前者負責管理設定，後兩者則是源自 Project V 生態系的核心專案。使用 VLESS 或特定的安全性、傳輸組合時，必須搭配支援該組合的核心。不要只為了消除錯誤訊息就在介面中反覆切換核心，請先確認伺服器端的要求。

七、連線測試：區分應用程式問題與連線問題

延遲測試有結果，只能表示該測試使用的請求收到回應，不代表瀏覽器所有連線路徑都正常。驗證時請維持相同的作用中伺服器與目標位址，每次只修改一項設定，才能確認是哪個步驟帶來變化。

1. 確認核心運作：啟動記錄沒有設定解析或連接埠綁定錯誤，且本機連接埠正在監聽。
2. 明確指定代理：透過命令列直接連線至本機 HTTP 或混合入站，排除應用程式是否讀取系統代理這項變數。
3. 測試瀏覽器：若命令執行成功但瀏覽器仍失敗，請檢查系統代理、擴充功能及瀏覽器個別的網路設定。
4. 恢復日常規則：若暫時切換至全域代理後測試成功，請恢復原本的路由設定，並確認是否為某條分流規則造成差異。

以下指令僅適用於本機 10808 提供 HTTP 或混合代理的情況；若只有 SOCKS 入站，就不能照填 HTTP 代理位址。--max-time 15 會將整個請求的最長等待時間限制為 15 秒，這不代表連線速度，也不保證服務可用。

curl.exe --proxy http://127.0.0.1:10808 --max-time 15 -I https://example.com/

若提示無法連線至本機連接埠，請回頭檢查監聽狀態；若成功連上本機後才出現遠端逾時，請檢查作用中伺服器、伺服器端狀態與路由記錄；若收到 HTTP 回應，即使狀態碼不是成功碼，也表示某個 HTTP 端點已回應，應依回應內容判斷，不能一概視為代理連線失敗。

完成後記下可用的作用中設定、監聽連接埠與路由模式，並備份必要設定。升級時保留一份可供還原的資料夾，先在新資料夾確認程式能啟動且連線正常，再替換日常使用的捷徑或入口。避免同時更換介面版本、核心和自訂規則，以免無法判斷問題來源。