V2RAYN · V2RAYNG · V2FLYNG

V2Ray for Macv2rayN 下载与配置

按设备选择开源客户端,用中文教程完成订阅导入和路由分流。

Xray V2Fly JSON 配置
客户端索引按操作系统查找

V2Ray 客户端安装包

先看设备运行的系统,再核对处理器架构和安装包格式。应用能否在设备上安装,与内核能否执行订阅里的配置,是两件不同的事。第一次安装时先解决前者,导入节点后再核对协议和传输参数。

初次安装与迁移

如果是从旧设备迁移,不必先把每条自定义规则复制过去。可以先记录正在用的客户端、订阅来源、内核类型和生效的路由策略。在新设备导入一组节点,用一个已知可用的节点建立基线,再恢复其他规则。旧设备上的系统代理地址、端口和局域网访问设置,不一定适合新设备。

安装失败时,先看报错发生在哪一步:安装器无法打开,优先核对处理器和包格式;应用能打开但内核无法启动,先读启动日志;只有某个节点连不上,再检查该节点的协议和参数。这样可以避免把安装层的问题误当成订阅过期,也避免为修复一个节点而重装整个客户端。

查看全部客户端 →

配置顺序

从导入订阅到启用代理

先让内核跑通一个节点,再检查哪些应用把流量交给客户端。下面五步可单独查阅。右侧是字段或设置项示意,用于对照界面和阅读日志,不是可直接运行的完整配置。

保留订阅分组

把订阅地址填入单独的订阅分组,再手动更新一次。更新后先检查列表是否出现节点,并核对节点协议和备注。和从剪贴板导入单个节点不同,订阅分组记录的是后续更新来源,便于把服务方的变化与本地手工记录分开。如果列表为空,先查订阅地址、有效期和客户端可识别的返回格式,不必先改系统代理。订阅链接可能包含访问凭据,截图和求助时应遮去完整地址。

查看订阅导入步骤

订阅分组设置
更新当前订阅
从剪贴板导入批量 URL

项目关系与维护

Project V、V2Fly 与 Xray

下载页上的应用名、订阅里的协议名、日志中的内核名,指的是不同层。先分清这三层,才能判断应当换安装包、换内核,还是只改一项参数。本手册整理客户端入口和配置方法,客户端和内核的开发、发布分别由各项目维护者负责。

Project V 与 V2Ray 的由来

Project V 是代理工具生态的项目名,V2Ray 是其中用于处理连接和转发的核心程序。它把入站、出站和路由拆成不同的配置段:入站来接收连接,出站决定如何发出连接,路由在两者之间选择路径。图形客户端把常用部分整理成表单,也能根据当前节点和规则生成配置。因此,界面上看到的内容不一定与实际执行的配置逐字相同。

读旧教程时,先识别它描述的是界面操作还是内核字段。例如,教程让用户打开「系统代理」,这是把应用流量送到本机入口;配置里出现 routing.rules,则是内核收到流量后才会用到的规则。系统设置已经改好,不能证明某条分流规则命中;反过来,即使规则无误,也接不到从未走代理的应用流量。用这两处边界划分问题,比照着旧截图逐个勾选更可靠。

V2Fly 与 Xray 的分叉

V2Fly 社区延续了 V2Ray 的维护。Xray 从 V2Ray 代码分叉后独立演进,加入了 REALITY 和 XTLS Vision 等能力。两者保留了一些相似的配置结构,但同名字段、协议或传输方式并不保证互通。迁移时可先从服务端或订阅说明确认所需协议、传输和安全层,再读取客户端启动日志,确认运行的确实是支持该组合的内核。

协议决定连接双方如何交换数据,传输决定协议消息怎样承载,安全层则有自己的握手和身份验证要求。举例来说,看到节点使用 VLESS 并不能单独判定该选哪个客户端;还要看节点是否依赖特定的安全层或流控。若配置在启动前就被拒绝,先核对不被识别的字段。若配置通过而握手失败,回到服务端提供的参数逐项比对。两类报错都可能表现为连接失败,但处理方式不同。

三款开源客户端的分工

v2rayN 是开源桌面客户端,把订阅管理、节点选择和本地代理设置集中在同一界面。v2rayNG 是开源的移动端客户端,使用 Xray 内核;v2flyNG 同样开源,面向需要 V2Fly 内核的配置。开源许可证说明代码如何使用、修改和分发。阅读时应以对应项目和发布资料的许可证为准,不能把客户端的授权条款和内核或其他依赖的条款混为一谈。

更换应用前,先确认遇到的确实是内核差异。比如,电脑能连而手机只能在前台工作时,先检查系统的 VPN 授权及后台运行限制;同一设备只有个别域名失败时,先查解析和分流。换应用可能同时改变默认路由、端口或接管方式,如果不保留一组可重复的测试,无法判断恢复连接究竟是因为内核变了,还是因为原先的系统设置被重置了。

客户端、内核与规则的更新

客户端更新可能改变界面、打包方式或配置生成逻辑;内核更新可能改变字段支持、默认行为或日志内容;地理数据和站点规则更新则可能改变某条分流规则的匹配范围。三者并不一定同时发布。记录问题时,说明改动的是应用、内核、订阅还是规则数据,才能将新出现的现象与相应变更对照。

如果现有配置依赖自定义入站或路由,更新前应留一份本地备份,并记下平时用于验证的连接。更新后先检查能否启动,再检查本地监听、握手、域名解析与分流是否仍符合预期。特别是工作网络里的内部域名和必须直连的服务,不适合只用一次节点测速来代替端到端验证。需要对照字段层级时,可查阅 JSON 手册。

安装与连接常见问题

第一次配置时,先确定问题发生在哪一层。下面的问答可以作为检查顺序。

订阅导入成功,是否就能直接使用?

列表出现节点只说明客户端读取了订阅内容。选择节点后还要确认内核启动成功,并通过一个使用本地代理的应用发起请求。若客户端可以测速但浏览器没有流量记录,先核对浏览器是否采用了当前系统代理,不必重做订阅。若节点列表已经有内容但启动时出现字段错误,应回到内核兼容性检查,而非调整 DNS。查看导入与验证步骤。

系统代理和 V2Ray 全局代理是同一个开关吗?

不是。系统代理决定遵循它的应用访问哪个本地地址;全局路由通常决定进入内核的流量按怎样的出站策略处理。应用自行直连时,内核的全局规则不会收到该连接。查看代理接入方式。

已经能连接,为什么仍有个别域名打不开?

用同一应用对比一个可访问域名和一个失败域名,分别观察有没有解析结果、是否命中预期规则,以及选中的出站是否符合需求。测试时保留节点和网络环境,只调整一个设置。按教程逐项验证。

可否把旧设备的配置原样复制过来?

先迁移订阅和确实需要的规则,再按新环境核对内核、监听地址、端口和系统代理。不要把旧设备上的网卡、局域网地址或例外列表当成通用默认项。查看客户端配置顺序。

使用心得

内核选型与连接排查

按症状查阅:节点一启动就报错,先核对内核和字段;内核在运行但节点测速超时,再查连接条件;节点可以测速而网页仍打不开,优先确认应用是否把请求发到了本地代理。