v2rayN
首次安裝建議從桌面版開始。桌面版採用新一代跨平台介面,選單與設定的組織方式更符合目前的桌面端體驗;經典 WPF 版保留傳統 Windows 介面,適合已熟悉舊版操作位置、需要延續原有使用習慣的使用者。客戶端用於編輯與管理設定,安裝完成後仍需匯入訂閱或單一伺服器參數。
桌面版 Desktop
新一代跨平台介面,適合首次安裝及希望使用一致桌面介面的使用者。
經典 WPF 版
保留經典 Windows 操作介面,適合熟悉既有選單結構與設定路徑的使用者。
依平台與系統架構選擇
Windows、macOS 與 Linux 使用 v2rayN,Android 優先選擇 v2rayNG,需要 V2Fly 核心路線時再考慮 v2flyNG。下載前先確認作業系統、處理器架構與介面類型。
切換平台後會顯示對應的客戶端、安裝包入口與系統需求。網址列中的平台標記可用於返回目前分類。
桌面平台
一般 64 位元 Windows 電腦選擇 x64 安裝包。v2rayN 提供桌面版與經典 WPF 版,兩者介面結構不同,但都用於管理訂閱、節點、系統代理與路由規則。
首次安裝建議從桌面版開始。桌面版採用新一代跨平台介面,選單與設定的組織方式更符合目前的桌面端體驗;經典 WPF 版保留傳統 Windows 介面,適合已熟悉舊版操作位置、需要延續原有使用習慣的使用者。客戶端用於編輯與管理設定,安裝完成後仍需匯入訂閱或單一伺服器參數。
新一代跨平台介面,適合首次安裝及希望使用一致桌面介面的使用者。
保留經典 Windows 操作介面,適合熟悉既有選單結構與設定路徑的使用者。
| 檢查項目 | 建議 | 原因 |
|---|---|---|
| 系統架構 | 64 位元 Windows 選擇 x64 | 本頁提供的 Windows 套件適用於 x64 處理器環境。 |
| 介面類型 | 新安裝優先選擇桌面版 | 桌面版採用跨平台 UI;WPF 版保留經典介面。 |
| 更新前準備 | 退出客戶端並備份設定 | 避免執行中的檔案被佔用,並保留訂閱、路由與自訂設定。 |
| 安裝後設定 | 匯入訂閱後再選擇代理模式 | 安裝客戶端不代表應用程式已接入代理,仍需繼續完成設定。 |
桌面平台
macOS 使用 v2rayN 桌面客戶端。下載前必須確認晶片類型:Apple M 系列選擇 Apple Silicon 安裝包,Intel 處理器選擇 Intel 安裝包。架構不相符時可能無法安裝或啟動。
兩個入口對應不同處理器架構,客戶端功能定位一致。開啟「關於這台 Mac」或「系統資訊」,查看「晶片」或「處理器」欄位;出現 Apple M 系列名稱時選擇 arm64,出現 Intel 名稱時選擇 x64。不要只憑裝置外觀或購買年份判斷,直接讀取系統資訊更準確。
適用於搭載 Apple M 系列晶片的裝置,目前新款裝置通常屬於此架構。
適用於系統資訊中明確顯示 Intel 處理器的裝置。
| 系統資訊 | 安裝包 | 操作提示 |
|---|---|---|
| Apple M 系列晶片 | Apple Silicon · arm64 | 選擇 v2rayN-arm64.dmg。 |
| Intel 處理器 | Intel · x64 | 選擇 v2rayN-64.dmg。 |
| 首次開啟 | 依系統提示確認應用程式權限 | 代理設定與網路延伸功能相關操作可能需要系統授權。 |
| 應用程式接入 | 檢查瀏覽器與終端機各自的設定 | 系統代理不會自動套用至所有命令列程式。 |
行動平台
優先選擇採用 Xray 核心路線的 v2rayNG;需要 V2Fly 核心路線時選擇 v2flyNG。兩款客戶端都提供 arm64 與通用版,2015 年後的主流手機通常優先使用 arm64。
v2rayNG 是 Android 上的主要選擇,圖形介面負責匯入訂閱、切換設定、路由與分應用程式代理,Xray 核心負責執行連線。首次啟動通常需要確認系統的 VPN 連線授權;如果裝置中已有其他 VPN 類應用程式正在執行,應先處理同時佔用的情況,再啟動客戶端。
適合 2015 年後的多數主流手機與平板裝置,套件針對常見的 64 位元 ARM 架構。
無法確認架構、arm64 安裝失敗或裝置環境較舊時選擇。
v2flyNG 適合需要 V2Fly 核心路線的 Android 使用者。選擇前應確認現有訂閱或手動設定符合所需的核心能力,不要只根據客戶端名稱替換。若沒有明確的核心需求,先使用上方的 v2rayNG;需要與既有 V2Fly 設定保持一致時,再選擇 v2flyNG。
適用於常見的 64 位元 ARM 裝置,處理器架構明確時優先選擇。
適用於架構資訊不明確或需要擴大裝置相容範圍的情況。
| 檢查項目 | 建議 | 說明 |
|---|---|---|
| 客戶端 | 通常優先選擇 v2rayNG | 需要 V2Fly 核心路線時再選擇 v2flyNG。 |
| 處理器架構 | 主流裝置優先選擇 arm64 | 架構不明或安裝不相容時改用通用版。 |
| 首次連線 | 確認系統 VPN 授權 | 客戶端需要透過系統網路介面接入應用程式流量。 |
| 背景執行 | 檢查電池最佳化與背景限制 | 系統省電策略可能會停止客戶端背景程序。 |
| 分應用程式代理 | 核對應用程式包含或排除規則 | 未納入範圍的應用程式不會使用目前的代理連線。 |
桌面平台
Linux 使用 v2rayN 桌面客戶端。先依發行版的軟體包體系選擇 deb 或 rpm,再依處理器選擇 x64 或 arm64。套件格式與處理器架構是兩個獨立條件,需要同時符合。
Debian、Ubuntu 及其衍生發行版通常選擇 deb;Fedora、Rocky Linux、AlmaLinux 等通常選擇 rpm。一般 Intel 或 AMD 桌上型電腦通常選擇 x64,ARM 開發板、ARM 工作站或其他 ARM 裝置選擇 arm64。若不確定發行版的軟體包體系,可先查看系統發行版資訊與套件管理器類型。
適用於使用 deb 軟體包體系的常見 Intel、AMD 64 位元電腦。
適用於使用 rpm 軟體包體系的常見 Intel、AMD 64 位元電腦。
| 環境 | 處理器 | 選擇 |
|---|---|---|
| Debian、Ubuntu 及其衍生版 | Intel / AMD 64 位元 | x64 deb |
| Debian、Ubuntu 及其衍生版 | ARM 64 位元 | arm64 deb |
| Fedora、Rocky Linux、AlmaLinux 等 | Intel / AMD 64 位元 | x64 rpm |
| RPM 軟體包體系發行版 | ARM 64 位元 | arm64 rpm |
| 終端機應用程式接入 | 所有架構 | 檢查應用程式參數或代理環境,不能只看桌面系統代理。 |
安裝客戶端只是準備圖形介面。訂閱來源、代理接入方式與路由選擇仍需分別設定。
v2rayN、v2rayNG 與 v2flyNG 提供圖形介面,用於匯入訂閱、編輯節點、切換設定、管理路由與控制代理模式。客戶端名稱不能取代具體設定,安裝後不會自動產生伺服器參數。
核心讀取客戶端產生的設定並處理連線。v2rayNG 與 v2flyNG 的主要差異之一是核心路線不同,因此更換客戶端前要確認現有協定、傳輸與路由需求,而不是只比較介面名稱。
開啟系統代理後,讀取系統設定的瀏覽器與桌面應用程式通常會接入;終端機程式、獨立網路工具或自行管理連線的應用程式可能需要單獨填寫本機代理位址。應用程式是否接入與路由如何選擇出口是兩回事。
訂閱是一組遠端設定入口,節點是具體的伺服器參數。客戶端只負責保存、更新與呼叫這些內容。匯入前應確認來源、用途與設定權限,更新失敗時再分別檢查訂閱網址、網路存取與客戶端記錄訊息。
遇到多個下載按鈕時,依下列順序判斷,避免將平台、架構與客戶端路線混為一談。
先確認目前裝置執行的是 Windows、macOS、Android 還是 Linux。不同系統的檔案格式、權限模型與代理設定入口不同,即使客戶端名稱相同,安裝包也不能跨平台使用。
檔案格式範例:Windows 使用壓縮安裝包,macOS 使用 DMG,Android 使用 APK,Linux 使用 deb 或 rpm。
x64 通常對應 Intel 或 AMD 64 位元桌面處理器;arm64 對應 Apple M 系列、主流 Android 裝置與部分 ARM Linux 裝置。架構資訊應以系統設定或系統指令顯示的結果為準。
Android 無法確認架構時可選擇通用版;其他平台應盡量選擇正確架構。
桌面平台統一從 v2rayN 開始。Android 通常優先選擇 v2rayNG,只有在明確需要 V2Fly 核心路線時才選擇 v2flyNG。協定名稱、訂閱格式與核心能力需要一併核對。
圖形客戶端與代理核心不是同一個層級,介面相似不代表執行能力完全一致。
更新或更換客戶端前,記錄本機監聽連接埠、系統代理狀態、路由規則、分應用程式設定與 DNS 選項。連接埠變更後,瀏覽器擴充功能、終端機環境與其他手動填寫代理位址的應用程式也要同步修改。
只複製訂閱網址可能不足以還原所有本機自訂設定。
以下問題集中說明安裝包選擇、客戶端關係與更新範圍。更完整的設定步驟可繼續查看快速入門教學。
桌面版採用新一代跨平台介面,適合希望使用一致介面與後續跨平台體驗的使用者;經典 WPF 版保留傳統 Windows 介面與操作流程。兩者都是圖形客戶端,首次安裝可優先選擇桌面版,已有固定操作習慣時再考慮 WPF 版。切換介面版本前應先備份訂閱、路由規則與自訂設定。
開啟系統資訊或「關於這台 Mac」,查看晶片或處理器欄位。顯示 Apple M 系列晶片時選擇 Apple Silicon,也就是 arm64 安裝包;顯示 Intel 處理器時選擇 Intel,也就是 x64 安裝包。若下載後無法啟動,第一步仍應返回系統資訊核對架構,而不是反覆修改代理設定。
2015 年後的主流 Android 手機通常可選擇 arm64,檔案更適合目前常見的處理器架構。無法確認裝置架構、安裝時顯示不相容,或裝置較舊時,可改用通用版。安裝包架構只影響應用程式能否在裝置上執行,不會改變訂閱內容本身。
Debian、Ubuntu 及其衍生發行版通常使用 deb;Fedora、Rocky Linux、AlmaLinux 等通常使用 rpm。還需要同時核對處理器架構,一般 Intel 或 AMD 電腦選擇 x64,ARM 裝置選擇 arm64。若發行版採用不同的軟體包管理方式,應先查看其文件,再決定是否使用本頁提供的格式。
客戶端安裝包提供圖形介面與設定管理功能,但可用的伺服器參數或訂閱需要另外準備。安裝後應匯入合法取得的訂閱或單一設定,再選擇系統代理、路由分流或其他應用程式的接入方式。若瀏覽器可以存取而終端機未接入,應分別檢查終端機程式本身的代理參數與環境設定。
更新前應先退出正在執行的客戶端,並確認設定目錄與安裝方式。覆蓋更新通常會沿用既有設定,但跨介面版本遷移、變更安裝目錄或重新安裝時,應先使用客戶端提供的備份功能保存訂閱、路由規則與自訂設定。更新後還應檢查本機連接埠是否變更,以及系統代理是否仍指向正確的監聽位址。
下一步依序完成訂閱匯入、設定選擇、系統代理設定與應用程式範圍檢查。