適合第一次在 Windows 上設定 v2rayN,或打算從傳統 WPF 介面改用桌面版的使用者。先選對系統架構與介面版本,再確認執行環境、匯入訂閱、啟用系統代理,最後處理 TUN 與啟動問題。初次設定建議只開啟系統代理,確認節點能連線至目標網站後,再逐步加入其他功能,避免訂閱、路由與虛擬網卡問題交錯難以排查。
一、如何選擇桌面版與 WPF 版
v2rayN 是用來管理節點、訂閱、路由與本機代理入口的用戶端,實際連線則由核心負責。桌面版採用跨平台介面,WPF 版則保留 Windows 傳統介面;不能簡單認為「一個支援 VLESS,另一個不支援」。協定支援能力還取決於所選核心及其版本,以及伺服器端參數是否相符。
選擇依據:介面習慣與系統環境
桌面版
- 初次使用,或想熟悉跨平台介面的使用者,可以優先選擇桌面版。
- 請依 Windows 版本與處理器架構選擇對應套件,不要使用其他作業系統的套件。
- 安裝方式與相依項目請以目前下載項目的說明為準。
WPF 版
- 適合已熟悉傳統清單、選單與系統匣操作的 Windows 使用者。
- WPF 是介面技術,不是代理協定,也不代表核心版本。
- 需要框架的套件通常須安裝相應的 .NET Desktop Runtime。
不要只因連線逾時就更換介面版本;請先確認目前核心能否啟動、節點參數是否正確,再考慮轉換版本。
在 Windows 11 開啟「設定」→「系統」→「系統資訊」,查看「系統類型」。常見的 Intel、AMD 電腦通常選擇 x64;ARM 裝置則不要把 x64 和 ARM64 當成相同的原生架構。若下載頁沒有適用版本,請先確認該發行版的系統支援說明,不要反覆執行不相容的程式。
二、安裝目錄與執行環境
前往下載頁選擇 Windows 安裝套件。不同發行版可能提供安裝程式或壓縮檔:安裝程式依照精靈完成安裝;壓縮檔則須先完整解壓縮,再執行資料夾中的 v2rayN.exe。不要在壓縮軟體的預覽視窗中直接雙擊主程式,這可能只會暫時解壓主程式,讓相依檔案與核心資料夾未能一併就緒。
-
選擇安裝目錄
可攜版可放在
D:\Tools\v2rayN這類目前使用者有寫入權限的目錄。避免使用暫存目錄或受控的系統目錄;應用程式之後還需要儲存設定、記錄檔與訂閱資料。 -
完整解壓縮
請保留壓縮檔原有的資料夾層級。若使用安裝程式,請完成安裝;不要把安裝程式所在的資料夾當成應用程式資料目錄。
-
確認相依項目
啟動時若提示安裝 .NET,請記下提示中的框架名稱、主版本與架構。WPF 套件應依提示補齊 Desktop Runtime;只安裝 SDK 或其他主版本的執行階段,未必能解決問題。
-
首次啟動
請先以一般使用者權限啟動。開啟「設定」→「參數設定」檢查基本設定,並查看主畫面的記錄,確認不是主程式已開啟、代理核心卻啟動失敗。
三、匯入訂閱與選擇節點
訂閱網址通常包含存取憑證,應視同密碼妥善保管。不要把完整網址貼到公開截圖中,也不要把「開啟後顯示一長串文字」誤認為網址錯誤:用戶端需要解析訂閱回傳的內容,而不是顯示一般網頁。只有出現登入頁、錯誤頁或過期提示時,才需要優先檢查訂閱本身。
-
新增群組
在主畫面開啟「訂閱群組」→「訂閱群組設定」,使用新增功能,填入易於辨識的名稱與訂閱網址後儲存。不同介面版本可能將新增功能顯示為「新增」或加號。
-
更新訂閱
回到「訂閱群組」選單,初次請先選擇「更新所有訂閱(不透過代理)」。如果介面提供獨立的「透過代理更新」選項,請先保持關閉,確認能否直接連線至訂閱網址。
-
查看更新結果
查看記錄中的更新結果,再切換至對應群組。若更新成功但清單空白,請清除搜尋欄與伺服器篩選條件,並確認目前選取的不是其他群組。
-
設為目前使用
在伺服器清單中選取節點,按右鍵選擇「設為活動伺服器」。等待核心載入設定後再測試連線;只在清單中點選一列,不一定代表已切換目前使用的節點。
若訂閱必須透過代理存取,請先準備一個可連線的節點,再使用「更新所有訂閱(透過代理)」。這個選項無法憑空建立第一條連線。匯入 VLESS、VMess 等節點後,建議保留訂閱提供的傳輸方式、TLS、SNI 與其他參數,不要為了「試試看」同時修改多個欄位。
四、系統代理與本機連接埠
將節點設為目前使用後,從系統匣選單開啟「系統代理」→「自動設定系統代理」。若目前版本將這些選項直接列在系統匣選單中,請選擇名稱相同的功能。系統代理只是告訴遵循 Windows 代理設定的應用程式,將連線交給本機代理連接埠;不代表所有程式都會自動透過代理連線。
上述連接埠僅供本文排查問題時參考,不是所有版本的固定預設值。開啟「設定」→「參數設定」,查看目前的本機監聽連接埠與監聽類型。較新的設定可能提供可同時接收 HTTP 與 SOCKS 請求的混合連接埠;部分舊設定則會區分兩種連接埠。請勿照搬舊教學,假設相鄰連接埠號一定是 HTTP 入口。
系統代理檢查項目
- 設定入口
- 系統代理 → 自動設定系統代理
- 代理位址
- 127.0.0.1
- 範例連接埠
- 10808,請以目前設定為準
- 檢查位置
- Windows 設定 → 網路和網際網路 → 代理
Windows 中的代理連接埠必須對應目前正在執行的 HTTP 或混合監聽入口。
命令列單次測試
- 測試工具
- Windows 內建的 curl.exe
- 代理類型
- HTTP 代理
- 代理入口
- http://127.0.0.1:10808
- 逾時上限
- 15 秒
明確指定代理,可排除應用程式是否讀取系統代理設定這項變因。
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 15 -I https://www.microsoft.com/
只有在該連接埠確實接受 HTTP 代理時,才能使用此命令。收到 HTTP 回應標頭,代表這次請求已透過指定入口完成通訊,不表示所有網站或路由都正常。若測試顯示「無法連線至代理」,請先檢查本機監聽狀態;若出現遠端交握錯誤,再檢查節點。路由請先選用自己熟悉的現有規則集,初次測試時不要同時修改 DNS 與自訂路由。
五、何時才需要啟用 TUN 模式
若瀏覽器透過系統代理可以正常使用,但不讀取系統代理設定的程式仍無法連線,再考慮使用 TUN 模式。TUN 會透過虛擬網路介面接管符合設定的流量,並涉及路由與 DNS;系統代理可以運作,不代表 TUN 所需的權限、驅動程式或網卡環境也已就緒。
- 先記錄基準狀態:記下可用節點、系統代理狀態與路由規則,為後續變更保留明確的復原依據。
- 再處理權限:使用主畫面的「TUN 模式」開關;若版本提示需要提高權限,請依提示重新啟動或授權,不必因此將一般代理使用也一律改為以系統管理員身分執行。
- 查看啟動記錄:確認 TUN 使用的核心已成功啟動,並留意權限不足、介面建立失敗與路由新增失敗等訊息,不要只看開關顏色。
- 排除網路衝突:其他隧道或虛擬網卡軟體可能影響路由;排查時一次只保留一種流量接管方式。企業設備請先遵守網路管理規範。
- 發生異常立即復原:關閉 TUN 後重新測試系統代理。若恢復正常,請優先檢查 TUN 的 DNS、路由與網卡設定,不要一開始就刪除所有訂閱。
是否同時保留系統代理,應依目前設定與使用情境決定,不要把「兩項都開啟」當成固定要求。初次排查時分別測試兩種入口,較容易找出問題:明確指定代理的請求成功、TUN 下卻無法連線,通常應繼續檢查流量接管路徑,而不是反覆更換同一個節點。
六、啟動、連接埠與網頁問題排解
建議依照「主程式 → 核心 → 本機連接埠 → 節點連線 → 應用程式設定」的順序排查。程式視窗能顯示,只能證明介面已啟動;延遲測試有結果,也不代表瀏覽器已使用代理。請先保留故障當下的一段記錄,再針對錯誤處理;這比同時重裝用戶端、修改連接埠和切換路由更容易找出原因。
雙擊後沒有視窗,是不是沒安裝好?
先查看工作列的系統匣與工作管理員,確認是否已有執行中的程式。如果沒有相關處理程序,請從解壓縮目錄重新啟動,並檢查執行階段提示與安全軟體記錄。若缺少框架,請依提示安裝相應架構與主版本,不要只重複解壓主程式。
記錄顯示連接埠被占用,該關閉哪個程式?
先用下方的命令找出監聽程序的 PID,再到工作管理員的「詳細資料」核對。常見原因是舊的程式執行個體尚未關閉。確認所屬程式後,正常結束該軟體,或將本機連接埠改為未使用的 10818,並重新設定系統代理;不要強制結束不熟悉的系統程序。
節點測試有延遲,網頁還是打不開?
先確認該節點已設為目前使用的伺服器,再檢查系統代理連接埠是否與實際監聽的連接埠一致。瀏覽器擴充功能或應用程式自己的代理選項可能會覆蓋 Windows 設定。可用明確指定代理的命令進行比對:若命令成功但瀏覽器失敗,請優先檢查瀏覽器的代理設定。
退出後一般網頁也打不開,該怎麼辦?
退出前,先從系統匣的「系統代理」選擇「清除系統代理」。若程式已異常關閉,請前往 Windows「設定」→「網路和網際網路」→「代理」,檢查是否仍有指向本機連接埠的手動代理設定;只撤銷這次操作所設定的代理。企業設備請勿擅自刪除組織設定。
netstat -ano -p tcp | findstr LISTENING | findstr ":10808 "
命令最後一欄是 PID;若沒有輸出,也請確認連接埠是否正確,以及核心是否確實啟動。若記錄顯示憑證過期、名稱不符或 TLS 交握失敗,請校正 Windows 時間,並核對訂閱中的 SNI、伺服器位址與傳輸設定;不要把「略過憑證驗證」當成通用解法。HTTP 代理協定與存取目標的 HTTPS 加密屬於不同層次,也不要因網頁使用 HTTPS 就隨意修改本機入口類型。
七、更新或轉換版本前要保留哪些資料
確認功能正常後,再考慮開機啟動、自動更新訂閱等便利設定。更新前請先關閉 v2rayN 與其核心,並備份實際資料目錄;資料位置可能因安裝方式而異,不能只憑主程式路徑推斷。從桌面版轉換至 WPF 版,或反向轉換時,建議重新匯入訂閱,再確認路由與連接埠;未確認設定相容性前,不要直接覆蓋整個資料夾。
- 訂閱資料:保留群組名稱與可信任的訂閱網址,請勿公開分享備份檔。
- 本機設定:記下監聽連接埠、系統代理模式、路由規則與是否使用 TUN。
- 手動設定:另外備份自建節點與自訂規則;重新匯入訂閱不會自動還原這些內容。
- 更新後重新測試:依序確認核心啟動、訂閱更新、單次代理請求,最後再檢查 TUN 與自動啟動。
完成上述檢查後,日常使用主要就是更新訂閱、選擇目前使用的節點,以及確認代理入口狀態。遇到問題時仍依照相同順序檢查,有助於區分安裝問題與網路問題,也方便還原至上一個可用設定。