v2rayN Windows 安裝與設定教學:WPF 版和 Desktop 版怎麼選

從選擇版本、解壓縮到首次啟動及匯入訂閱,完整說明 v2rayN Windows 安裝流程,並比較 WPF 與 Desktop 版,整理執行階段缺漏、防毒軟體攔截及路徑含中文等常見問題。

本文重點

先依 Windows 系統架構選擇安裝包,再決定使用 WPF 或 Desktop 版。初次設定時,分別確認三件事:能否取得節點、核心能否啟動,以及瀏覽器是否使用系統 Proxy。遇到問題就從失敗的步驟開始排查,不要同時更換介面、節點和路由設定。

WPF 版與 Desktop 版:先確認架構,再選介面

開啟 Windows「設定」→「系統」→「關於」,在「裝置規格」下查看「系統類型」。x64 系統請選 Windows x64 安裝包;ARM 系統優先選對應的 Windows ARM64 安裝包(若該版本有提供)。兩種系統都可能顯示為 64 位元,不能只看位元數判斷。WPF 和 Desktop 是介面版本,不是 Proxy 協定;同一份訂閱能否使用,取決於節點設定及實際啟動的核心。

Windows 的兩種介面版本

WPF 版
  • 採用 Windows 的 WPF 介面框架,適合習慣 Windows 版操作介面的使用者。
  • 若選用的安裝包需要外部執行階段,啟動時出現 Microsoft.WindowsDesktop.App,代表需要安裝 .NET Desktop Runtime。
Desktop 版
  • 採用 Avalonia 介面框架。即使在其他平台用過相同介面的版本,這裡仍須選擇 Windows 安裝包。
  • 選單配置可能與 WPF 版不同;是否內含執行階段和核心,請參閱該版本的發布說明,不能只憑 Desktop 字樣判斷。

若目前版本運作正常,無須為了匯入訂閱更換介面;首次安裝建議選擇符合系統架構、且依賴項目說明清楚的安裝包。

解壓縮、首次啟動與匯入訂閱

以下以 v2rayN 7.x 常見的 Windows 介面為例。不同小版本的選單位置可能略有差異;找不到工具列按鈕時,先查看同名選單,不要到 Windows 網路設定中新增訂閱網址。

  1. 完整解壓縮

    若下載的是 ZIP 檔,請在檔案總管中按右鍵,選擇「全部解壓縮」。將檔案解壓縮到目前帳戶可寫入的獨立資料夾,例如個人資料夾下的 Tools\v2rayN。不要直接從壓縮檔預覽中執行,也不要只拖出主程式;核心及其他隨附檔案必須保留原本的資料夾結構。

  2. 啟動主程式

    從解壓縮後的資料夾執行 v2rayN.exe。若沒有看到主視窗,先檢查通知區域中的隱藏圖示。首次匯入訂閱及測試一般系統 Proxy 時,不必先啟用 TUN,也不要把以系統管理員身分執行當成通用的啟動問題解法。

  3. 新增訂閱

    在主介面開啟「訂閱分組」→「訂閱分組設定」,按一下「新增」。輸入方便辨識的備註和完整訂閱網址,再儲存。訂閱網址通常包含存取憑證,複製時請保留查詢參數;截圖求助前,務必遮住整段網址。

  4. 取得節點

    在「訂閱分組」選單中執行「更新全部訂閱(不透過代理)」,再切換到剛建立的分組查看節點。儲存網址只會建立分組,並不會自動更新訂閱。若直接連線逾時,且已有確認可用的 Proxy,再試試相應的「透過代理」更新選項。

  5. 選擇節點

    在節點清單中按右鍵點選節點,選擇「設為活動伺服器」。確認主介面顯示的是剛選取的節點,並查看記錄中是否出現核心啟動失敗或監聽失敗。節點出現在清單中,不代表已啟用或可正常使用。

確認本機連接埠與系統 Proxy

