· 平台教學 · 約 12 分鐘

v2rayN Windows 安裝教學：WPF 版與 Desktop 版比較及常見問題

比較 v2rayN 兩種 Windows 版本，說明解壓縮、執行階段需求、匯入訂閱及設定系統代理，並整理常見錯誤的排除方法。

本文重點

首次安裝前，先確認 Windows 架構，再選擇 Desktop 或 WPF 版本。完整解壓縮並處理執行階段提示後，匯入訂閱、選擇伺服器、開啟系統代理，最後確認連線是否正常。本文適合初次使用者，以及升級後無法啟動的情況；將介面、核心、本機監聽與系統代理分開檢查，避免混淆不同問題。

先選版本：WPF 與 Desktop 有何不同

WPF 是 Windows 的介面技術，v2rayN WPF 版保留經典桌面操作方式；Desktop 版則採用跨平台介面。兩者主要差異在介面與發行形式，並非使用不同的代理協定，也不能因此判斷哪一版速度較快。同一台伺服器的實際連線表現，還會受到核心、路由、傳輸參數與網路環境影響。

Desktop 版

建議選擇

初次使用 v2rayN，且想採用跨平台介面時，可優先考慮此版本。下載前仍須確認該版本支援的 Windows 版本、處理器架構及相依需求，不要只看 Desktop 名稱就認定相容。

適合：初次安裝，或想沿用跨平台介面操作習慣的使用者。

WPF 版

保留經典 Windows 介面，適合已有操作習慣的使用者。採用 WPF 不代表支援所有舊版系統；新版所需的執行階段與系統條件，仍須以該版本的發行說明為準。

適合：熟悉經典介面，且已有固定 Windows 使用流程的使用者。

開啟 Windows「設定」→「系統」→「系統資訊」，查看「系統類型」。x64 系統通常選擇 x64 版本；ARM64 裝置則優先選擇相應的原生版本。系統顯示為 64 位元，不代表處理器一定是 x64；也不要混用不同架構的執行階段與用戶端。

下載與解壓縮：先準備可寫入的程式資料夾

前往用戶端下載頁面，選擇 Windows 對應版本。發行檔可能是安裝程式或壓縮檔，請依檔案類型處理：安裝程式依照精靈完成安裝；壓縮檔則先完整解壓縮，再啟動資料夾內的主程式。不要直接在壓縮軟體的預覽視窗中雙擊執行。

  1. 確認架構

    前往 Windows「設定」→「系統」→「系統資訊」，確認是 x64 或 ARM64，再核對下載頁面的介面類型與架構。不要憑圖示或檔案大小判斷。

  2. 完整解壓縮

    在壓縮檔上按右鍵，選擇「全部解壓縮」，例如解壓縮至目前使用者可寫入的 D:\Tools\v2rayN。保留壓縮檔內的所有子資料夾，不要只複製 v2rayN.exe。

  3. 首次啟動

    開啟主程式。若系統提示需要執行階段，先記下提示中的架構名稱、主版本與處理器架構，然後關閉程式並安裝相符的相依元件，再重新啟動。

  4. 檢查核心

    前往「設定」→「參數設定」，查看目前版本提供的核心相關設定；啟動連線後再檢查記錄。若顯示找不到核心程式，請確認發行檔中的資料夾是否完整，並檢查安全軟體的隔離記錄。

  5. 保留工作資料夾

    確認設定可以正常儲存後，再建立捷徑。升級前先關閉舊版程式並備份設定，建議在新資料夾中測試新版；不要混放多個版本的程式與核心檔案。

需要寫入設定的可攜式程式資料夾，盡量不要放在受保護的系統資料夾。一般系統代理通常不需要系統管理員權限；遇到問題就長期以系統管理員身分執行，既無法補齊缺少的檔案，也可能掩蓋資料夾權限問題。使用 TUN 等功能時，再依程式提示處理所需權限。

執行階段相依需求：依錯誤提示安裝，別盲目裝版本

