platform.outbounds

按设备选择客户端

平台决定安装包类型，节点协议决定内核能力。先选设备，再确认订阅中的协议是否需要 Xray 或 V2Fly；下载页会继续给出架构、芯片和安装格式的选择说明。

桌面首选

Windows · v2rayN

适合需要完整系统代理、订阅分组、路由规则与日志排查的桌面用户。下载页提供新一代跨平台界面与经典 WPF 界面两种入口；常规新设备可先使用桌面版，已有成熟配置流程的用户可继续选择熟悉的界面。

前往下载

桌面客户端

macOS · v2rayN

桌面端沿用 v2rayN 的配置逻辑，可管理订阅、出站与分流规则。下载前需要查看设备芯片类型：Apple Silicon 设备选择 arm64 安装包，Intel 设备选择 x64 安装包。芯片类型可在系统信息页面确认，不应只按购买年份猜测。

前往下载

移动端首选

Android · v2rayNG

v2rayNG 采用 Xray 内核，适合包含 VLESS、REALITY 等 Xray 能力需求的订阅，也是多数移动设备的直接选择。常见新设备优先选 arm64 包；无法确认处理器架构，或需要更宽架构兼容范围时，可转到下载页选择通用包。

前往下载

软件包安装

Linux · v2rayN

适合希望通过图形界面管理订阅、系统代理与路由规则的桌面发行版用户。安装格式应跟随发行版的软件包体系：Debian、Ubuntu 系通常使用 deb，Fedora、Rocky Linux 等系统通常使用 rpm，同时还要区分 x64 与 arm64 架构。

前往下载

查看全部客户端 →

routing.console

规则清单与配置面板

V2Ray 客户端的关键能力不止是连接节点。订阅、内核、DNS 与路由共同决定连接结果；以下配置面板按问题类型拆开说明，并给出可以直接理解的设置片段。

JSON 配置视图 config/routing

代理 · 直连 · 拦截

路由规则按顺序命中

路由配置把不同流量交给不同出站：需要代理的域名进入代理出站，本地网络与指定地址范围走直连，明确不需要访问的类别进入拦截出站。规则从上到下检查，命中后停止继续匹配，因此更具体的规则通常放在前面，范围较宽的兜底规则放在后面。与只提供全局开关的简单工具相比，V2Ray 的规则对象还能组合域名、地址、端口、网络类型和入站标签，适合把使用场景写成可维护的清单。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

调整规则后应先检查标签是否与 outbounds 中的出站名称一致，再观察客户端日志中的实际命中结果。

节点清单

订阅地址与分享链接分开管理

订阅地址指向一份可更新的节点清单，一条 vmess:// 或 vless:// 分享链接通常只描述单个节点。客户端导入订阅后，应先执行更新，再从对应分组中选择节点；直接导入分享链接则不会自动形成可持续更新的订阅源。将不同来源放进独立分组，有助于识别更新失败来自哪个地址，也能避免同名节点混在一起。更新前保留现有分组，更新成功后再做延迟测试或连通检查，排查路径会更清楚。

订阅分组
├─ 工作配置
│  ├─ 手动更新
│  └─ 自动更新
└─ 临时分享
   └─ 单节点导入

订阅内容由服务提供方生成。客户端负责读取、更新和展示，不会把一条单节点链接自动转换成远端订阅。

Xray · V2Fly

协议能力决定内核选择

v2rayN 是桌面图形客户端，可配合其支持的内核管理多类节点；v2rayNG 采用 Xray 内核，v2flyNG 则面向 V2Fly 内核路线。选择时不必先比较界面细节，而应先查看节点使用的协议、传输方式与安全参数。需要 REALITY 等 Xray 扩展能力时，应选择相应内核；使用 V2Fly 支持范围内的标准配置时，也可以采用 V2Fly 路线。客户端只是配置入口，真正解释协议字段并建立连接的是内核。

选择顺序
1. 查看节点协议与安全参数
2. 确认内核支持范围
3. 选择对应图形客户端
4. 导入后检查日志

内核与客户端应分别判断。客户端名称相近，不代表其内部使用同一条内核维护路线。

解析策略

DNS 与路由匹配保持一致

连接显示成功但网页无法打开时，DNS 是需要检查的环节之一。路由规则可能直接按域名匹配，也可能在未命中域名规则后解析为地址再继续判断；此过程由 domainStrategy 等设置参与控制。DNS 服务器、查询路径和路由策略彼此冲突时，可能出现域名解析成功但出站选择不符合预期，或者日志中持续出现解析失败。排查时应先使用简洁配置确认基本连接，再逐项恢复自定义 DNS 与复杂规则。

