v2rayN
Windows · 7.24.1
两个入口的主要区别是界面技术与操作布局,不是订阅等级。桌面版与 WPF 版都需要有效配置;已有用户应先记录当前的订阅分组、路由模式和端口,再决定是否更换界面。初次使用通常只安装其中一版,避免同时运行后出现端口冲突。
下载完成后,在文件资源管理器中找到 ZIP 文件,选择“全部解压缩”,再进入解压后的目录运行安装程序。不要直接在压缩包预览窗口里启动。安装位置应保留正常读写权限,后续更新也使用清楚、固定的目录,便于查找配置与日志。
先选操作系统,再选处理器与安装格式。
桌面使用 v2rayN;Android 优先选择 v2rayNG,按内核需求选择 v2flyNG。下面的按钮直接对应安装文件,安装后的订阅导入与代理设置见入门指南。
切换平台后查看对应客户端。包格式与处理器架构要同时匹配,不能只按文件扩展名选择。
Windows · 7.24.1
两个入口的主要区别是界面技术与操作布局,不是订阅等级。桌面版与 WPF 版都需要有效配置;已有用户应先记录当前的订阅分组、路由模式和端口,再决定是否更换界面。初次使用通常只安装其中一版,避免同时运行后出现端口冲突。
下载完成后,在文件资源管理器中找到 ZIP 文件,选择“全部解压缩”,再进入解压后的目录运行安装程序。不要直接在压缩包预览窗口里启动。安装位置应保留正常读写权限,后续更新也使用清楚、固定的目录,便于查找配置与日志。
| 检查项 | 本页入口 | 选择方法 |
|---|---|---|
| 处理器架构 | x64 | 在“设置 → 系统 → 系统信息”查看系统类型,确认与 x64 包匹配。 |
| 安装方式 | 解压后运行安装程序 | 先完成解压,再按安装程序提示处理运行环境与安装目录。 |
| 运行条件 | 以当前安装程序要求为准 | 若系统过旧或提示缺少运行环境,先处理提示,不要反复更换订阅。 |
| 网络权限 | 按所用模式授权 | 普通系统代理与 TUN 的权限需求不同,先完成基础配置再启用进阶模式。 |
首次启动后,先导入订阅并确认服务器条目,再选择“自动配置系统代理”。路由可从“绕过大陆”开始检查。系统代理只影响遵循系统代理设置的应用;若某个应用没有走代理,应先查它自身的网络设置,不必立刻重新安装客户端。
macOS · 7.24.1
打开屏幕左上角的苹果菜单,进入“关于本机”。如果“芯片”一栏显示 Apple M 系列,选择 Apple Silicon;如果“处理器”一栏显示 Intel,选择 Intel。相同外观的电脑可能使用不同芯片,不要只凭机型名称或购买年份判断。
打开 DMG 后,将应用复制到“应用程序”文件夹,再从该目录启动。不要长期从磁盘映像中运行。系统出现首次打开提示时,阅读提示内容,必要时到“系统设置 → 隐私与安全性”查看是否有对应应用的允许入口。不要为单个应用关闭系统整体安全保护。
| 检查项 | 可选安装包 | 安装前确认 |
|---|---|---|
| 芯片类型 | ARM64 / x64 | 在“关于本机”中读取芯片或处理器信息。 |
| 安装位置 | 应用程序文件夹 | 复制完成后从本地应用目录启动,再推出磁盘映像。 |
| 系统兼容 | 以当前应用提示为准 | 启动时若提示系统版本不兼容,先确认系统条件与所选架构。 |
| 网络配置权限 | 按实际功能授权 | 系统代理与 TUN 分开设置,出现授权请求时确认应用与用途。 |
启动客户端后,先完成订阅导入,再设置系统代理与路由。若浏览器仍使用原有网络,检查系统网络设置中的代理状态,以及浏览器是否启用了独立代理配置。休眠恢复、切换无线网络或接入其他网络工具后,也应重新确认代理入口是否仍然有效。
Android · Xray 内核 · 2.2.6
v2rayNG 使用 Xray 内核,是本页的 Android 首选客户端。订阅中的协议、传输方式与附加参数仍需由当前客户端支持;导入成功只表示配置被读取,不代表服务器已经可用。先选中一个服务器完成连接,再检查实际应用访问。
Android · V2Fly 内核 · 1.10.31
v2flyNG 是使用 V2Fly 内核的备选客户端,不是 v2rayNG 的架构补丁。两款客户端的配置兼容性应分别确认,尤其不要假定面向 Xray 的特定参数可以直接使用。已有配置明确依赖 V2Fly 时,再按对应要求选择这一入口。
| 检查项 | 选择范围 | 操作提示 |
|---|---|---|
| 应用架构 | arm64 / 通用版 | 设备处理器与系统支持的应用架构都要匹配,不能只看处理器宣传信息。 |
| 安装权限 | 当前下载应用 | 系统要求时,为浏览器或文件管理器开放“安装未知应用”权限。 |
| 连接授权 | 系统 VPN 连接请求 | 首次连接时确认请求来自所选客户端,再允许创建连接。 |
| 后台运行 | 按设备电池策略调整 | 若锁屏后中断,再检查电池优化与后台活动限制。 |
安装 APK 时若提示“应用未安装”,先检查剩余空间、系统应用架构和已有应用的安装来源。不同来源的应用签名可能不同,不能直接覆盖;处理前先备份订阅地址与必要设置。不要把卸载作为第一步,因为卸载可能同时移除本地配置。
两款客户端通常只需选择一个。若为了比较配置而都已安装,测试时先停止另一个客户端的连接,再启动当前客户端。连接请求获准后,按需要检查分应用代理规则;某个应用被排除时,它的访问路径可能与浏览器不同。
Linux · 7.24.1
先按发行版选择 deb 或 rpm,再按硬件选择 x64 或 ARM64。软件包中的 amd64 与 x86_64 都指向常见的 x64 桌面架构;arm64 与 aarch64 对应 ARM64。扩展名匹配不代表系统依赖一定满足,特别是较旧发行版,还需要查看软件安装器给出的依赖提示。
下载后可在文件管理器中打开软件包,交给系统的软件安装器处理。安装完成后,从应用菜单启动 v2rayN。若安装器提示依赖无法满足,先确认发行版版本与架构,不要通过强行跳过依赖来完成安装。桌面环境与网络设置入口不同,也可能影响系统代理的生效范围。
| 检查项 | 可选范围 | 确认位置 |
|---|---|---|
| 软件包格式 | deb / rpm | 在系统“关于”页面查看发行版,再使用对应软件安装器。 |
| 处理器架构 | x64 / ARM64 | 在系统信息中确认 x86_64 或 aarch64,分别匹配对应下载项。 |
| 图形环境 | 桌面会话 | 本页提供图形客户端,安装后从桌面应用菜单启动。 |
| 系统依赖 | 以软件包要求为准 | 安装器提示依赖缺失时,先处理发行版兼容与软件源状态。 |
首次使用建议先用普通代理方式验证配置,再考虑 TUN。系统代理是否被应用读取,取决于桌面环境与应用本身;浏览器可用而其他程序不可用时,先确认程序的代理入口。TUN 涉及额外网络权限与路由调整,应与其他虚拟网络工具分开测试,详见高级用法。
安装包解决客户端运行问题。订阅、代理入口与路由需要在启动后分别设置,按顺序检查更容易定位问题。
v2rayN 从“订阅分组”进入分组设置,填写订阅地址后执行更新;v2rayNG 从“订阅设置”添加地址,再更新订阅。单条分享链接与订阅地址不是同一种内容,应使用对应的导入入口。导入后先确认服务器列表有条目,再选中一个服务器。客户端本身不附带可用服务器,下载完成也不会自动获得订阅。
桌面端先检查系统代理设置;Android 首次连接时确认系统连接授权。系统代理与路由是两层设置:前者决定应用是否把流量交给客户端,后者决定进入后的流量如何分配。初次测试不要同时开启多个代理工具,也不要把系统代理、TUN 和自定义路由一起修改,否则难以判断是哪一项影响了结果。
选择服务器并启动连接后,使用浏览器与实际需要的应用分别测试。只看到连接图标并不足以说明所有应用都使用了代理;应检查目标应用的实际访问情况。确认可用后,记录当前代理模式、路由和订阅分组。继续调整 DNS 或 TUN 前保留这组可用设置,出现问题时便于逐项恢复。
先区分下载、安装、启动和连接四个阶段。安装包无法打开与订阅无法连接通常不是同一类问题,按阶段处理,避免重复下载。
记录订阅地址、分组名称与必要的自定义设置。订阅地址可能带有个人访问凭据,不要放进公开截图或分享给其他人。更新时先退出正在运行的客户端,再使用相同客户端、相同架构的安装包。更换界面版本或安装来源前,确认配置能否迁移,不要默认所有设置都会自动保留。
如果系统提示架构不匹配、依赖缺失或安装来源冲突,应先解决安装条件;如果客户端可以启动,但订阅更新失败,再检查订阅地址与当前网络。若订阅可以更新而应用无法访问,应继续检查服务器选择、代理入口和路由,不必直接卸载。排查时保留错误文字,比只记录“不能用”更有帮助。
点击下载按钮后,在浏览器的下载列表查看任务是否开始。文件保存位置由浏览器设置决定,通常可以从下载列表直接打开所在文件夹。若点击后没有出现文件,先检查浏览器的下载提示与当前网络,再重试对应入口。不要把未完成的下载文件直接交给安装程序,也不要仅修改扩展名尝试安装。
包选择与首次安装的常见疑问。展开问题即可查看说明。
首次使用可先选桌面版,它采用新一代跨平台界面。WPF 版是经典稳定的 Windows 界面,适合延续原有操作习惯。两个入口均为 x64 包,通常选择其中一个即可。
打开苹果菜单中的“关于本机”。“芯片”一栏显示 Apple M 系列时选择 Apple Silicon;“处理器”一栏显示 Intel 时选择 Intel。安装前先确认芯片类型,不要根据电脑外观判断。
2015 年后的主流手机通常优先选择 arm64,但仍需确认系统支持的应用架构。通用版包含多种架构支持,适合架构不明确或 arm64 安装失败时使用,文件通常更大。
通常选择一个即可。v2rayNG 使用 Xray 内核,作为 Android 首选入口;v2flyNG 使用 V2Fly 内核,供需要对应内核的配置使用。两者的协议与配置兼容性应分别确认,测试时避免同时启动连接。
先按发行版选择包格式,再按处理器选择架构。Debian、Ubuntu 系通常使用 deb;Fedora、RHEL 系通常使用 rpm。x86_64 对应 x64,aarch64 对应 ARM64,具体系统依赖还需由软件安装器确认。
还需要导入有效订阅或服务器配置,选择服务器,并设置代理入口与路由。客户端本身不附带可用服务器。首次配置建议先完成订阅导入,再检查系统代理或连接权限,最后验证实际应用访问。