v2rayN Windows 安裝教學:WPF 與 Desktop 版如何選擇

比較 v2rayN 兩種 Windows 版本,整理解壓執行、執行階段需求、系統代理與開機啟動設定,以及常見問題。

本文重點

Windows 使用者先依系統架構選擇套件,再決定使用 WPF 或 Desktop 介面。本文從首次解壓開始,說明如何處理執行階段提示、更新訂閱、搭配系統代理與路由,以及登入啟動後確認連線。建議先用一般系統代理完成驗證,再視需求啟用 TUN,避免同時變更多項設定而增加排查難度。

WPF 與 Desktop:先分辨介面,再看發行套件

WPF 是 Windows 專用的介面技術;v2rayN 的 Desktop 版本採用跨平台桌面介面技術。兩者主要差異在介面實作、操作細節與執行環境,並非使用不同的節點協定。伺服器能否使用,還取決於訂閱參數、實際使用的代理核心與網路狀況,不能只看視窗外觀判斷。

WPF:適合日常 Windows 使用

建議

若只在 Windows 上使用,且沒有特定的跨平台介面需求,可先選擇 WPF。啟動時若提示缺少 .NET 桌面執行階段,請依該版本的要求安裝,不必修改節點參數。

適合:以 Windows 為主力電腦,並習慣 WPF 操作方式的使用者。

Desktop:跨平台介面體驗

若希望在不同桌面系統上使用相近的介面,可選擇 Desktop。Windows 使用者仍須下載符合 Windows 系統架構的套件;Desktop 名稱不代表套件一定內含執行階段,也不表示代理速度較快。

適合:重視跨平台介面一致性,或想比較兩種介面操作方式的使用者。

發行方式也要另外確認。可攜式壓縮檔須完整解壓後才能執行;安裝程式則依照精靈指示選擇安裝位置。是否包含核心或執行環境,應以下載頁說明和套件內容為準,不能只根據 WPF 或 Desktop 名稱推斷。可以分別測試兩種介面,但不要同時啟動,以免爭用同一個本機監聽連接埠。

下載前確認系統架構與執行階段

在 Windows「設定」→「系統」→「系統資訊」查看「系統類型」。一般 Intel、AMD 電腦通常使用 x64 套件;Windows on Arm 裝置則優先選擇發行方提供的 ARM64 套件。不能只看處理器品牌判斷架構,檔名標示的架構也必須與執行階段架構相符。

WPF 啟動檢查

介面技術
Windows Presentation Foundation
架構選擇
依系統類型選擇 x64 或 ARM64
相依項目
使用架構相依部署的套件通常需要 .NET Desktop Runtime
相依版本
依啟動提示及發行說明指定的主要版本安裝

只安裝 .NET SDK 或其他主要版本的執行階段,不代表已符合目前程式所需的桌面執行環境。

Desktop 啟動檢查

介面技術
Avalonia 桌面介面
架構選擇
下載符合 Windows 系統架構的發行套件
相依項目
視套件是否採用自包含部署而定
缺少執行環境
依啟動提示安裝指定的 .NET 執行環境

自包含套件通常不需要另外安裝相應的 .NET 執行階段,但仍受系統版本與其他原生相依項目限制。

若出現「必須安裝或更新 .NET 才能執行此應用程式」的提示,先記下提示中的架構名稱、主要版本與系統架構。WPF 所需的 Windows Desktop 執行環境與基本 .NET Runtime 並不相同。不要連續安裝多個不相關的執行階段,也不要從不明來源下載單一 DLL 放進程式資料夾,這些做法可能掩蓋真正的相依性問題。

解壓執行與匯入訂閱:依序完成

以下以 Windows 可攜式壓縮檔為例。不同發行版本的選單文字可能略有差異,請以實際介面為準;操作順序相同:選定固定資料夾、啟動用戶端、儲存訂閱、更新清單,再選取伺服器。不要直接在壓縮軟體的預覽視窗中執行主程式,否則可能無法正確定位設定檔與核心檔案。

  1. 選擇發行套件

    前往用戶端下載頁,依 Windows、處理器架構與介面類型選擇下載項目。先看清楚發行套件說明,再決定使用可攜式套件或安裝程式。

  2. 完整解壓縮

    將所有檔案解壓縮至目前帳戶可寫入的固定資料夾,例如 D:\Tools\v2rayN。不要只複製 v2rayN.exe,也不要將長期使用的設定留在暫存解壓縮資料夾。

  3. 啟動主程式

    執行 v2rayN.exe。使用一般系統代理通常不需要系統管理員權限;若出現執行階段提示,先依上一節處理,再繼續設定。

  4. 儲存訂閱

    在主介面選擇「訂閱分組」→「訂閱分組設定」,新增分組、填寫備註與訂閱網址後儲存。訂閱網址屬於存取憑證,請勿放進公開截圖。

  5. 更新清單

    在「訂閱分組」中選擇「更新全部訂閱(不透過代理)」。首次使用且尚無可用代理時,先透過目前的網路取得訂閱;若訂閱來源另有存取條件,請依提供方說明處理。

  6. 設為使用中的伺服器

    選取匯入的伺服器,在右鍵選單中選擇「設為活動伺服器」以啟用。接著查看記錄,確認對應的核心已成功啟動,最後再設定系統代理,避免把匯入成功誤當成連線成功。

儲存訂閱網址與下載訂閱內容是兩個步驟。清單空白時,先確認是否執行更新、記錄是否顯示請求失敗,以及目前選取的分組是否正確。若訂閱回傳登入頁面、到期提示或錯誤文字,重複按更新也不會取得有效節點,應先處理訂閱來源的問題。