先確認核心正在本機監聽,再讓瀏覽器使用系統 Proxy。以下連接埠是排查時常見的參考值,並非所有 7.x 版本都固定使用。請以「設定」→「參數設定」中的本機監聽設定和啟動記錄為準。

10808
常見的本機 Proxy 連接埠,可能採用混合監聽
10809
部分分開監聽設定使用的 HTTP 連接埠

本機監聽設定

本機位址
127.0.0.1
監聽連接埠
以用戶端設定及啟動記錄為準
測試條件
核心已啟動,並確認該連接埠可接收 HTTP Proxy 請求

混合連接埠可接收 HTTP 和 SOCKS 請求;單獨的 SOCKS 連接埠不能當作 HTTP Proxy 填入。

確認系統 Proxy

用戶端操作路徑
通知區域圖示 →「系統代理」→「自動設定系統代理」
Windows 設定位置
「設定」→「網路和網際網路」→「Proxy」
測試應用程式
使用系統 Proxy 設定的瀏覽器

系統 Proxy 決定哪些遵循該設定的應用程式會將請求交給用戶端;路由規則則決定核心收到請求後使用哪個出口。

若要分開排查瀏覽器設定和本機 Proxy,可在 PowerShell 中明確指定 Proxy。以下範例僅適用於已確認 10808 可接收 HTTP Proxy 請求的情況;若監聽連接埠不同,請替換數字。

curl.exe --noproxy "" --proxy http://127.0.0.1:10808 --connect-timeout 5 --max-time 15 -I https://example.com/

啟動失敗、訂閱更新失敗與瀏覽器無法上網的排查方式

一啟動就提示安裝 .NET,該裝哪個版本?

依照對話框中的框架名稱、版本及架構選擇執行階段。例如對話框列出 Microsoft.WindowsDesktop.App、8.0 系列及 x64,就安裝相符的 .NET 8 Desktop Runtime x64,不要只安裝一般的 .NET Runtime。可用 dotnet --list-runtimes 協助確認;若系統同時安裝不同架構的執行階段,請先確認命令列出的架構符合主程式需求。

主程式明明存在,為什麼記錄顯示找不到核心?

先確認發布包是否包含所需核心,以及是否已完整解壓縮。接著開啟「Windows 安全性」→「病毒與威脅防護」→「保護歷程記錄」,查看是否有與啟動時間及檔案路徑相符的紀錄。不要為了啟動程式而關閉防護,或將整個資料夾加入排除清單。若來源或警示原因不明,請停止執行並重新取得可信任的發布包;公司或機關設備請交由管理員處理。

資料夾路徑含中文,啟動時顯示找不到檔案怎麼辦?

先結束通知區域中的用戶端,再使用同一個安裝包,完整解壓縮到目前使用者可寫入、路徑較短且不含中文的獨立資料夾。請確認完整路徑,而不只是最後一層資料夾名稱。先從新資料夾啟動進行比對,不要混合覆蓋兩個資料夾的檔案。路徑含中文本身不一定會造成問題;只有更換資料夾後相同步驟恢復正常,才需要進一步檢查路徑解析、資料夾長度或存取權限。

更新訂閱一直逾時,需要更換核心嗎?

先查看訂閱更新記錄。取得訂閱失敗和連線到節點失敗是兩回事。若更新逾時,先確認目前網路能否連上訂閱服務,以及選用的更新方式是否依賴尚未可用的 Proxy;若回應為 401 或 403,先檢查訂閱是否已失效或存取權限是否變更。若記錄顯示憑證異常,請確認 Windows 的日期、時間和時區,不要藉由停用憑證驗證來解決。

關閉用戶端後,為什麼瀏覽器也無法上網?

若 Windows 仍指向已停止監聽的本機 Proxy,瀏覽器就會持續連線到已不存在的入口。重新啟動用戶端,在通知區域的「系統代理」選單中選擇「清除系統代理」,再正常結束程式,並到 Windows「Proxy」頁面確認設定。若原本使用的是公司或機關 Proxy,請還原原有設定,而不是一律關閉所有 Proxy 選項。

下載用戶端