· 平台教學 · 約 8 分鐘

v2rayN Windows 版安裝與設定教學:WPF 版、Desktop 版差異及常見問題

依序完成 v2rayN 在 Windows 的解壓縮、首次啟動、匯入訂閱與設定系統代理,並比較 WPF 版和 Desktop 版,整理執行階段缺漏、連接埠衝突等常見問題。

本文重點

第一次在 Windows 設定 v2rayN,先依系統架構選擇套件並完整解壓縮,再匯入訂閱、選擇節點,最後開啟系統代理。遇到問題時,依序檢查「介面能否開啟 → 核心能否監聽 → 節點能否連線 → 應用程式是否經由代理」,避免混淆執行階段、連接埠衝突和訂閱問題。

WPF 版與 Desktop 版怎麼選

這裡的 WPF 和 Desktop 指的是兩種用戶端介面,不是兩種節點協定。WPF 採用 Windows 的 WPF 介面架構;本文所稱的 Desktop 版則採用跨平台介面架構。在相同版本下,節點能否使用,主要取決於實際呼叫的核心及其版本、節點參數與網路環境。不要只看套件名稱中的 Desktop,就認定它包含核心或執行環境。

WPF 版

推薦

傳統 Windows 介面。若已習慣 WPF 版,或正依照 WPF 版教學尋找系統匣和參數選單,可優先選這個版本。若使用依賴架構的套件時出現缺少執行階段的提示,請依提示確認 Windows Desktop Runtime 的版本與系統架構。

適合:只在 Windows 上使用,想延續傳統介面與操作習慣。

Desktop 版

採用跨平台介面,設定入口與視窗配置可能和 WPF 版略有不同。下載時仍須選擇 Windows 對應的套件;是否內含執行環境及所需核心,請以套件說明為準。

適合:偏好 Desktop 介面,或希望在不同桌面系統上使用相近的操作配置。

下載前,請到 Windows「設定」→「系統」→「關於」查看「系統類型」,再依下載頁標示選擇 x64 或 arm64。切換版本排除問題時,先結束舊程序,並將新套件解壓縮至獨立資料夾。請勿把兩個版本的檔案覆蓋在一起,也不要同時開啟兩個用戶端測試連線,否則可能搶用同一個本機連接埠。

解壓縮、匯入訂閱與開啟系統代理

以下以 v2rayN 7.x 常見的繁體中文介面為例。不同版本的選單名稱可能略有差異,例如更新選單可能將「透過代理」標示在括號中。操作時請確認更新的是目前分組還是所有分組,以及要直接連線抓取還是透過代理抓取。

  1. 完整解壓縮

    依系統架構選擇套件;若下載的是壓縮檔,請使用「全部解壓縮」將檔案展開至目前使用者可寫入的獨立資料夾。不要在壓縮檔預覽視窗中執行程式,也不要只將主程式拖到桌面。初次排除問題時,請保留同一資料夾中的所有檔案,暫時不要啟用開機啟動。

  2. 啟動主程式

    從解壓縮資料夾開啟 v2rayN.exe,確認主視窗能正常顯示。關閉視窗後,如果工作列通知區仍有圖示,請先從系統匣重新開啟原視窗。介面顯示只代表用戶端已啟動;是否具備執行節點所需的核心,請選擇節點後再查看記錄。

  3. 新增訂閱分組

    開啟「訂閱分組」→「訂閱分組設定」,新增項目並填入備註和完整訂閱網址,再儲存設定。若只有單一 vmess:// 或 vless:// 連結,請複製連結,再使用主畫面的「從剪貼簿匯入」功能;單一連結不需要填入訂閱網址欄位。

  4. 更新訂閱並選擇節點

    切換至新建的分組,再從「訂閱分組」選擇「更新目前訂閱(不透過代理)」,避免首次抓取時依賴尚未設定的代理。清單出現項目後,按右鍵選擇一個節點,再執行「設為作用中伺服器」。確認作用中項目已切換,再查看記錄是否出現核心啟動或監聽錯誤。

  5. 開啟系統代理

    在系統匣圖示上按右鍵,從「系統代理」相關選項中選擇「自動設定系統代理」。前往 Windows「設定」→「網路和網際網路」→「Proxy」查看目前設定,再用會採用系統代理的瀏覽器開啟平常可穩定瀏覽的網頁。初次測試時先不要啟用 TUN,避免混淆兩種連線方式的設定。

本機連接埠與 Windows 系統代理設定對照

