v2rayN · v2rayNG · v2flyNG

v2rayN
下载与配置指南

按系统选客户端,用中文步骤导入订阅,再查路由分流与 DNS 配置;先连通,再逐项调整。

代码开源 图形界面 多内核配置
按设备系统选择入口

我的配置工作台

相关文档

V2Ray 客户端:按系统下载

桌面设备先看 v2rayN,安卓设备先看 v2rayNG;需要 V2Fly 内核时,再了解 v2flyNG。安装包取决于系统与处理器,连接方式取决于配置与内核。这两件事分开判断,就不容易选错。下载页集中列出具体入口与安装要求,首页只帮你确定方向。

客户端负责保存配置、启动内核和设置流量入口,不会凭空生成可用的远端服务。开始之前,你需要准备有权使用的订阅地址或服务器参数。已有旧配置时,先保留分组与自定义路由,再安装或迁移;第一次使用则先按教程完成单条连接验证,暂时不用同时开启所有高级选项。

Windows

v2rayN

桌面版采用跨平台界面,经典 WPF 版保留熟悉的操作布局。新安装可以先了解桌面版;已有使用习惯与配置时,先比较界面差异再决定。安装完成后,确认客户端能够正常启动内核,再导入订阅,别把程序启动成功直接当作代理已经生效。

macOS

v2rayN

先在系统的“关于本机”中确认芯片,再选 Apple Silicon 或 Intel 对应入口。导入订阅后,检查系统代理是否启用,以及浏览器是否沿用系统设置。需要 TUN 时再单独处理权限,首次连接不必把系统代理与虚拟网卡一起打开,避免出现难以分辨的变量。

Android

v2rayNG / v2flyNG

v2rayNG 使用 Xray 内核,v2flyNG 提供 V2Fly 内核方向的备选。多数较新的手机可先看 arm64,架构不确定时查设备信息或考虑通用包。首次连接需要确认系统的 VPN 授权;之后如果切到后台就断开,再检查电池优化、后台权限和其他占用 VPN 通道的应用。

Linux

v2rayN

按发行版的软件包体系选择 deb 或 rpm,再核对处理器架构。图形客户端的系统代理设置未必覆盖终端程序,每个应用是否读取代理都要分别确认。若浏览器能访问而命令行不能,先看该程序的代理设置与环境,而不是直接更换整套服务器配置。

v2rayN 能替你
管好哪几件事

先分清三层:应用把请求交给本地入口,内核根据规则选择出口,DNS 为需要的连接提供解析结果。客户端把这些配置集中到图形界面;遇到问题时,沿这条路径检查,比反复导入同一条订阅更有效。

订阅把多条服务器配置集中到一个更新入口。先建立分组,再粘贴你有权使用的地址,更新后确认列表实际出现了配置。普通更新失败时,可以在已有连接可用的前提下尝试通过代理更新。订阅地址可能包含访问凭据,不适合贴到截图或公开日志中。与逐条手动录入相比,分组更容易保留来源和更新边界;但自定义备注、排序与路由应单独备份,避免把远端更新误当作本地设置的永久存档。右侧示例仅展示 JSON 中保存 URL 的形式,不是客户端订阅文件格式。

{
  "url": "https://example.com/sub"
}

配置检查:按入口、规则、出口走一遍

如果订阅已更新却无法访问,先看是否选中了有效配置,再看内核启动日志。接着确认应用是否真的连接本地入站,最后检查路由选中的出口和域名解析。TCP 端口可达只说明握手有机会建立,不能代替完整协议连接;测试失败也可能是测试目标本身不可达。保留原始错误信息,比只记录“超时”更容易定位问题。

配置参考里的 JSON 用于解释字段之间的关系。客户端通常会根据界面设置生成运行配置,直接修改临时生成文件可能在下次启动时被覆盖。你要长期保留的规则,应放在客户端支持的自定义入口中,并在修改后检查生成结果。完整字段说明可从入站章节开始阅读;首次操作则沿着订阅导入教程继续。

