v2rayN Windows 安裝教學:WPF 版與跨平台桌面版怎麼選?常見問題整理

整理 v2rayN 在 Windows 上兩種發行版本的差異與選擇方式,說明解壓位置、執行階段缺漏、防毒誤判及開機自動啟動等常見設定問題。

本文重點

只在 Windows 上使用、想沿用經典介面,優先選 WPF 版;若想在不同桌面系統間維持相近的操作方式,則選跨平台桌面版的 Windows 發行包。首次安裝或升級換版,都可用三項結果確認:主畫面能開啟、核心能監聽本機連接埠、重新登入後只啟動預期的版本。

WPF 版與跨平台桌面版怎麼選

WPF 版與跨平台桌面版的差異,主要在介面框架、發行包與執行相依項目,不在代理協定。VMess、VLESS 等設定能否使用,取決於所選核心、核心版本及設定內容。遇到協定錯誤時,先查看核心記錄,不要只憑介面版本判斷。

WPF 版

推薦

採用 Windows 專用的 WPF 介面。已習慣經典版配置的話,建議優先選擇符合系統架構的 WPF 發行包;是否需要另外安裝執行階段,請以該發行包的說明及實際啟動提示為準。

適合:只在 Windows 上使用,或從舊版經典介面轉換而來。

跨平台桌面版

在多種桌面系統上提供相近的介面配置,但下載時仍須選擇 Windows 專用的發行包。跨平台不代表同一個檔案能在所有系統執行,也不表示可以直接沿用舊版設定資料夾。

適合:經常在不同桌面系統間切換,或已熟悉新版介面配置。

前往 Windows「設定」→「系統」→「關於」,查看「系統類型」。若顯示 x64 型處理器且作業系統為 64 位元,請選 x64;ARM 裝置則先確認是否有相應的 ARM64 發行包。x64 和 ARM64 雖然都是 64 位元,卻不是同一種架構。

安裝與解壓縮:先選好程式資料夾

若下載項目是安裝程式,依照安裝畫面操作;若是壓縮檔,請使用檔案總管完整解壓縮。不要直接在壓縮檔預覽視窗中開啟主程式,也不要只把 v2rayN.exe 拖到桌面。主程式與核心啟動所需的檔案並不完全相同;若未完整解壓縮,可能會出現「介面能開啟,選了節點卻無法連線」的情況。

  1. 固定安裝位置

    在檔案總管的網址列輸入 %LOCALAPPDATA%,將可攜版完整解壓縮至底下的獨立程式資料夾,例如 %LOCALAPPDATA%\Programs\v2rayN-WPF。需要寫入設定的可攜版,請勿放在受保護的系統資料夾或同步資料夾;桌面只建立捷徑即可。

  2. 確認舊版程序已關閉

    如果電腦上已經有一份 v2rayN,先在舊版的系統匣選單中清除由它設定的系統代理,再結束舊版。關閉視窗可能只是將程式縮到系統匣;必要時開啟「工作管理員」→「詳細資料」,確認舊版 v2rayN.exe 已經結束。

  3. 啟動主程式

    在新資料夾中開啟 v2rayN.exe,或使用安裝程式建立的捷徑啟動。先確認介面能正常開啟,再匯入設定。若系統顯示執行階段錯誤,記下完整的框架名稱、版本與架構,再依照下一節處理。

  4. 確認本機連接埠

    在主畫面開啟「設定」→「參數設定」,查看本機監聽連接埠;部分版本會將此項目放在「Core: 基礎設定」。選擇一筆可用的既有設定後,先查看核心記錄是否有連接埠衝突,再確認實際監聽狀況。

雙擊後無法開啟:判斷是缺少執行階段還是遭安全軟體攔截

如果錯誤視窗提示必須安裝或更新 .NET,先查看 Framework、Version 和 Architecture 這三項。如果主程式能開啟,但啟用設定後才顯示找不到某個核心檔案,請優先確認是否已完整解壓縮、下載的發行包是否包含所需核心,以及該檔案是否遭到隔離。這兩種情況的處理方式不同。

缺少 .NET 執行階段

框架範例
Microsoft.WindowsDesktop.App 對應 .NET Desktop Runtime
版本範例
錯誤提示為 8.0.0 時,請安裝相容的 8.0 維護版本,不要假設較新的主版本可以取代
架構判斷依據
依錯誤視窗中的 Architecture 項目選擇,例如 x64;不要只看作業系統的位元數

請從 Microsoft 官方管道下載相應的執行階段。安裝後重新開啟程式;若錯誤仍然出現,重新查看提示,確認缺少的是哪個框架。