系統代理、路由與 TUN:首次設定只啟用一種入口

v2rayN 啟動核心後,會在本機提供代理監聽入口。Windows 系統代理只是將入口位址寫入系統設定,只有會讀取系統代理設定的程式才會使用。路由則是在流量進入核心後,決定連線要直連、代理或封鎖。這兩個層次不可混為一談。

首次驗證:優先使用系統代理,按需求啟用 TUN

一般系統代理
  • 在系統匣圖示上按右鍵,選擇「系統代理」→「自動設定系統代理」。
  • 先用會讀取系統代理設定的瀏覽器測試網頁連線。
  • 在主介面的路由選擇區確認目前的規則模式。
  • 結束用戶端前,先清除系統代理,避免系統繼續指向已停止的連接埠。
TUN 接管流量
  • 適用於不讀取系統代理,但需要透過虛擬網卡處理流量的程式。
  • 可能需要系統管理員權限,並會影響網卡、路由與 DNS 設定。
  • 依使用的核心與用戶端提示進行設定,不要照抄來路不明的參數。
  • 首次排查時先關閉 TUN,建立一般代理可正常使用的基準。

系統代理與 TUN 並非絕對不能同時啟用;首次測試先簡化流量入口,更容易分辨問題出在節點或流量接管。

檢查本機連接埠時,請在「設定」→「參數設定」中尋找監聽連接埠相關項目;新舊版本的欄位與預設值可能不同。以下以本機 HTTP 相容入口 127.0.0.1:10808 為例,數字僅供說明。若實際監聽連接埠不同,命令中的數值也必須一併修改;若該連接埠只接受 SOCKS,則不能直接套用 HTTP 代理命令。

10808
本文範例的本機代理連接埠,實際值請以設定為準
443
HTTPS 常用的目標連接埠,並非本機代理連接埠
curl.exe --proxy http://127.0.0.1:10808 --head --connect-timeout 10 https://example.com/

此命令適用於系統已提供 curl.exe,且範例連接埠支援 HTTP 代理的情況。收到 HTTP 回應,表示該次請求已取得回應,但不代表所有網站都能存取,也不是效能測試。若提示無法連線至本機連接埠,先檢查用戶端是否正在監聽;若連上本機代理後才逾時,再檢查使用中的伺服器、路由、DNS 與遠端連線。

開機啟動:確認登入後啟動與代理恢復

桌面用戶端所說的「開機啟動」,通常是使用者登入 Windows 後啟動介面程式,不代表尚未登入系統就會建立代理。請先手動執行並確認正常,再設定自動啟動;否則每次登入只會重複遇到相同錯誤。

用戶端啟動與系統代理恢復也要分開驗證。若瀏覽器仍可直連,可能只是系統代理尚未啟用;若所有會讀取系統代理的程式都無法連線,可能是 Windows 保留了代理位址,但用戶端核心尚未開始監聽。開啟 Windows「設定」→「網路和網際網路」→「Proxy」,確認「手動設定 Proxy」中的位址與連接埠,不要只憑系統匣圖示判斷。

常見問題與切換介面的排查順序

切換 WPF 與 Desktop 適合用來排查介面相容性問題,不應當成所有連線故障的通用解法。若視窗能開啟但節點逾時,優先查看記錄;若程式完全無法啟動,才先檢查架構、執行階段與檔案權限。依故障發生階段逐步檢查,比反覆覆寫檔案更有效。

現象優先檢查項目處理方式
雙擊後提示缺少架構執行環境類型、主要版本與系統架構依提示安裝相符的執行環境,不要修改訂閱參數。
視窗正常,但核心啟動失敗記錄中的檔案路徑、設定錯誤與連接埠占用情況確認檔案已完整解壓,並且只執行一個測試執行個體。
更新後仍沒有伺服器訂閱回應與分組篩選條件查看更新記錄,確認網址有效且選取了正確分組。
瀏覽器可用,其他程式無法連線程式是否會讀取系統代理設定依應用程式說明設定代理,有需要時再評估 TUN。
結束用戶端後網頁無法開啟Windows 是否仍保留手動代理設定清除失效的本機代理,確認直連是否恢復。
自動啟動後找不到設定啟動路徑、執行帳戶與資料目錄確認實際使用的資料位置,避免啟動到另一份程式。

升級或切換前,先保留可還原的備份

升級前先結束用戶端,備份實際使用的資料目錄與目前可用的設定。可攜式套件的資料通常會保存在程式目錄中,但不能據此認定所有發行形式都使用相同位置;請以目前用戶端的資料目錄功能、設定或發行說明為準。備份可能包含訂閱網址與伺服器憑證,請妥善保管。

  1. 將新發行套件解壓縮至獨立資料夾,避免直接覆寫正在執行的程式與核心。
  2. 優先使用用戶端提供的匯出、匯入功能進行移轉;若要手動移轉,先確認兩端的資料格式相容。
  3. 只啟動新的程式副本,確認訂閱、使用中的伺服器、路由與系統代理正常後,再重新設定啟動項目。
  4. 新版本寫入的資料不保證能由舊版本讀取。若要回復舊版,請還原升級前的備份,不要讓舊程式直接讀取已移轉的資料。

選擇並不複雜:只在 Windows 上使用,可先試試 WPF;需要跨平台介面體驗,則可試試 Desktop。不論選哪一種,都先完成架構比對、完整解壓、執行環境檢查,以及一般系統代理測試,再設定登入啟動、調整規則或啟用 TUN。更多基礎設定請參考入門指南;連線異常則可依使用手冊逐步排查。

用戶端下載選擇系統與架構