Project V 生态
与客户端的分工

“V2Ray”在日常讨论中常被用作一个大类名称,但具体操作时,最好把项目生态、代理内核和图形客户端分开理解。Project V 提供了模块化代理工具的思路,入站接收请求,路由决定去向,出站执行连接。V2Fly 延续 V2Ray 的社区开发,Xray 则形成另一条内核分支。它们有共同的技术背景,也有各自演进的功能,不能把名称相近理解为配置始终通用。

客户端负责操作界面,内核负责处理连接。v2rayN 把订阅、服务器列表、系统代理与配置选项集中到桌面界面,再调用相应内核工作。v2rayNG 面向安卓设备,采用 Xray 内核;v2flyNG 则提供 V2Fly 内核路线。三款客户端都属于代码开源的软件项目。选择时先看设备,再看配置要求,没必要为了统一名称而在不同设备上强行追求完全相同的界面。

协议支持需要具体到特性。VMess、VLESS、Trojan 描述的是协议层面的选择,传输方式与 TLS、REALITY 等安全设置又是另外的维度。某条配置能否运行,取决于客户端能否正确导入、内核能否识别,以及服务端参数是否一致。看到“支持 VLESS”还不足以判断一条带特定传输与安全选项的配置是否兼容。遇到无法启动的情况,先看报错字段,再核对支持范围,比反复更换客户端更有针对性。

开源协议也要分项目看。v2rayN、v2rayNG 与 v2flyNG 采用 GPL 系列许可,V2Fly 与 Xray 内核项目采用 MPL 2.0。许可证说明源码使用、修改与分发的条件,并不等于远端服务的使用授权。你使用的订阅、服务器和网络仍有各自的管理边界。日常使用未必需要研究每条许可条款,但如果要重新分发、修改或集成代码,就应阅读相应项目的许可文本,而不是把“开源”简单理解为没有条件。

更新同样分层:客户端更新改变界面与集成功能,内核更新影响协议实现,订阅更新替换远端配置,规则数据库更新影响域名与 IP 集合。四种更新解决不同问题,不必在故障时一起执行。例如某个网站被错误分流,可以先检查规则顺序与数据库;若内核明确报告字段不受支持,再核对内核能力;如果只有一个订阅分组更新失败,则先检查地址、权限与更新路径。

保留能回退的配置,比追求一次设置到位更实际。调整前记下当前出站、路由模式、DNS 与代理入口,每次只改一组内容。确认浏览器访问正常后,再测需要使用的其他应用。对后台应用、游戏或命令行程序,不要默认它们都遵循系统代理;对 TUN,也不要默认开启后就覆盖了所有网络情形。流量入口、路由与解析都需要结合设备环境验证,界面上的开关状态只代表设置,不代表结果。

连接测试要读懂含义。TCPing 更接近端口连通性检查,真连接测试会继续涉及协议握手及测试目标。测试结果受到本地网络、服务端状态、解析与目标响应共同影响,单次成功不能代表所有应用都可用,单次失败也不能直接证明客户端有问题。你可以固定一套测试步骤:选中配置、启动内核、确认代理模式、访问预期目标,再对照日志检查。保持步骤一致,结果才有可比性。

这里的中文说明把“怎么操作”和“为什么这样配置”分开:教程讲安装后的连续步骤,配置参考解释字段和片段,疑难解答按症状收敛检查范围,技术笔记讨论某一项具体机制。本站是独立的客户端资料整理站,不是远端连接服务提供方。准备好你有权使用的配置后,可以先完成基础连接,再决定是否需要复杂分流;阅读顺序服务于眼前的问题,不必一次看完所有章节。

技术笔记:连接、内核与 DNS

基础连接完成以后,再按问题深入。下面三篇分别解释首次验证、内核选择和 FakeDNS,避免把不同层面的设置混在一起调整。