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

WPF 與 Desktop：先選介面，再看核心

v2rayN 是管理設定與控制代理的用戶端，不等於代理協定本身。WPF 版採用 Windows 的 WPF 介面框架，Desktop 版則使用跨平台桌面介面方案。兩者的版面配置、縮放效果及部分操作入口可能不同；能否成功連線，主要取決於使用的核心、節點參數、網路環境與伺服器狀態。

VLESS、VMess 是代理協定，Xray 是代理核心，WPF 與 Desktop 則是用戶端的介面版本。使用 VLESS 搭配 REALITY 的節點，需要核心提供相應支援；換成另一種介面並不會增加協定支援能力。匯入訂閱後，應先確認節點需求，再決定核心設定；不要只憑「WPF 速度比較快」或「Desktop 支援所有節點」這類說法下結論。

Windows 安裝檔：架構、相依元件與解壓目錄

下載 v2rayN 前，先開啟 Windows「設定」→「系統」→「系統資訊」，查看「系統類型」；部分 Windows 版本會將此頁面稱為「關於」。Intel、AMD 的常見 64 位元電腦通常選 x64。ARM 裝置應確認可用版本及其執行需求，不能只因系統是 64 位元就認定架構相同。本網站目前提供的 Windows 安裝檔，請以下載頁面的實際清單為準。

若 v2rayN 以壓縮檔提供，請先完整解壓至可寫入的目錄，例如 D:\Tools\v2rayN\，再執行目錄中的 v2rayN.exe。請勿直接從壓縮軟體的預覽視窗啟動，也不要只把主程式拖到桌面。設定檔、記錄檔及核心相關檔案都必須完整保留；如需桌面入口，請建立捷徑，不要移動主程式。

• 權限：一般系統代理通常不需要長期以系統管理員身分執行；TUN 若涉及虛擬網卡或服務，再依提示授權。
• 執行階段：錯誤訊息要求哪種架構，就確認並安裝哪一種。一般使用者排除問題時，不必先安裝 SDK。
• 目錄：避免將程式放在沒有寫入權限的位置，也不要讓兩個版本同時寫入同一份設定。
• 安全提醒：確認下載來源，並查看 Windows 安全性中的具體紀錄；不要直接關閉整體防護功能。

首次啟動：匯入訂閱並選擇節點

v2rayN 不會附帶可用的遠端節點。訂閱網址由服務提供者提供，通常含有可存取帳戶資源的權杖，應比照密碼妥善保管。以下採用常見的中文介面選單名稱；不同發行版本可能調整「訂閱分組設定」或更新指令的文字，請依功能對應操作，不要為了尋找完全相同的按鈕而修改無關參數。

1. 完整解壓

   關閉舊的程式執行個體，將壓縮檔解壓至獨立目錄，再執行 v2rayN.exe。若出現缺少架構的提示，請先安裝所需執行階段，再重新啟動。

2. 新增分組

   開啟「訂閱分組」→「訂閱分組設定」，新增分組，填入方便辨識的備註，並在訂閱網址欄位貼上完整連結後儲存。

3. 更新訂閱

   返回「訂閱分組」，執行「更新全部訂閱（不透過代理）」。首次設定尚未建立代理連線時，建議先直接連線更新；只有直連失敗且已有可用代理時，才嘗試透過代理更新。

4. 選擇節點

   在節點清單中選取一個節點，按右鍵執行「設為活動伺服器」。確認活動標記與所選節點相符，再查看記錄中是否有核心啟動錯誤。

5. 連接瀏覽器

   在主視窗或系統匣選單的「系統代理」中選擇「自動設定系統代理」，接著確認目前的路由預設。首次測試先使用瀏覽器即可，不必同時啟用 TUN。

v2rayN 也可透過「伺服器」→「從剪貼簿匯入批次 URL」，匯入服務提供者提供的節點分享連結。匯入單一節點與訂閱不同：訂閱可重新取得節點清單；單獨匯入的連結不會隨服務提供者的變更自動更新。匯入後請勿任意修改 VLESS 的 UUID、REALITY 公鑰、短識別碼或服務名稱；這些欄位必須與伺服器端設定相符。

