Windows
v2rayN · 桌面版/經典 WPF 版
前往系統的「關於」頁面確認系統類型。下載頁上的兩個版本都適用於 x64:桌面版採用跨平台介面,經典 WPF 版則保留原有介面配置。初次安裝選一種即可,不必為了對照教學同時安裝兩套。
若下載的是壓縮檔,請先完整解壓縮至可寫入的資料夾,再執行程式;不要直接從壓縮檔視窗開啟主程式。若系統提示缺少執行環境,請依所選版本的說明安裝。舊版用戶端仍在執行時,請先結束程式,避免兩套程式搶用同一本機連接埠。
前往下載功能速查
匯入節點時,先確認協定,再檢查傳輸與握手設定。桌面版 v2rayN 和 Android 版 v2rayNG 都能透過相應核心處理常見的 VMess、VLESS 和 Trojan 設定,但協定名稱相同,不代表傳輸參數可以互換。複製既有節點時,請保留來源提供的傳輸方式與安全選項。若桌面版能連線、Android 版卻不行,先比對兩端解析出的欄位,再確認核心是否支援該組合;不要一次調整多個選項。
| 項目 | v2rayN 桌面版 | v2rayNG Android 版 |
|---|---|---|
| VMess | 支援 | 支援 |
| VLESS | 支援 | 支援 |
| Trojan | 支援 | 支援 |
訂閱網址是更新節點清單的入口,不是單一節點網址。在 v2rayN 的訂閱群組設定或 v2rayNG 的訂閱群組管理中新增網址並儲存,接著還要手動更新,節點才會出現在清單中。不同來源建議分開設為不同群組,更新失敗時較容易逐一檢查。更新後確認目前使用的節點仍在清單中;若原節點已移除,請從更新後的同一群組重新選擇。
| 項目 | v2rayN 桌面版 | v2rayNG Android 版 |
|---|---|---|
| 新增網址 | 訂閱群組設定 | 訂閱群組管理 |
| 更新訂閱 | 更新所有訂閱 | 更新訂閱 |
| 從剪貼簿匯入 | 支援 | 支援 |
路由規則決定已進入核心的流量要走代理、直連或封鎖,但無法讓未受接管的應用程式自動走代理。桌面版可在路由設定中查看規則,將特定目標的規則排在較廣泛的規則之前,再用已知目標進行測試。Android 版還能透過分應用程式代理,控制哪些應用程式使用本機 VPN;這與依網域指定出口是兩回事。排查分流錯誤時,先確認流量有進入用戶端,再確認符合哪一條規則。
| 項目 | v2rayN 桌面版 | v2rayNG Android 版 |
|---|---|---|
| 規則入口 | 路由設定 | 路由設定 |
| 網域規則 | 支援 | 支援 |
| Android 應用程式清單 | 不適用 | 分應用程式代理 |
桌面系統代理可供讀取系統設定的應用程式使用。若應用程式不讀取這項設定,或需要接管更多流量,再考慮透過 TUN 虛擬介面接管,並檢查權限、路由與 DNS。Android 版通常透過系統 VPN 授權啟動,操作方式與桌面版系統匣不同。切換模式前先記下原有設定,依序測試瀏覽器與目標應用程式,以便分辨是節點故障還是應用程式未受接管。
| 項目 | v2rayN 桌面版 | v2rayNG Android 版 |
|---|---|---|
| 桌面代理 | 自動設定系統代理 | 不適用 |
| 虛擬介面 | 啟用 TUN | VPN 模式 |
| 本機代理入口 | 支援 | 支援 |
用戶端負責管理設定,核心負責解析設定並建立連線。桌面版 v2rayN 可依支援的節點類型選擇核心;v2rayNG 使用 Xray 作為核心,沒有桌面版相同的核心選擇流程。切換前先記下原本使用的核心與節點參數,切換後查看啟動記錄及實際連線結果。若出現設定不受支援的提示,優先還原原本的組合;更換核心並不能解決所有連線逾時問題。
| 項目 | v2rayN 桌面版 | v2rayNG Android 版 |
|---|---|---|
| Xray | 支援 | 支援 |
| sing-box | 支援 | 未提供 |
| 選擇入口 | Core 類型 | 未提供 |
安裝檔選擇
先確認裝置的處理器架構,再依作業系統、發行版或介面類型選擇安裝檔。安裝檔只包含用戶端,節點或訂閱網址需另外準備。若已安裝用戶端,可先備份原有設定,再使用同一節點測試新安裝是否正常。
v2rayN · 桌面版/經典 WPF 版
前往系統的「關於」頁面確認系統類型。下載頁上的兩個版本都適用於 x64:桌面版採用跨平台介面,經典 WPF 版則保留原有介面配置。初次安裝選一種即可,不必為了對照教學同時安裝兩套。
若下載的是壓縮檔,請先完整解壓縮至可寫入的資料夾,再執行程式;不要直接從壓縮檔視窗開啟主程式。若系統提示缺少執行環境,請依所選版本的說明安裝。舊版用戶端仍在執行時,請先結束程式,避免兩套程式搶用同一本機連接埠。
前往下載v2rayN · Apple Silicon / Intel
開啟「關於這台 Mac」查看晶片或處理器資訊。Apple 晶片請選擇 arm64,Intel 處理器則選擇 x64。請勿只依購買年份判斷,同一時期上市的機型也可能採用不同架構。開啟磁碟映像檔後,依照其中的說明安裝。
安裝完成後,從「應用程式」啟動用戶端,不要一直從已掛載的磁碟映像檔執行。首次連線時,先確認瀏覽器是否如預期使用系統代理,再處理個別應用程式的代理設定。若出現系統權限提示,先確認該提示是要啟動應用程式,還是啟用網路功能。
前往下載v2rayNG · v2flyNG
常用選擇是採用 Xray 核心的 v2rayNG;若既有設定明確需要 V2Fly,再考慮 v2flyNG。多數近年的機型可選擇 arm64。若裝置規格未列出支援的應用程式架構,可先查看通用版安裝檔;請勿將桌面版安裝檔傳到手機。
安裝完成後,先匯入訂閱、更新清單並選取節點,再點選啟動,依系統提示建立本機 VPN 連線。若只有個別應用程式無法連線,請檢查分應用程式代理清單;若切換至背景一段時間後才中斷,則檢查系統是否限制用戶端在背景執行。
前往下載v2rayN · deb / rpm
先依發行版選擇套件格式,再依裝置選擇架構。Debian、Ubuntu 通常選 deb;Fedora、openSUSE 通常選 rpm。下載頁會分別列出 x64 和 arm64,安裝時請使用發行版的套件管理工具查看相依性提示。
首次執行時,先確認用戶端能啟動、核心能載入節點,再處理桌面環境的代理設定。即使圖形介面的系統代理已生效,終端機程式也不一定會讀取相同設定。先逐一測試應用程式,再決定是否啟用 TUN,避免混淆流量接管範圍與節點問題。
前往下載快速入門
開啟訂閱群組設定,新增群組並填寫容易辨識的備註,再貼上完整的訂閱網址。儲存只會記錄網址,通常不會立即產生節點。返回主畫面執行更新,再切換至新群組,確認清單中有可選的節點。若只有一條節點分享連結,請使用用戶端的剪貼簿匯入功能,不要將它當成訂閱網址填入。
若清單仍是空的,先確認更新的是剛新增的群組,再查看更新提示。網址多了空格、訂閱已過期,或用戶端讀取到的是登入頁而非節點資料,處理方式都不同。先讓清單成功更新,再進行下一步。
從群組中選擇一個節點,並設為目前伺服器。桌面版初次測試時,不必同時啟用 TUN;先在系統代理選單中選擇「自動設定系統代理」,再用會讀取系統代理的瀏覽器測試。Android 版則在選取節點後啟動連線,首次使用時確認系統 VPN 授權。
若瀏覽器可以連線、目標應用程式卻不行,先檢查該應用程式是否有內建代理設定。確定需要接管不讀取系統代理的程式時,再測試 TUN。切換前先記下原本的系統代理狀態,以免事後無法判斷是哪項變更造成問題。
檢查用戶端記錄,確認核心是否正常啟動,再開啟要測試的網頁或應用程式。延遲測試只反映當次探測結果,不能取代實際連線測試。應用程式連線失敗時,記下大約時間、目前使用的節點、代理模式,以及第一則有用的錯誤訊息。
下一輪測試只變更一個條件:先在同一個應用程式中更換已知可用的節點,再用同一個節點比較不同應用程式。前者有助於判斷節點或傳輸問題,後者則能確認應用程式是否受到代理接管。測試結束後,請關閉 TUN 或清除臨時設定的系統代理,並確認原有網路連線已恢復。
開源生態系
圖形介面負責輸入與管理設定,核心負責建立連線、處理協定及執行路由。了解這兩者的分工,才能判斷該更換安裝檔、修正節點參數,還是調整代理入口。
Project V 將入站、出站與路由組織成可組合的網路設定。入站決定流量如何交給程式,出站決定流量如何傳送,路由則負責將不同目標導向適當的出站。V2Fly 是延續 V2Ray 開發的社群專案,負責維護 V2Ray 核心及相關文件。
這項分工也能解釋常見的設定問題:成功匯入節點,只代表用戶端讀取了清單;節點能否建立連線,取決於核心是否支援相關參數;瀏覽器是否使用這條連線,則取決於應用程式能否將請求交給用戶端。排查時分別確認這三個環節,比反覆更新訂閱更有效。
Xray 從 V2Ray 程式碼體系分支後獨立發展,與 V2Fly 共用部分設定概念,但功能與參數由各自維護。以 REALITY 為例,它屬於連線的安全層設定,不能視為取代 VMess 或 VLESS 的節點協定。將一組連線參數拆分為節點協定、傳輸方式與安全層,有助於找出真正不相容的欄位。
在桌面版更換核心前,先確認原節點使用的傳輸方式、流控與安全選項是否都受支援。設定成功載入後,再查看連線記錄;若程式一啟動就報錯,優先檢查設定與核心的組合,不要先修改系統代理或反覆更換 DNS。
v2rayN、v2rayNG 和 v2flyNG 都是開源圖形介面用戶端。v2rayN 管理桌面版的節點與路由,可搭配支援的核心使用;v2rayNG 適用於 Android,以 Xray 為核心;v2flyNG 則適用於需要 V2Fly 核心的 Android 設定。介面或名稱相似,不代表進階設定與設定檔可以直接互換。
開源授權規範程式碼的使用、修改與重新散布,實際條款請以各專案及隨附元件的授權為準。用戶端程式碼開源,與訂閱服務由誰提供、節點能否長期使用是兩回事。選擇用戶端時先確認平台與核心需求;排查訂閱問題時,再分別確認訂閱來源與更新狀態。
更新用戶端可能改變介面、預設設定或執行環境;更新核心可能影響可用協定功能、設定解析或連線行為;更新訂閱則是重新取得節點清單。這三種更新不能互相取代。節點清單沒有更新時,不必先重新安裝程式;核心無法辨識欄位時,反覆更新清單也不一定有幫助。
變更前先記下目前使用的節點、系統代理模式、自訂路由與監聽連接埠。每次只更新其中一層,使用同一節點與應用程式重新測試,再決定是否修改下一項。若遇到無法連線,可逐項比對原設定與新設定,找出差異所在。若不確定協定名稱或設定欄位,可先查閱術語表。
設定與故障排除
透過握手流程圖解說,拆解 REALITY 借用憑證的概念與 XTLS Vision 的流控機制,說明它們減少重複加密的原理,以及在 v2rayN 中對應的設定項目。
從本機時間同步、連接埠與系統代理狀態,到訂閱更新、傳輸層參數及 TLS 設定,依由近到遠的順序逐項排查節點逾時,並說明每一步的判斷方式。
比較 v2rayN 兩種 Windows 發行版本的介面與執行環境差異,完整說明解壓縮、首次執行、匯入訂閱及設定系統代理,並整理防毒軟體誤判、連接埠占用等常見問題。