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 使用不同的安装包。选择正确架构可以减少兼容转换,并让客户端与本机运行环境保持一致。芯片类型可在“关于本机”中查看。
打开屏幕左上角的系统菜单,进入“关于本机”。如果芯片栏显示 Apple M 系列,下载 Apple Silicon;如果处理器栏显示 Intel,下载 Intel 版本。安装包架构应与设备芯片一致。
用于 Apple M 系列芯片的 Mac,是当前新款设备的常见选择。
用于“关于本机”中明确显示 Intel 处理器的 Mac。
| 检查项 | 选择 | 说明 |
|---|---|---|
| 芯片 | Apple Silicon 或 Intel | 在“关于本机”查看芯片或处理器名称,不按系统外观判断。 |
| 安装格式 | DMG | 打开磁盘映像后,将应用移动到系统的应用程序目录。 |
| 网络权限 | 按系统提示确认 | 启用系统代理或 TUN 模式时,系统可能要求确认网络相关权限。 |
下载 DMG 后双击打开磁盘映像,将 v2rayN 移动到应用程序目录,再从该目录启动。首次打开若出现开发者确认提示,应通过系统设置中的安全相关页面核对应用并执行允许操作。进入客户端后导入订阅,选择服务器,再开启需要的代理模式。系统代理适用于读取系统代理设置的应用;TUN 模式涉及更广的流量接管,应先完成基本连接测试再启用。
Android 客户端
v2rayNG 使用 Xray 内核,是 Android 的优先选择。v2flyNG 使用 V2Fly 内核,适合需要对应内核路线的配置。每款客户端都提供 arm64 与通用安装包。
适合大多数 Android 手机和平板。支持订阅导入、二维码扫描、剪贴板导入、路由设置、分应用代理与连接日志。2015 年后发布的主流手机通常可优先选择 arm64。
主流 64 位 Android 设备的优先选项,安装包仅包含对应架构组件。
无法确认处理器架构,或 arm64 安装提示不兼容时选择。
界面操作与常见 Android 代理客户端接近,核心路线采用 V2Fly。适合明确需要 V2Fly 兼容行为,或希望在同一设备上保留另一套客户端配置的用户。
用于常见 64 位 ARM 手机与平板,优先按设备架构安装。
面向无法确定架构或需要更广设备兼容范围的安装场景。
| 检查项 | 建议 | 说明 |
|---|---|---|
| 处理器架构 | 主流设备优先 arm64 | 安装提示架构不兼容时,返回本页改用通用版。 |
| 安装格式 | APK | 系统需要允许当前浏览器或文件管理器安装该文件。 |
| VPN 连接权限 | 首次连接时确认 | 客户端建立本地 VPN 接口时,Android 会显示系统授权窗口。 |
下载完成后从通知栏或文件管理器打开 APK。系统如果阻止安装,应进入当前来源对应的安装权限页面,完成确认后返回继续。启动客户端后,可通过“订阅设置”添加订阅地址,也可以扫描二维码或从剪贴板导入单个配置。选择配置并点击连接按钮后,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 还可以使用二维码扫描。导入完成后检查协议、地址、端口和传输方式是否显示完整。
多个订阅并存时,先确认当前查看的是哪个分组,再选择需要使用的服务器。桌面端通常可在服务器列表中设为活动服务器,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 界面,服务器列表、托盘菜单与设置窗口的位置更接近长期使用的旧版操作习惯。
两种版本都可以完成订阅导入、服务器选择、系统代理和路由配置。选择主要取决于界面偏好,不需要同时运行。切换版本前退出当前客户端,并备份重要的订阅分组与自定义规则。
打开屏幕左上角的系统菜单,选择“关于本机”。如果芯片栏显示 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,或跨越较多版本更新,界面布局和配置目录处理方式可能不同。此时先保留旧目录,不要立即清理;待新版本完成连接测试并确认规则正常后,再整理旧文件。