「已安裝 .NET」不代表相依元件已齊全。架構相依型發行版本會檢查特定系列的執行階段；自包含發行版本通常會隨附所需執行階段，但仍可能受作業系統及原生元件限制。是否為自包含版本應查看發行說明，不能只看副檔名判斷。

提示或狀況優先確認項目處理方式
提示安裝或更新 .NET提示中的架構名稱、主版本與處理器架構從 Microsoft 官方管道取得相符的執行階段；一般執行程式不需要 SDK。
缺少 Microsoft.WindowsDesktop.App是否只安裝了一般 .NET Runtime依提示安裝對應的 Windows Desktop Runtime，並確認是 x64 或 ARM64。
提示缺少某個 DLL解壓縮是否完整、隔離記錄及檔案名稱重新取得完整發行檔並釐清相依需求；不要從不明下載站單獨拼湊 DLL。
視窗一閃即逝是否有舊程序殘留、系統相容性及啟動記錄先在新資料夾測試完整發行檔，再依記錄或 Windows 事件記錄找出原因。
介面已開啟，但核心啟動失敗核心檔案路徑、監聽連接埠及設定產生結果針對核心層錯誤進行排查；介面能開啟，不代表代理連線已建立。

不同 .NET 主版本可以並存，但安裝較新的主版本，不保證能自動符合舊主版本的需求。尤其是 WPF 需要桌面執行階段時，請區分 Windows Desktop Runtime 與一般 .NET Runtime。不要照過時教學固定安裝某一代執行階段，應依啟動提示逐項確認。

首次匯入訂閱：先更新清單，再設定目前使用的伺服器

主程式正常開啟後，再設定訂閱。訂閱網址用來取得並更新一組伺服器設定；vmess://、vless:// 等分享連結通常代表單一節點。把單一節點連結貼到訂閱網址欄位，不等於從剪貼簿匯入。

  1. 新增群組：開啟「訂閱群組」→「訂閱群組設定」，新增群組並輸入容易辨識的名稱，在網址欄位貼上完整訂閱網址後儲存。
  2. 取得節點：返回主畫面，開啟「訂閱群組」選單，執行對應的更新訂閱操作。不同版本可能分別提供更新目前群組、更新全部群組，以及透過代理更新等選項，請以實際選單項目為準。
  3. 確認結果：檢查群組內是否出現節點，並查看記錄是否有網路錯誤、驗證失敗或格式不支援等訊息。群組名稱有顯示，不代表訂閱內容已成功下載。
  4. 選擇伺服器：在清單中對目標節點按右鍵，選擇「設為目前伺服器」；確認目前狀態與選取的節點一致後，再測試實際連線。

初次安裝時若還沒有可用代理，不要一味選擇「透過代理更新」。若無法直接連上訂閱網址，請先確認網址有效且網路可連線，再透過已有的可用連線更新。反之，若目前代理運作正常，也不必為了遵循特定教學而強制改用直連。

訂閱更新成功但連線失敗時，請確認服務是否到期、裝置時間是否正確，以及節點參數是否完整。VMess、VLESS 是協定名稱，訂閱則是設定分發方式；匯入訂閱不會自動修正伺服器端與用戶端之間不相符的參數。

系統代理與本機連接埠：將流量交給正在執行的核心

先確認核心已啟動，再從 v2rayN 的「系統代理」選單選擇「自動設定系統代理」。可前往 Windows「設定」→「網路和網際網路」→「Proxy」確認系統代理狀態。系統代理只會影響遵循此設定的應用程式，不代表所有程序都已接管。

127.0.0.1
本機迴送位址，不是遠端節點位址
10808
以下連接埠僅為示範，請以實際監聽設定為準
2 層
分別檢查系統代理入口與用戶端路由

以下兩張卡片是排查用的設定範例，並非所有版本的預設值。前往「設定」→「參數設定」查看實際監聽連接埠與入站類型；確認該連接埠支援 HTTP 或混合代理後，才能使用後續的 HTTP 測試命令。不要照抄舊教學，將其他版本的連接埠當成目前設定。

