v2rayN
7.24.1v2rayN 是 Windows 的主要圖形客戶端。Desktop 使用新一代跨平台 UI,介面配置接近 macOS、Linux 版本;WPF 保留經典 Windows 介面,選單位置與操作習慣更適合長期使用舊版的使用者。
新一代跨平台介面。適合首次安裝,或希望維持一致桌面操作方式的使用者。
經典穩定介面。適合熟悉伺服器清單、系統匣選單與傳統設定視窗的使用者。
V2Ray 客戶端安裝包
桌面端使用 v2rayN。Android 可選擇 v2rayNG,需要 V2Fly 核心路線時使用 v2flyNG。先確認作業系統與處理器架構,再下載對應安裝包。
平台與安裝包
平台切換會保留在頁面網址中。複製目前網址後,即可直接開啟對應系統的下載面板。
Windows 客戶端
兩種介面版本都提供訂閱群組、伺服器清單、系統代理、路由分流與日誌檢視。首次使用可優先選擇 Desktop;已熟悉傳統 Windows 選單與 WPF 操作流程時,也可繼續使用經典版本。
v2rayN 是 Windows 的主要圖形客戶端。Desktop 使用新一代跨平台 UI,介面配置接近 macOS、Linux 版本;WPF 保留經典 Windows 介面,選單位置與操作習慣更適合長期使用舊版的使用者。
新一代跨平台介面。適合首次安裝,或希望維持一致桌面操作方式的使用者。
經典穩定介面。適合熟悉伺服器清單、系統匣選單與傳統設定視窗的使用者。
| 檢查項目 | 建議 | 說明 |
|---|---|---|
| 系統架構 | x64 | 本頁提供的 Windows 安裝包適用於常見的 64 位元桌面裝置。 |
| 磁碟權限 | 允許寫入設定目錄 | 訂閱、路由規則、日誌與介面設定需要儲存在客戶端設定目錄中。 |
| 網路設定 | 視需要開啟系統代理 | 啟動客戶端不代表系統代理已開啟,請從系統匣選單確認目前狀態。 |
下載 ZIP 後先完整解壓縮,再從解壓縮後的目錄執行安裝程式。不要直接在壓縮檔預覽視窗中啟動。安裝完成後開啟 v2rayN,先匯入訂閱或單一伺服器設定,再選擇伺服器並設定路由模式。若要讓瀏覽器及支援系統代理的程式使用目前設定,請開啟「系統代理」。若需要接管更多應用程式流量,再閱讀教學中的 TUN 模式說明。
macOS 客戶端
Apple Silicon 與 Intel 使用不同的安裝包。選擇正確架構可減少相容性轉換,讓客戶端與本機執行環境保持一致。晶片類型可在「關於這台 Mac」中查看。
開啟螢幕左上角的系統選單,進入「關於這台 Mac」。若晶片欄顯示 Apple M 系列,下載 Apple Silicon;若處理器欄顯示 Intel,下載 Intel 版本。安裝包架構應與裝置晶片一致。
適用於搭載 Apple M 系列晶片的 Mac,是目前新款裝置的常見選擇。
適用於「關於這台 Mac」中明確顯示 Intel 處理器的 Mac。
| 檢查項目 | 選擇 | 說明 |
|---|---|---|
| 晶片 | Apple Silicon 或 Intel | 在「關於這台 Mac」查看晶片或處理器名稱,不要依系統外觀判斷。 |
| 安裝格式 | DMG | 開啟磁碟映像檔後,將應用程式移至系統的「應用程式」目錄。 |
| 網路權限 | 依系統提示確認 | 啟用系統代理或 TUN 模式時,系統可能要求確認網路相關權限。 |
下載 DMG 後按兩下開啟磁碟映像檔,將 v2rayN 移至「應用程式」目錄,再從該目錄啟動。首次開啟若出現開發者確認提示,請透過系統設定中的安全性相關頁面核對應用程式並允許執行。進入客戶端後匯入訂閱,選擇伺服器,再開啟需要的代理模式。系統代理適用於讀取系統代理設定的應用程式;TUN 模式涉及更廣泛的流量接管,應先完成基本連線測試再啟用。
Android 客戶端
v2rayNG 使用 Xray 核心,是 Android 的優先選擇。v2flyNG 使用 V2Fly 核心,適合需要對應核心路線的設定。每款客戶端都提供 arm64 與通用安裝包。
適合大多數 Android 手機與平板。支援匯入訂閱、掃描 QR Code、從剪貼簿匯入、路由設定、分應用程式代理與連線日誌。2015 年後推出的主流手機通常可優先選擇 arm64。
主流 64 位元 Android 裝置的優先選項,安裝包僅包含對應架構元件。
無法確認處理器架構,或 arm64 安裝時提示不相容時選擇。
介面操作接近常見 Android 代理客戶端,核心路線採用 V2Fly。適合明確需要 V2Fly 相容行為,或希望在同一裝置上保留另一套客戶端設定的使用者。
適用於常見 64 位元 ARM 手機與平板,請優先依裝置架構安裝。
適用於無法確定架構,或需要更廣泛裝置相容性的安裝情境。
| 檢查項目 | 建議 | 說明 |
|---|---|---|
| 處理器架構 | 主流裝置優先選 arm64 | 安裝時若提示架構不相容,返回本頁改用通用版。 |
| 安裝格式 | APK | 系統需要允許目前使用的瀏覽器或檔案管理器安裝此檔案。 |
| VPN 連線權限 | 首次連線時確認 | 客戶端建立本機 VPN 介面時,Android 會顯示系統授權視窗。 |
下載完成後,從通知列或檔案管理器開啟 APK。若系統阻止安裝,請進入目前來源對應的安裝權限頁面完成確認,再返回繼續。啟動客戶端後,可透過「訂閱設定」新增訂閱網址,也可以掃描 QR Code 或從剪貼簿匯入單一設定。選擇設定並點擊連線按鈕後,Android 會要求建立 VPN 連線,確認後再查看頂端狀態與客戶端日誌。
若訂閱更新完成但清單為空,先查看群組篩選條件,再確認訂閱網址是否完整。若設定可以匯入但無法連線,請依序檢查裝置時間、網路權限、選取的設定、路由模式與日誌提示。不要同時啟動多個會建立 VPN 介面的應用程式,以免系統連線狀態互相覆蓋。
Linux 客戶端
先依發行版的軟體包體系選擇 deb 或 rpm,再依處理器選擇 x64 或 arm64。桌面裝置常見 x64,ARM 開發板與部分輕量裝置常見 arm64。
Debian、Ubuntu 及其衍生發行版通常選擇 deb。Fedora、RHEL、Rocky Linux、AlmaLinux 等採用 RPM 軟體包體系的發行版選擇 rpm。架構與包格式必須同時相符。
常見 x64 Debian、Ubuntu 桌面裝置。
常見 x64 RPM 軟體包體系發行版。
| 發行版或裝置 | 包格式 | 架構選擇 |
|---|---|---|
| Debian、Ubuntu 及衍生版 | deb | 一般 PC 通常選 x64,ARM 裝置選 arm64。 |
| Fedora、RHEL 系及衍生版 | rpm | x86_64 對應 x64,aarch64 對應 arm64。 |
| 桌面工作階段 | 圖形環境 | 需要可用的桌面環境與系統匣支援。 |
下載後可使用發行版的軟體安裝器開啟對應軟體包,也可以透過系統包管理工具執行本機安裝。包管理器能同時處理缺少的相依套件,因此比直接解包更合適。啟動 v2rayN 後,先確認介面能寫入設定目錄,再匯入訂閱並選擇伺服器。系統代理的生效範圍取決於桌面環境與應用程式本身的設定;瀏覽器或命令列工具若有獨立代理設定,需分別檢查。
首次啟動
客戶端安裝完成只是第一步。訂閱、伺服器選擇、路由模式與系統接管狀態需要依序確認。先建立最基本可用的設定,再調整 TUN、DNS 或自訂規則。
訂閱網址通常位於客戶端的「訂閱群組」或「訂閱設定」中。新增名稱與網址後執行更新,伺服器清單才會寫入目前群組。單一分享連結可透過剪貼簿匯入;Android 也可以使用 QR Code 掃描。匯入完成後,檢查協定、位址、連接埠與傳輸方式是否完整顯示。
同時存在多個訂閱時,先確認目前查看的是哪個群組,再選擇要使用的伺服器。桌面端通常可在伺服器清單中設為目前伺服器,Android 則從設定清單點選。延遲測試僅用於輔助判斷連線路徑,不代表實際下載速度;應結合穩定性與日常使用結果進行選擇。
首次連線建議使用客戶端提供的一般規則模式,確認基本連線正常後再修改。規則會由上至下比對,命中後採用對應的出站。常見規則包括 geosite:cn 直連、geoip:private 直連,以及依需求將其他網域集合透過代理出站。
桌面端啟動客戶端後,仍需視需要開啟系統代理;Android 首次連線時需要確認系統 VPN 授權。若瀏覽器可以連線但其他程式不行,請檢查該程式是否讀取系統代理。若所有程式都沒有流量,先查看客戶端日誌,再檢查本機連接埠、目前伺服器與系統時間。
安裝包判斷
安裝失敗通常不是設定問題,而是平台、處理器架構或軟體包格式選擇不相符。下載前先完成以下三組判斷。
x64 常見於 Windows PC 與傳統 Linux 桌面裝置。arm64 常見於 Android 手機、Apple M 系列裝置,以及部分 ARM Linux 裝置。同一應用程式的不同架構安裝包包含對應處理器程式碼,不能只看檔名中的版本號。
DMG 用於 macOS,APK 用於 Android。deb 與 rpm 是兩種 Linux 軟體包格式,由發行版的軟體包體系決定。Windows 本頁提供安裝程式壓縮包,下載後需要先完整解壓縮再執行。
兩者都是 Android 圖形客戶端,但核心路線不同。v2rayNG 使用 Xray,適合大多數常見設定;v2flyNG 使用 V2Fly,可作為對應生態系設定的備選。兩個客戶端的訂閱應分開管理,避免誤判目前實際執行的設定。
更新與移轉
客戶端更新通常可以沿用現有訂閱與路由規則,但設定目錄位置、桌面版本類型與系統權限可能發生變化。更新前先退出正在執行的程式,避免設定檔仍被占用。
桌面端建議記錄目前訂閱群組名稱、目前伺服器、系統代理模式、本機監聽連接埠與自訂路由。Android 可檢查訂閱網址、分應用程式代理清單與 VPN 權限。完成備份後安裝新版,再逐項確認資料是否載入。
下載常見問題
以下問題對應本頁提供的客戶端與安裝包。更完整的訂閱、路由、DNS、TUN 與故障處理說明,請繼續查看教學與 FAQ。
Desktop 是新一代跨平台介面,適合首次安裝,以及希望 Windows、macOS、Linux 操作方式更一致的使用者。經典 WPF 版保留傳統 Windows 介面,伺服器清單、系統匣選單與設定視窗的位置更接近長期使用舊版的操作習慣。
兩種版本都可以完成訂閱匯入、伺服器選擇、系統代理與路由設定。選擇主要取決於介面偏好,不需要同時執行。切換版本前退出目前客戶端,並備份重要的訂閱群組與自訂規則。
開啟螢幕左上角的系統選單,選擇「關於這台 Mac」。若晶片欄顯示 Apple M 系列,選擇 Apple Silicon 安裝包;若處理器欄顯示 Intel,選擇 Intel 安裝包。不要依裝置年份、外觀或螢幕尺寸推測。
下載正確的 DMG 後,將應用程式移至「應用程式」目錄。首次啟用系統代理或 TUN 相關功能時,依系統提示處理網路權限,再返回客戶端確認開關狀態。
2015 年後推出的主流 Android 手機通常使用 64 位元 ARM 處理器,因此可優先選擇 arm64。arm64 包只包含對應架構元件,檔案目標更明確。無法確認裝置架構,或安裝時提示應用程式與裝置不相容,再選擇通用版。
arm64 與通用版的客戶端功能基本一致,差異主要在安裝包包含的處理器架構。安裝完成後仍需匯入訂閱、選擇設定,並確認 Android 的 VPN 連線授權。
Debian、Ubuntu 及其衍生發行版使用 deb。Fedora、RHEL、Rocky Linux、AlmaLinux 等採用 RPM 軟體包體系的發行版選擇 rpm。接著判斷裝置是 x64 還是 arm64,兩項都相符才是正確的安裝包。
常見 PC 的架構名稱通常顯示為 x86_64,對應 x64;ARM 裝置常顯示 aarch64,對應 arm64。安裝時優先使用系統包管理器,讓相依套件由發行版正常處理。
通常不需要。更新前先退出客戶端,並備份訂閱群組、路由規則、自訂出站與其他重要設定。安裝新版後檢查原設定目錄是否被識別,再執行一次訂閱更新,並確認目前伺服器與代理模式。
若從 Windows WPF 切換至 Desktop,或跨越較多版本更新,介面配置與設定目錄的處理方式可能不同。此時先保留舊目錄,不要立即清理;待新版本完成連線測試並確認規則正常後,再整理舊檔案。