下載後出現威脅警示

查看位置
「Windows 安全性」→「病毒與威脅防護」→「保護歷程記錄」
確認項目
展開記錄,查看偵測名稱、受影響的檔案路徑及處理狀態
處理順序
先維持隔離狀態,確認下載來源及對應的發行包;若來源不明或警示持續出現,請停止使用該檔案

若懷疑是誤判,可向安全軟體供應商提交檔案供判定;不要關閉即時保護,也不要將整個程式資料夾加入排除清單。

若提示的是 Microsoft.NETCore.App,代表需要 .NET Runtime;若提示的是 Microsoft.WindowsDesktop.App,只安裝相同版本的基本 .NET Runtime 並不足夠。若沒有錯誤視窗,也找不到隔離記錄,可開啟「事件檢視器」→「Windows 記錄」→「應用程式」,依剛才的啟動時間尋找 .NET Runtime 或 Application Error 記錄。先記下例外模組與錯誤碼,再判斷該補上相依項目還是重新下載發行包。

介面能開啟但網頁無法連線:分層檢查連接埠

先確認核心是否已啟動,再確認應用程式是否將要求交給代理。以下以 127.0.0.1:10808 為例;實際連接埠請以目前版本的設定與記錄為準。若介面分別列出 HTTP 與 SOCKS 連接埠,手動設定應用程式時,協定與連接埠都必須相符,不能只挑一個連得上的數字。

127.0.0.1
本機迴路位址,用於本機測試
10808
本機監聽連接埠範例,測試前請確認設定
8.0
執行階段主版本範例,不代表所有發行包的需求
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
Get-NetTCPConnection -LocalPort 10808 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess
  • TcpTestSucceeded : False:此次 TCP 測試未能連上該位址與連接埠。請確認連接埠號碼,再查看核心記錄中的設定載入或監聽錯誤;暫時不必更換訂閱。
  • TcpTestSucceeded : True:該位址與連接埠可以建立本機 TCP 連線,但不代表遠端已連通。若懷疑連接埠被舊執行個體占用,可用 OwningProcess 的值前往「工作管理員」→「詳細資料」比對 PID,確認是哪個程序正在監聽。
  • 確認正在監聽的是預期的核心後,再查看系統匣選單中的「系統代理」設定。使用系統代理的瀏覽器,與另外設定獨立代理的應用程式,連線路徑不一定相同。若結束程式後,平常直接連線的網站也無法開啟,請檢查 Windows「設定」→「網路和網際網路」→「Proxy」是否仍指向已停止的本機連接埠;若代理設定由公司或學校管理,請先向管理員確認。

若本機連接埠與系統代理都正常,但只有特定網站無法連線,請前往無法連線診斷,依核心記錄與連線症狀繼續排查。

開機自動啟動、系統匣與升級常見問題

已設定開機自動啟動,為什麼重新開機後沒有視窗?

先到工作列的隱藏圖示區尋找 v2rayN,再到「工作管理員」→「詳細資料」查看程序。登入後若出現系統匣圖示但沒有主視窗,通常是以最小化方式啟動。若程序確實沒有執行,請在 v2rayN 的「設定」→「參數設定」中關閉再重新開啟「開機自動啟動」,儲存後登出並重新登入測試。這裡確認的是目前使用者登入後啟動,並非尚未登入時以系統服務執行。

換了資料夾,為什麼登入時還是啟動舊版?

先在舊版關閉開機自動啟動,再結束程式;接著在新版啟用此功能。若之前曾手動建立啟動捷徑,按下 Win + R,輸入 shell:startup,查看捷徑內容中的「目標」,只移除確認指向舊資料夾的項目。重新登入後,在工作管理員中按右鍵點選程序,再選擇「開啟檔案位置」,確認實際路徑。

每次更新都需要以系統管理員身分執行嗎?

日常啟動可攜版時,先使用一般使用者權限。若出現拒絕寫入的提示,先確認程式資料夾與設定資料夾是否可寫入,再將可攜版移至目前使用者的資料夾。若是執行階段或安裝程式本身要求提升權限,請依照來源可信的安裝程式提示操作;不要為了繞過資料夾權限,永久將主程式設為以系統管理員身分啟動。

升級後清單變空,是訂閱過期了嗎?

先確認目前啟動的是哪一份程式。新資料夾中的介面沒有內容,可能只是讀取了另一份設定。先結束新版,從舊版確認清單與訂閱群組是否還在;若有匯出或備份功能,優先使用該功能移轉,否則請從可信來源重新匯入。移轉後確認群組、目前選取的設定及本機連接埠,再清理舊資料夾。

下載用戶端