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 安装包。架构不匹配时可能无法安装或启动。
两个入口对应不同处理器架构,客户端功能定位一致。打开“关于本机”或“系统信息”,查看“芯片”或“处理器”字段;出现 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 版。切换界面版本前应先备份订阅、路由规则和自定义设置。
打开系统信息或“关于本机”,查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon,也就是 arm64 安装包;显示 Intel 处理器时选择 Intel,也就是 x64 安装包。若下载后无法启动,第一步仍应返回系统信息核对架构,而不是反复修改代理配置。
2015 年后的主流 Android 手机通常可选择 arm64,文件更针对当前常见处理器架构。无法确认设备架构、安装时提示不兼容,或设备较旧时,可改用通用版。安装包架构只影响应用能否在设备上运行,不会改变订阅内容本身。
Debian、Ubuntu 及其衍生发行版通常使用 deb;Fedora、Rocky Linux、AlmaLinux 等通常使用 rpm。还需要同时核对处理器架构,普通 Intel 或 AMD 电脑选择 x64,ARM 设备选择 arm64。若发行版采用不同的软件包管理方式,应先查看其文档,再决定是否使用本页提供的格式。
客户端安装包提供图形界面和配置管理能力,但可用的服务器参数或订阅需要另行准备。安装后应导入合法获得的订阅或单项配置,再选择系统代理、路由分流或其他应用接入方式。若浏览器可以访问而终端没有接入,应分别检查终端程序自身的代理参数和环境设置。
更新前应先退出正在运行的客户端,并确认配置目录与安装方式。覆盖更新通常会沿用既有配置,但跨界面版本迁移、改变安装目录或重新安装时,应先使用客户端提供的备份功能保存订阅、路由规则和自定义设置。更新后还应检查本地端口是否变化,以及系统代理是否仍指向正确的监听地址。
下一步依次完成订阅导入、配置选择、系统代理设置和应用范围检查。