系統代理與路由：先用最精簡設定驗證

v2rayN 的系統代理主要影響遵循 Windows 代理設定的應用程式。部分命令列程式、遊戲或使用自有網路堆疊的應用程式，不會自動遵循此設定。路由預設則會在流量進入核心後選擇出口：全域代理通常會讓進入代理入口的流量走代理；略過中國大陸規則通常會讓符合條件的本機目的地直連，實際行為仍取決於規則內容與順序。

請至「設定」→「參數設定」中的基本或入站設定頁面，確認 v2rayN 的本機監聽連接埠；欄位分組會因版本而異。以下以 127.0.0.1:10808 作為已確認支援 HTTP 與 SOCKS 的混合入站範例，並非所有版本通用的預設值。若目前設定使用分開的 HTTP 與 SOCKS 連接埠，請將命令中的連接埠改為相應設定。

# 在 PowerShell 中檢查範例連接埠是否正在監聽
Get-NetTCPConnection -State Listen -LocalPort 10808

# 透過支援 HTTP 的本機入站連線測試網站
curl.exe --proxy http://127.0.0.1:10808 --max-time 15 -I https://example.com

# 透過 SOCKS 入站測試，並由代理端解析網域名稱
curl.exe --proxy socks5h://127.0.0.1:10808 --max-time 15 -I https://example.com

若 v2rayN 能讓明確指定代理的命令取得 HTTP 回應，但瀏覽器仍無法連線，請檢查瀏覽器代理擴充功能、瀏覽器本身的設定或 Windows 代理狀態。若本機連接埠完全沒有監聽，應先處理核心啟動問題或連接埠衝突，不要反覆切換遠端節點。收到一次 HTTP 回應，只能證明該次請求成功，不能據此推斷所有網站和應用程式都已連上代理。

常見錯誤：依發生階段排查

排查 v2rayN 問題時，應從最早出現的錯誤開始。主視窗無法開啟，通常是執行環境問題；視窗正常但沒有監聽連接埠，則可能是核心或入站設定問題；連接埠正常但遠端交握失敗，才進一步檢查節點參數與網路。分階段排查，通常比同時重裝執行階段、切換核心及修改 DNS 更有效。

使用 VLESS 搭配 REALITY 時，若出現憑證或交握相關錯誤，請一併確認伺服器位址、連接埠、伺服器名稱、公鑰、短識別碼及裝置時間。使用 VMess 也應確保系統時間正確。若訂閱提供的參數已過期，請更新訂閱或聯絡服務提供者確認，不要靠關閉安全性檢查來掩蓋設定錯誤。

升級與切換版本：先備份，再測試

v2rayN 從 WPF 切換至 Desktop，或從舊版本升級時，建議先用新目錄測試。設定格式可能隨版本改變，不應假設所有版本都能雙向相容。先在舊版本記下訂閱分組、活動節點、入站連接埠及自訂路由，再依目前版本支援的備份或移轉方式處理。

• 先退出再備份：從系統匣結束舊的程式執行個體，確認代理狀態已還原，再備份設定目錄，避免複製到仍在寫入的檔案。
• 使用獨立目錄：讓新版保留完整的隨附檔案，不要將兩個版本的程式與核心混在一起覆寫。
• 先做基本測試：先匯入一份訂閱，完成節點選擇、連接埠檢查與瀏覽器連線，再恢復複雜的分流規則。
• 保留回復方式：新版確認正常前，保留舊目錄；但不要同時執行兩個使用相同監聽連接埠的程式執行個體。
• 提供去識別化資訊：回報錯誤時，請提供版本、介面類型、系統架構及錯誤前後的記錄；隱藏訂閱網址、UUID 與帳戶權杖。

v2rayN 安裝完成的標準不只是「主視窗出現」，還要確認活動節點正確、核心正常監聽、測試請求結果符合預期，且退出後系統代理狀態可還原。符合這些條件後，再逐項加入訂閱自動更新、自訂路由或 TUN；每次只調整一項，出現問題時更容易找出原因。