v2rayN
Windows / macOS / Linux
首推
Xray 内核
zip
桌面端的主力客户端,支持订阅导入、节点测速、路由分流与系统代理切换,内置 Xray 内核。下面两个安装包按界面形态区分,功能与配置格式一致。
安装包入口
V2Ray 客户端下载
页面按 Windows、macOS、Android、Linux 四个平台列出 v2rayN、v2rayNG、v2flyNG 三款客户端的安装包入口,每个入口都标注了架构与文件格式。桌面端首推 v2rayN,Android 端首推 v2rayNG,v2flyNG 作为 v2fly 内核的备选方案保留。下载前先确认设备架构,再对照系统要求安装。
3 款客户端 · 4 个平台 · Xray / V2Fly 内核 · GPL-3.0 开源协议
平台清单
按平台获取安装包
四个平台的客户端清单固定不变:Windows、macOS、Linux 使用 v2rayN,Android 使用 v2rayNG,需要 v2fly 内核时改用 v2flyNG。切换到对应标签,可以看到该平台的安装包、系统要求与安装提示。
Windows 平台
Windows 上提供 v2rayN 一款客户端,按界面框架分成桌面版与经典 WPF 版两个安装包。两者共用同一套订阅与路由配置,换版本时配置可以直接沿用。下载得到的是 zip 压缩包,解压后运行目录内的主程序即可。
系统要求
| 系统版本 | Windows 10 1809 及以上、Windows 11 |
|---|---|
| 处理器架构 | x64(64 位) |
| 安装方式 | zip 压缩包,解压后运行目录内主程序 |
| 磁盘空间 | 预留数百 MB,用于程序文件与订阅缓存 |
| 权限 | 切换系统代理需要写入系统设置;启用虚拟网卡模式时需要管理员权限 |
安装提示
解压目录建议放在用户目录下,避免放进需要管理员权限的系统路径。如果切换系统代理后浏览器没有变化,先退出其他正在运行的代理工具再试,多个工具同时修改系统代理设置会互相覆盖。
macOS 平台
macOS 上同样使用 v2rayN,安装包是 dmg 磁盘映像,打开后把程序拖入「应用程序」文件夹即可。macOS 版与 Windows 版共用同一套配置格式,订阅链接与路由规则可以直接迁移。安装包按芯片架构分成两个,下载前先确认自己的机型。
v2rayN
macOS / Windows / Linux
Xray 内核
dmg
双架构
运行在菜单栏的桌面客户端,支持订阅导入、节点切换、路由分流与系统代理。dmg 安装包按芯片架构区分,下面两个入口分别对应 Apple Silicon 与 Intel 机型。
系统要求
| 系统版本 | macOS 11 及以上 |
|---|---|
| 芯片架构 | Apple Silicon(arm64)或 Intel(x64) |
| 安装方式 | 打开 dmg,把程序拖入「应用程序」文件夹 |
| 首次启动 | 如提示无法验证开发者,在「系统设置 → 隐私与安全性」中允许打开 |
| 权限 | 修改系统代理需要用户授权,首次运行建议先退出旧版本 |
安装提示
安装新版本前先退出正在运行的旧版本,避免两个实例同时修改系统代理。更换架构版本时先关闭旧版本再安装,配置可以在新版本里重新导入订阅后继续使用。
Android 平台
Android 上提供 v2rayNG 与 v2flyNG 两款客户端,前者使用 Xray 内核,后者使用 v2fly 内核,界面与操作方式接近。日常使用优先 v2rayNG;已有 v2fly 内核配置或需要对照内核差异时,再选 v2flyNG。两个安装包都是 APK,下载后直接安装。
v2rayNG
Android
首推
Xray 内核
apk
Android 端使用最广的 V2Ray 客户端,支持订阅导入、节点分组、延迟测试与分应用代理。安装包按处理器架构分成 arm64 与通用版两个入口。
v2flyNG
Android
备选
v2fly 内核
apk
基于 v2fly 内核的 Android 客户端,功能布局与 v2rayNG 接近。适合已有 v2fly 内核配置,或需要与 v2fly 行为对照的场景;没有特定需求时用 v2rayNG。
系统要求
| 系统版本 | Android 8.0 及以上 |
|---|---|
| 处理器架构 | arm64-v8a(主流)或 32 位架构(使用通用版) |
| 安装方式 | APK 直接安装 |
| 权限 | 首次连接会弹出 VPN 连接请求,需要在系统弹窗中确认 |
| 后台运行 | 建议在系统电池设置中允许应用后台活动,避免连接被系统清理 |
安装提示
安装 APK 时系统会询问是否允许来自该来源的应用,确认后才能继续。首次连接必须同意系统的 VPN 连接请求,否则客户端无法接管流量;部分定制系统还会单独限制后台启动,需要在应用管理里放开。
Linux 平台
Linux 上使用 v2rayN,提供 deb 与 rpm 两种包格式,按发行版的包管理器选择即可。x86_64 架构是主要入口,ARM 设备(树莓派、ARM 服务器、部分 ARM 笔记本)使用下方的小字入口。安装包通过系统包管理器完成安装,程序本体与 Windows、macOS 版一致。
v2rayN
Linux / Windows / macOS
Xray 内核
deb
rpm
支持订阅导入、节点测速、路由分流与系统代理的桌面客户端,安装后从应用菜单启动。deb 与 rpm 包只区分包管理器,功能与配置格式相同。
系统要求
| 系统版本 | 主流发行版近两年内的稳定版本 |
|---|---|
| 处理器架构 | x86_64(amd64)或 arm64(aarch64) |
| 安装方式 | 用系统包管理器安装 deb 或 rpm 包 |
| 桌面环境 | 需要图形桌面环境(X11 或 Wayland) |
| 权限 | 修改系统代理使用用户级权限;启用虚拟网卡模式需要相应授权 |
安装提示
架构装错时包管理器会直接拒绝安装,按提示换成对应架构的包即可。安装完成后如果应用菜单没有立即出现图标,注销后重新登录会刷新菜单缓存。
选型参考
三款客户端怎么选
三款客户端都来自 Project V 生态,订阅链接与配置项在它们之间基本通用,差别集中在所在平台与内置内核。选型顺序是:先确定设备平台,再看是否需要与已有配置保持同一内核家族。
| 客户端 | 平台 | 内置内核 | 典型场景 |
|---|---|---|---|
| v2rayN | Windows / macOS / Linux | Xray | 桌面端日常使用,订阅管理、路由分流、测速与日志集中在同一界面 |
| v2rayNG | Android | Xray | 手机与平板端日常使用,支持按应用分流与分应用代理 |
| v2flyNG | Android | V2Fly | 已有 v2fly 内核配置,或需要与 v2fly 行为对照的场景 |
桌面端:优先 v2rayN
Windows、macOS、Linux 三个桌面平台共用同一款客户端,配置文件可以在系统之间迁移。桌面版界面把订阅列表、节点列表、路由设置与运行日志放在同一窗口,排查问题时能直接看到出站节点与报错行,适合需要长期稳定使用的场景。经典 WPF 版与桌面版共用配置格式,可以按界面习惯二选一。
移动端:优先 v2rayNG
Android 上先用 v2rayNG,它使用 Xray 内核,订阅导入与节点切换都集中在主界面,还能按应用决定哪些流量走代理。v2flyNG 使用 v2fly 内核,操作方式接近,适合已有 v2fly 配置或需要对照内核差异的用户。两款客户端的订阅链接格式一致,切换时重新导入即可。
安装流程
下载之后的四个步骤
不同平台的安装方式有差别,后续流程一致:导入订阅、选择节点、确认代理模式、验证连接。完整的分步说明与界面位置对照放在教程页。
-
安装或解压客户端
Windows 解压 zip 后运行主程序;macOS 打开 dmg 把程序拖入「应用程序」;Android 在系统弹窗中允许安装来自当前来源的应用后安装 APK;Linux 用包管理器安装对应架构的 deb 或 rpm 包。
-
导入订阅链接
复制服务商提供的订阅地址,在客户端的订阅设置里新建订阅并粘贴,然后执行一次更新。更新成功后节点列表会自动出现,不需要手工逐条添加节点。
-
选择节点与代理模式
从节点列表里选一个延迟合适的节点,再按需要选择系统代理或路由分流模式。桌面端可以在设置里配置域名分流规则,移动端可以按应用决定哪些流量走代理。
-
验证连接状态
打开浏览器访问一个页面确认连通,同时查看客户端日志里有没有报错。如果连接失败,先看日志中的时间戳与出站节点,再按故障排查顺序逐段缩小范围。
下载常见问题
下载与安装的常见问题
以下问题集中在安装包选择与安装环节;客户端连接、订阅更新与路由配置的疑问,可以到常见问题页与问题诊断页查看。
v2rayN 的桌面版和经典 WPF 版有什么区别?
两个版本共用同一套配置格式与订阅链接,差别在界面框架。桌面版使用新一代跨平台 UI,功能更新与界面调整以这版为主,适合新装用户;经典 WPF 版保留旧版布局,长期维护、行为稳定,适合习惯了旧界面或需要与旧版教程对照的用户。换版本时把原来的配置目录或订阅链接带过去即可,不需要重新配置节点。
macOS 上应该下载 Apple Silicon 版还是 Intel 版?
打开「关于本机」查看芯片一栏:显示 Apple M 系列(M1 及后续)选 Apple Silicon 版,显示 Intel 选 Intel 版。M 系列机型也能通过转译运行 Intel 版,但原生版本在启动速度与功耗表现上更好。下载前确认架构,可以省去装完再换包的步骤。
Android 手机该选 arm64 版还是通用版?
2015 年之后发布的主流机型基本都使用 64 位处理器,选 arm64 版即可,安装包更小。只有老旧机型或不确定处理器架构时,才用同时包含 32 位与 64 位库的通用版。两个安装包的客户端功能一致,区别只在打包的库文件。
Linux 上 deb 和 rpm 该选哪个?
看发行版使用的包管理器:Debian、Ubuntu、Linux Mint 等选 deb,Fedora、RHEL、CentOS Stream、openSUSE 等选 rpm。两种包安装后的程序本体一致,只是包管理方式不同。ARM 设备(树莓派、ARM 服务器、部分 ARM 笔记本)要改用 arm64 与 aarch64 架构的包,架构不匹配时包管理器会直接拒绝安装。
下载的安装包需要另外安装内核吗?
不需要。v2rayN 的安装包内置 Xray 内核,v2rayNG 同样使用 Xray 内核,v2flyNG 内置 v2fly 内核,导入订阅后即可连接。只有在调整内核参数这类进阶场景下才需要了解内核配置项,相关说明放在文档页做技术科普。
下载后无法安装或打开,先检查什么?
先确认安装包与设备架构匹配、系统版本满足要求。macOS 提示无法验证开发者时,到「系统设置 → 隐私与安全性」里允许打开;Android 安装时需要在系统弹窗中允许来自当前来源的应用;Windows 解压后如果提示缺少运行组件,按提示补齐系统组件再运行。仍然打不开时,记下报错原文再到问题诊断页按症状排查。
下一步
装好之后看这些内容
下载和安装只是第一步,订阅更新、路由分流与故障处理都有对应的说明页面。