只在 Windows 上使用、想沿用經典介面,優先選 WPF 版;若想在不同桌面系統間維持相近的操作方式,則選跨平台桌面版的 Windows 發行包。首次安裝或升級換版,都可用三項結果確認:主畫面能開啟、核心能監聽本機連接埠、重新登入後只啟動預期的版本。
WPF 版與跨平台桌面版怎麼選
WPF 版與跨平台桌面版的差異,主要在介面框架、發行包與執行相依項目,不在代理協定。VMess、VLESS 等設定能否使用,取決於所選核心、核心版本及設定內容。遇到協定錯誤時,先查看核心記錄,不要只憑介面版本判斷。
WPF 版
推薦採用 Windows 專用的 WPF 介面。已習慣經典版配置的話,建議優先選擇符合系統架構的 WPF 發行包;是否需要另外安裝執行階段,請以該發行包的說明及實際啟動提示為準。
適合:只在 Windows 上使用,或從舊版經典介面轉換而來。
跨平台桌面版
在多種桌面系統上提供相近的介面配置,但下載時仍須選擇 Windows 專用的發行包。跨平台不代表同一個檔案能在所有系統執行,也不表示可以直接沿用舊版設定資料夾。
適合:經常在不同桌面系統間切換,或已熟悉新版介面配置。
前往 Windows「設定」→「系統」→「關於」,查看「系統類型」。若顯示 x64 型處理器且作業系統為 64 位元,請選 x64;ARM 裝置則先確認是否有相應的 ARM64 發行包。x64 和 ARM64 雖然都是 64 位元,卻不是同一種架構。
安裝與解壓縮:先選好程式資料夾
若下載項目是安裝程式,依照安裝畫面操作;若是壓縮檔,請使用檔案總管完整解壓縮。不要直接在壓縮檔預覽視窗中開啟主程式,也不要只把 v2rayN.exe 拖到桌面。主程式與核心啟動所需的檔案並不完全相同;若未完整解壓縮,可能會出現「介面能開啟,選了節點卻無法連線」的情況。
固定安裝位置
在檔案總管的網址列輸入
%LOCALAPPDATA%,將可攜版完整解壓縮至底下的獨立程式資料夾,例如%LOCALAPPDATA%\Programs\v2rayN-WPF。需要寫入設定的可攜版,請勿放在受保護的系統資料夾或同步資料夾;桌面只建立捷徑即可。確認舊版程序已關閉
如果電腦上已經有一份 v2rayN,先在舊版的系統匣選單中清除由它設定的系統代理,再結束舊版。關閉視窗可能只是將程式縮到系統匣;必要時開啟「工作管理員」→「詳細資料」,確認舊版
v2rayN.exe已經結束。啟動主程式
在新資料夾中開啟
v2rayN.exe,或使用安裝程式建立的捷徑啟動。先確認介面能正常開啟,再匯入設定。若系統顯示執行階段錯誤,記下完整的框架名稱、版本與架構,再依照下一節處理。確認本機連接埠
在主畫面開啟「設定」→「參數設定」,查看本機監聽連接埠;部分版本會將此項目放在「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 連接埠,手動設定應用程式時,協定與連接埠都必須相符,不能只挑一個連得上的數字。
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,查看捷徑內容中的「目標」,只移除確認指向舊資料夾的項目。重新登入後,在工作管理員中按右鍵點選程序,再選擇「開啟檔案位置」,確認實際路徑。
每次更新都需要以系統管理員身分執行嗎?
日常啟動可攜版時,先使用一般使用者權限。若出現拒絕寫入的提示,先確認程式資料夾與設定資料夾是否可寫入,再將可攜版移至目前使用者的資料夾。若是執行階段或安裝程式本身要求提升權限,請依照來源可信的安裝程式提示操作;不要為了繞過資料夾權限,永久將主程式設為以系統管理員身分啟動。
升級後清單變空,是訂閱過期了嗎?
先確認目前啟動的是哪一份程式。新資料夾中的介面沒有內容,可能只是讀取了另一份設定。先結束新版,從舊版確認清單與訂閱群組是否還在;若有匯出或備份功能,優先使用該功能移轉,否則請從可信來源重新匯入。移轉後確認群組、目前選取的設定及本機連接埠,再清理舊資料夾。