{
  "dns": {
    "servers": [
      "localhost"
    ]
  },
  "routing": {
    "domainStrategy": "IPIfNonMatch"
  }
}

DNS 设置不应脱离系统网络环境单独判断。先确认系统时间、基础网络和节点状态，再检查解析策略。

setup.sequence

三步完成基础连接

首次配置不要同时修改大量高级选项。先完成订阅导入与基础连接，再根据实际需求增加路由和 DNS 规则；这样每次变化都能对应到明确结果。

查看完整教程 →

01

导入订阅或分享链接

复制完整订阅地址，在客户端的订阅分组中新增来源并执行更新。若拿到的是单条 vmess:// 或 vless:// 链接，应使用“从剪贴板导入”一类入口。导入完成后先确认列表中出现节点名称、协议和地址信息；如果列表为空，优先检查复制内容是否完整、订阅是否仍可访问，以及更新过程是否产生错误提示。
02

选择节点与代理模式

从订阅分组中选择一个节点，再启用客户端提供的系统代理或对应连接模式。初次测试建议使用较简单的规则集，避免自定义拦截、复杂 DNS 与多级出站同时影响结果。节点可用性与网络环境会变化，延迟数值只能作为参考；真正的判断依据是目标连接能否建立，以及日志是否出现握手、解析或路由错误。
03

验证连接并逐项加规则

基础连接建立后，分别测试常用网页、直连地址和需要特定出站的目标，确认代理与直连路径都符合预期。随后再添加私有地址直连、特定域名代理等规则，每次只改动一组设置并保存可回退的配置。出现异常时按“节点、DNS、路由、系统代理”的顺序检查，比反复重装客户端更容易定位原因。

project.v / ecosystem

Project V、内核与客户端的关系

理解生态分层，比只记住一个客户端名称更重要。配置是否可用，取决于图形客户端、内核、协议字段和订阅内容能否正确配合。

Project V 协议与代理工具生态

内核家族

V2Fly

V2Fly 延续 Project V 的社区维护路线，负责解释配置、实现协议与处理入站、出站、DNS、路由等底层能力。配置文件中的 inbounds、outbounds、routing 与 dns 等对象属于内核层概念，不等同于某个图形客户端的界面选项。

内核家族

Xray

Xray 从相近生态基础上发展出独立维护路线，并扩展了 VLESS、REALITY 等能力。订阅节点如果包含特定扩展字段，需要由支持这些字段的内核解释。选择 Xray 的核心理由应是协议与配置能力匹配，而不是把所有客户端名称当成同一种实现。

生态历史：从核心能力到图形界面

Project V 最初形成的是协议实现、配置结构与代理能力集合。随着桌面和移动使用需求增加，社区围绕不同系统制作了图形客户端。图形客户端负责订阅管理、节点选择、系统代理、日志展示与配置编辑，内核负责建立连接、执行路由并处理协议细节。两者分层后，界面可以根据平台习惯演进，底层能力也能沿各自维护路线持续更新。

因此，“V2Ray 客户端”通常是一个生态称呼，而不是单一安装程序。v2rayN 面向桌面系统，v2rayNG 与 v2flyNG 面向 Android；它们的界面、内核路线和适用场景并不完全相同。下载前先明确设备平台，再查看节点协议，可以减少因选错架构或内核造成的导入失败。

开源协议：代码、文档与变更可追踪

Project V 相关内核与客户端以开源方式维护，项目使用各自声明的开源许可证发布代码。开源许可证规定复制、修改、分发以及保留许可声明时需要遵守的条件。对普通使用者而言，重要事实是功能变化可以通过发布记录、文档与社区讨论被持续审阅；对二次开发者而言，则应在分发前阅读对应项目的许可证文本。

开源属性不等于所有客户端由同一团队、按同一节奏发布。v2rayN、v2rayNG、v2flyNG 分别维护自己的界面适配与发布过程，底层内核也有独立变更周期。遇到配置差异时，应先确认客户端名称、内核家族和协议参数，再阅读与当前组合对应的说明。

三款客户端：按平台与内核路线分工

v2rayN 是桌面端的主要图形客户端，覆盖 Windows、macOS 与 Linux，适合管理多个订阅、编辑路由、切换系统代理并查看运行日志。v2rayNG 是 Android 上常用的 Xray 路线客户端，适合需要 Xray 协议扩展能力的节点。v2flyNG 采用 V2Fly 内核，可作为 V2Fly 路线的移动端选择。

三者都围绕相近的节点配置与订阅使用场景，但不能仅凭名称推断功能完全一致。某些字段会受内核支持范围影响，某些操作则取决于系统权限和图形界面实现。最稳妥的选型顺序是：设备平台、节点协议、处理器架构、客户端界面，依次确认。