用戶端監聽範例

監聽位址
127.0.0.1
本機連接埠
10808
入站類型
HTTP 或混合入站
區域網路存取
未啟用

只供本機使用時，請保留迴送位址監聽，避免不慎對區域網路開放代理。

系統代理檢查項目

代理位址
127.0.0.1
代理連接埠
與實際 HTTP 入站設定一致
核心狀態
已成功啟動
伺服器狀態
已設為目前伺服器

系統代理只是流量入口；流量進入後要走代理、直連或封鎖，則由路由規則決定。

若本機連接埠已被占用，核心可能無法啟動，但 Windows 仍保留原本的代理位址。此時瀏覽器會將要求送往未正常監聽的連接埠，看起來就像整個網路都中斷。變更連接埠後，請同步更新系統代理，並檢查應用程式內手動設定的代理是否仍指向舊連接埠。

連線測試：依序排查監聽、代理與路由

先檢查本機連接埠，再測試透過代理送出的要求，最後確認實際使用的應用程式。以下命令請在 PowerShell 中執行，並假設已確認 HTTP 代理監聽於 127.0.0.1:10808；若實際設定不同，請先替換連接埠。測試網址僅供示範，單一網站的結果不代表所有網站都能連線。

Get-NetTCPConnection -LocalPort 10808 -State Listen
Test-NetConnection 127.0.0.1 -Port 10808
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://www.microsoft.com/

curl.exe 傳回 HTTP 狀態碼，代表要求至少已抵達某個 HTTP 回應端；即使回傳拒絕存取等狀態，也不代表本機代理沒有啟動。另外，若路由將測試網域設為直連，即使明確指定本機代理，要求仍可能由核心直接連線。要確認節點是否實際承載流量，請一併檢查路由規則與連線記錄。

測試方式：先確認系統代理，再視需求評估 TUN

日常使用瀏覽器
  • 先開啟自動設定系統代理。
  • 確認瀏覽器是否沿用系統代理。
  • 搭配節點記錄確認路由與連線結果。
不遵循系統代理的應用程式
  • 先確認應用程式是否支援個別設定代理。
  • 有更廣泛的流量接管需求時，再評估 TUN。
  • 啟用前檢查權限、DNS 及其他 VPN 是否衝突。

一次只調整一層設定；系統代理測試通過後，再處理較複雜的流量接管與分流需求。

升級與退出：避免代理殘留、檔案混用及設定遺失

升級前記下介面類型、實際監聽連接埠、路由選擇及設定儲存位置，並在關閉程式後備份設定。可攜式版本與安裝版的設定位置可能不同，不要假設設定一定儲存在主程式旁。訂閱網址通常含有存取憑據，備份檔應存放於受控資料夾，不要在故障截圖中公開。

常見問題建議處理方式應避免的做法
新版啟動後設定異常保留舊資料夾與備份，在獨立資料夾中測試新版，再依支援方式遷移。直接覆蓋，混用兩種介面的所有檔案。
提示位址已被使用找出占用連接埠的程序，關閉重複執行的程式或調整監聽連接埠。連續啟動多個程式副本，搶占同一連接埠。
關閉程式後瀏覽器無法上網檢查 Windows 代理設定，移除指向已停止本機服務的代理。原因未明就重設整套網路設定。
更新訂閱後節點數量變少檢查群組篩選條件、更新記錄及訂閱端傳回的內容。立刻刪除所有本機設定，導致失去排查線索。
只有以系統管理員身分啟動才能儲存檢查設定資料夾權限，並將程式移至目前使用者可寫入的位置。長期以提高權限執行，代替修復權限問題。

正常結束程式前，可先在「系統代理」中選擇「清除系統代理」，再關閉用戶端。若程式異常結束，請開啟 Windows「設定」→「網路和網際網路」→「Proxy」，確認手動代理或指令碼是否仍指向已停止的本機服務。若公司或學校網路有既定代理政策，請先記錄原有設定，不要一律清除。

V2Ray 用戶端下載