Android · Windows · macOS · Linux 客户端

V2Ray安卓客户端v2rayNG 下载与配置

手机选 v2rayNG,桌面选 v2rayN;从订阅导入开始,再按需要设置路由分流。

  • 代码开源
  • 图形界面
  • 中文教程

安装包选型

按系统下载客户端

先确认系统和芯片架构,再选安装包。已有配置的设备,更新前先备份。

Windows

首选 v2rayN 桌面版;习惯经典界面的用户可选 WPF 版。两者的入口位置不完全相同,跟教程操作时先认界面,再找菜单。

打开「设置 → 系统 → 系统信息」,查看「系统类型」。旧电脑能运行六十四位系统,不等于当前装的就是六十四位系统。更新前记下正在用的版本类型和数据目录,避免把新旧文件混在一起。

macOS

在苹果菜单打开「关于本机」。「芯片」栏显示 Apple 芯片就选 Apple Silicon 安装包;「处理器」栏显示 Intel 就选 Intel 安装包。

打开磁盘映像后,把 v2rayN 拖到「应用程序」再启动。不要把映像中的副本和「应用程序」中的副本混着开;更新后若看到旧界面,先确认程序实际从哪个位置启动。

Android

一般先选 v2rayNG;已有明确的 V2Fly 兼容需求,再考虑 v2flyNG。确认系统支持 arm64 就选对应包;不确定架构,先看下载页的通用版和系统要求。

若系统提示无法覆盖安装,先确认安装包对应的是不是同一客户端,以及系统给出的具体原因。不要先卸载旧应用:手动录入的配置和分组备注可能还只存在于旧应用中。

Linux

先按发行版选择包格式,再匹配架构。Debian、Ubuntu 一般选 deb,Fedora 一般选 rpm。包格式正确,也不能代替架构匹配。

可在系统的「关于」页面确认设备架构。安装工具如果报缺少依赖,先记下报错中的库名;如果提示架构不匹配,就回到入口重选。桌面环境不同,系统代理是否被某个应用读取也可能不同。

查看全部客户端

从导入到分流

客户端设置与路由规则

先让一条配置正常连接,再决定哪些应用和地址需要经过代理。下面四项按这个顺序查。

查看配置教程

订阅导入与分组

单条分享链接和订阅地址不是同一种输入。手上只有单条链接时,复制后用「从剪贴板导入」,适合先验证一条配置。拿到的是订阅地址时,给订阅分组起个能识别来源的名字,保存后再更新。分组的好处是换源或排查时只处理一组,不必翻完整列表。更新后确认新增条目进入了哪一组,再手动选中要连接的配置。若列表没有变化,先检查订阅地址是否完整、更新的是否是目标分组,而不是反复点击连接。

导入单条配置右上角 + → 从剪贴板导入
保存订阅后刷新订阅分组设置 → 更新订阅

路由分流规则

路由判断的是已经交给内核的流量该从哪个出站发出。需要保留对局域网打印机、路由器管理页的访问时,可以从绕过局域网的预定义规则开始。自定义规则通常按顺序匹配,把具体例外放在范围较大的规则之前。右侧片段只演示私有地址走直连:实际配置还需要一个标签与规则一致的出站。改完分别测本地服务和预期经过代理的目标;若只有其中一项出错,就先查对应规则,而不是重写整套路由。

私有地址直连 · 单条规则
{
  "type": "field",
  "ip": ["geoip:private"],
  "outboundTag": "direct"
}
域名策略示例

domainStrategy: AsIs 不为路由匹配额外解析域名。

Xray / V2Fly 双内核选型

双内核指这一生态中的两类选择,不表示每个客户端都能在应用内切换。安卓端 v2rayNG 使用 Xray,v2flyNG 使用 V2Fly;桌面端 v2rayN 管理多个内核选项,具体可用项取决于安装包。先对照服务端提供的协议、传输方式和安全设置,再选客户端。能导入只说明客户端读出了配置字段,不代表内核支持字段的组合。遇到只在某个客户端上连接失败的情况,先记录原有选项,用同一条配置做对照。

安卓端

v2rayNG → Xray
v2flyNG → V2Fly

桌面端对照配置字段

outbounds[].protocol 是协议;streamSettings.network 是传输方式。

TUN 与系统代理模式

桌面端先用系统代理验证浏览器:它通常只影响遵循系统代理设置的应用。如果目标软件不读取这项设置,再考虑 TUN,并先确认系统授权和现有虚拟网卡是否冲突。安卓端的 VPN 模式依赖系统授权,开启「分应用代理」后还要核对名单及排除方向。排查时只换一种接入方式,用同一个目标应用做对照。连接按钮亮起只表示服务已启动,目标应用是否真正进入代理,要用该应用的实际请求确认。

v2rayN 桌面入口系统代理 → 自动配置系统代理
v2rayNG 安卓入口设置 → 分应用代理

开源项目与维护

Project V 与内核家族

界面负责管理配置;内核负责建立连接并执行路由。遇到问题,先分清是哪一层。

查看项目介绍 阅读进阶手册