系統代理中填寫的是這台電腦上的代理入口,不是節點伺服器的位址或連接埠。在採用混合入站的 7.x 版本中,常見的預設監聽連接埠為 10808。既有設定、其他版本或不同的入站設定都可能改變這個值。請先以「設定」→「參數設定」中的本機監聽設定及啟動記錄為準,再核對 Windows 代理與應用程式中的數值。

127.0.0.1
僅供本機存取的迴圈位址
10808
混合入站常見的範例連接埠
10818
發生衝突時可檢查的備用連接埠

v2rayN 本機入口

監聽位址
127.0.0.1(本機使用)
監聽連接埠
10808(範例,請以目前設定為準)
入口類型
混合入站可接受 HTTP 代理和 SOCKS 請求;獨立入站則須分別確認各自的連接埠。

僅在本機使用時,不需要開啟「允許來自區域網路的連線」。

Windows 代理設定

位址
127.0.0.1
連接埠
沿用目前支援 HTTP 代理的入口
適用範圍
會讀取 Windows 系統代理設定的應用程式

若應用程式另有設定代理,也要檢查其位址、連接埠和代理類型。

同一台電腦上,瀏覽器正常但某個應用程式沒有走代理,不代表節點故障。請先確認該應用程式是否沿用系統代理,或是否有獨立的 HTTP、SOCKS 設定。關閉 v2rayN 前,可先在系統匣選擇「清除系統代理」,再結束程式;若原本使用公司或學校設定的代理,結束程式後請依原設定還原,避免長期指向已停止監聽的連接埠。

使用 PowerShell 排查連接埠占用

如果記錄出現 address already in use 或類似的繫結失敗訊息,請先查明目前是哪個程序在監聽該連接埠。以下以 10808 為例;若已更改連接埠,請將指令中的數字換成實際值。第一個指令會顯示監聽位址和程序 ID,第二個指令只測試本機是否能建立 TCP 連線。

Get-NetTCPConnection -LocalPort 10808 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
  • 連接埠正在監聽,但無法確認所屬程序:在工作管理員的「詳細資料」頁面,使用 PID 對照 OwningProcess。核心可能是用戶端啟動的獨立程序,不要只因程序名稱不是 v2rayN.exe 就將它結束。請先退出舊用戶端,再確認對應的監聽是否消失。
  • 連接埠確實由其他軟體使用:請勿結束不明程序,先確認備用連接埠是否已有監聽,再從「設定」→「參數設定」修改本機代理連接埠。儲存並重新啟動核心後,再次選擇「自動設定系統代理」,確認 Windows 不再指向舊連接埠。
  • 沒有監聽:回到用戶端檢查作用中節點和核心記錄,先處理核心缺漏、設定載入失敗或繫結失敗。TcpTestSucceeded : True 只表示有程式接受該連接埠的連線,無法證明節點可連線或網頁流量已透過代理傳送。

初次設定常見問題

一開啟程式就提示要安裝 .NET,該裝哪個版本?

先查看彈出視窗要求的架構名稱、主要版本和系統架構。若 WPF 版提示缺少 Microsoft.WindowsDesktop.App,應安裝符合提示的 Windows Desktop Runtime,而不是只安裝基本的 .NET Runtime。安裝完成後,回到原本的解壓縮資料夾重試;若套件說明標示已內含執行環境,請先確認啟動的是該套件,而非指向舊資料夾的捷徑。

已新增訂閱分組,為什麼一個節點都沒有?

儲存分組只會記錄網址,不會自動更新訂閱。請先切換至該分組,再執行「更新目前訂閱(不透過代理)」,查看記錄中的錯誤是逾時、HTTP 錯誤,還是內容解析失敗。只有在已有可用節點可供驗證時,才適合使用「透過代理」的更新選項進行比較;若收到的是登入頁面或網址失效提示,請先向服務提供者確認訂閱網址和有效期限。

清單中有節點,開啟系統代理後為什麼網頁仍無法開啟?

先確認是否已執行「設為作用中伺服器」,再核對核心記錄、本機監聽及 Windows 代理連接埠。若本機入口正常,但記錄顯示遠端連線逾時,可在相同網路環境下換用已知可用的節點交叉測試;若出現憑證或時間相關錯誤,請先確認 Windows 的日期、時間與時區,再檢查節點設定。不要透過關閉憑證驗證來消除提示。

關閉視窗後,下次開啟為什麼仍提示連接埠被占用?

關閉視窗可能只是將程式縮到通知區。請先展開系統匣,找到原本的 v2rayN,選擇「清除系統代理」後再按「退出」結束程式。若退出後連接埠仍在監聽,請使用上方的 PID 方法確認所屬程序;尤其要檢查是否有另一份解壓縮在不同資料夾中的 v2rayN 隨 Windows 啟動。

下載v2rayN