从 Project V 到 V2Fly、Xray

Project V 是围绕 V2Ray 形成的开源代理工具生态。它把协议、传输、路由等环节拆成可配置的部分,为图形客户端提供了可以调用的内核。V2Fly 社区延续了 V2Ray 的维护;Xray 从 V2Ray 代码分支发展而来,形成了独立的维护路线。配置字段看起来相似,不能据此认定两边实现完全一致。阅读教程时,先看示例用的是哪个内核,再看其中的字段是不是当前客户端实际会生成或读取的字段。

三个客户端各负责什么

v2rayN 是桌面端开源图形客户端,管理订阅、内核和本机代理入口。v2rayNG 是安卓端开源图形客户端,使用 Xray,并通过系统的 VPN 服务接入流量。v2flyNG 也是安卓端开源图形客户端,使用 V2Fly,适合已确认需要该内核的配置。客户端名称决定界面和安装方式,但不能单凭名称判断一条配置是否适用:协议、传输参数和服务端要求仍要对得上。对照教程截图时,也应区分主界面、订阅编辑页和运行设置页。

开源许可说明什么

V2Fly 的 V2Ray 核心使用 MIT 许可,Xray 核心使用 MPL 2.0。前者允许在保留相关声明等条件下复用代码;后者对受该许可约束的文件,在分发修改后的软件时有相应的源码可用性要求。内核、客户端及其依赖可能各自采用不同许可,不能把内核许可直接套到整个安装包。普通用户可以据此区分使用软件和再分发代码这两件事;需要修改或分发时,应阅读对应项目的许可文本。

更新时分别看客户端、内核和规则

客户端更新可能调整菜单或配置保存方式,内核更新可能改变协议支持或参数校验,路由数据更新则可能改变某些目标的匹配结果。三者不一定同时更新。更新前记下常用分组和代理模式,并保存本地自定义规则;更新后先用原来能连通的一条配置验证,再启用分应用或自定义路由。如果只在更新后出错,记录最近变动的是哪一项。把内核、规则和代理模式同时改掉,会让前后的结果失去可比性。

用现象区分故障层级

订阅更新失败,先看客户端能否取回订阅;条目已导入却无法启动,先看内核报错;内核启动后只有一个应用连不上,先看这个应用是否进入了代理。最后一种情况还可以换一个遵循系统代理的应用做对照,避免把应用自己的网络设置误判成服务端故障。反馈时描述操作顺序、出错位置和报错原文即可。贴日志前先删去订阅地址、访问凭据和可识别账户的信息。

配置常见问题

分不清菜单里的名词,可先对照 V2Ray 术语表。

更新订阅会不会自动切换正在使用的配置?

先把更新列表和选择配置当成两步。刷新后回到主界面检查当前条目;如果原条目被移除或名称改变,重新选择后再测试。列表里出现新条目,不代表当前会话已切换。

分应用代理和路由分流应该先看哪一个?

先核对应用有没有进入代理,再看目标地址匹配了哪条路由。应用已经被名单排除时,修改域名和地址规则也不会改变该应用的流量去向。

真连接测试通过,为什么应用还是打不开?

测试只说明客户端在当时的条件下能够通过所测配置访问测试目标。用实际出问题的应用再测一次,确认它是否遵循系统代理、是否命中了不同路由,以及失败的域名能否解析。

手动添加的配置会随订阅迁移吗?

不会随订阅一起下发。订阅只提供该来源返回的条目,手动配置需要单独导出或重新导入。迁移时也要单独检查分组备注、自定义路由和系统授权。

客户端排查笔记

近期使用指南

先按现象选一篇:加载慢、连接后完全打不开、锁屏后才断开,三者的检查起点不同。

V2Ray 网速慢分层定位:节点负载、线路质量与本地设置三层排查法

速度慢不一定是节点的问题。本文把排查拆成节点、线路、本地三层,讲清怎样用真连接测试与对照实验缩小范围,再调整传输方式与分流规则。

适合能打开页面、但加载或下载明显变慢的情况。用同一设备和同一测试目标做对照,先分清是个别线路变慢,还是本地应用普遍受影响。

V2Ray 显示已连接却打不开网页:系统代理、路由与 DNS 逐项排查清单

客户端显示已连接,浏览器却一直转圈。按本地代理端口、系统代理状态、路由规则、DNS 解析、时间同步的顺序逐项检查,快速找出断在哪一环。

适合连接按钮已亮、请求却无法完成的情况。先从设备本身检查,不急着删除订阅;记下哪一步开始失败,再决定是否需要更换配置。

v2rayNG 耗电快、后台被杀:电池优化白名单与保活设置指南

v2rayNG 以 VPN 服务常驻后台,耗电高低取决于系统电池策略和客户端设置。本文讲清各厂商电池优化入口、自启动权限,以及降低唤醒频率的几项设置。

如果亮屏时正常、锁屏一段时间后断开,优先对照后台限制;如果连接稳定但耗电升高,先看系统电池用量和客户端唤醒频率,别把两种现象混查。

查看全部文章