Windows
适合常规桌面环境。v2rayN 提供桌面版与经典 WPF 版，可根据界面偏好和现有使用习惯选择。
前往下载
客户端入口与配置知识库
V2Ray官方下载站：v2rayN 客户端与配置文档
集中整理 四个平台客户端、订阅导入步骤与路由和 DNS 配置。页面按实际操作顺序组织，适合首次安装、迁移配置以及出现连接问题时逐项查阅。
永久免费
代码开源
中文文档
图形客户端
PLATFORMSWindows · macOS · Android · Linux
CLIENTSv2rayN · v2rayNG · v2flyNG
CORESXray · V2Fly
TOPICS订阅 · 路由 · DNS
按系统选择
四个平台的客户端入口
桌面平台以 v2rayN 为主，Android 可在 v2rayNG 与 v2flyNG 之间选择。安装包页会继续区分处理器架构和软件包格式，这里只负责把系统入口对应清楚。
macOS
v2rayN 提供 Apple Silicon 与 Intel 两类安装包。选择前先在系统信息中确认芯片类型，避免下载不匹配的架构。
前往下载Android
主流设备通常选择 arm64 架构。v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核，可按配置来源和内核需求决定。
前往下载Linux
v2rayN 提供 deb 与 rpm 软件包，并区分 x64、arm64 架构。先确认发行版的软件包体系，再选择对应处理器文件。
前往下载
配置重点
从订阅到路由的三个核心设置
客户端安装只是起点。日常使用中更容易影响结果的是订阅内容是否正确更新、路由规则是否按预期命中，以及域名解析是否与分流策略一致。
订阅管理
订阅更新设置
订阅链接用于向客户端提供服务器配置集合。导入后应先手动更新一次，确认客户端能够读取内容，再决定是否启用启动时更新。遇到更新失败时，优先检查链接是否完整、复制过程中是否混入空格、系统时间是否准确，以及当前网络能否访问订阅地址。不要反复删除全部配置，因为错误提示和更新时间是定位问题的重要线索。更新成功后，还应检查新增内容是否出现在正确的订阅分组内，避免把旧配置误认为本次更新结果。
查看订阅导入步骤 →订阅设置subscription
启动时更新订阅
更新时跳过不可用分组关闭
订阅分组按来源保存
路由分流
规则顺序与出口选择
路由规则决定连接应交给哪个出站处理。常见条件包括域名、IP、端口、网络类型以及 geosite、geoip 分类数据。多数配置按从上到下的顺序匹配，因此具体规则应放在宽泛规则之前；已经命中的连接通常不会继续检查后续条目。修改时先明确每条规则的目标出口，再检查是否存在覆盖范围更大的前置条件。建议每次只调整一组规则并保存原配置，这样出现访问差异时，可以根据改动范围快速回退和定位。
阅读 routing 字段说明 →路由规则routing.rules
domain:geosite:cn→ directip:geoip:private→ directnetwork:tcp,udp→ proxy
域名解析
DNS 服务器与分流关系
DNS 设置负责把域名转换为连接所需的地址，它与路由判断并不是完全独立的两部分。启用按域名分类的解析策略时，需要确认服务器条目的适用域名、查询顺序和预期地址范围。若浏览器能打开部分站点而另一些站点持续超时，应分别检查解析结果、路由命中和系统代理范围，不要只更换服务器地址。对于自定义配置，先保留一个结构简单、行为明确的默认解析项，再逐步添加 domains 或 expectIPs 条件，更容易判断问题来自哪一层。
阅读 dns 字段说明 →DNS 服务器dns.servers
1.1.1.1
8.8.8.8
域名条件与查询顺序应和路由目标一起检查。
快速上手
安装后按三步完成基础连接
先确认配置来源，再选择运行方式，最后用实际访问和客户端日志验证。按这个顺序操作，可以把安装问题、配置问题和系统代理问题分开处理。
-
01
导入订阅或单条配置
在客户端的订阅管理中添加完整链接，保存后执行一次手动更新。如果使用单条分享链接，则通过剪贴板导入并确认协议、地址、端口等字段已经被识别。导入完成不等于连接已经启用，应继续选择具体配置。
-
02
选择配置与系统代理模式
从列表中选择要使用的配置，启动核心后再根据需求开启系统代理。规则模式会按路由条件决定出口，全局模式通常把更大范围的连接交给代理。首次使用建议先保持默认路由，确认基础连接正常后再增加自定义分流。
-
03
验证连接与本地端口
检查客户端状态、核心日志和本地监听端口是否正常，再打开浏览器访问目标页面。若只有部分应用无法连接，需要确认这些应用是否遵循系统代理；若核心无法启动，则优先排查端口占用和配置字段格式。
生态与内核
Project V、V2Fly 与 Xray 的关系
V2Ray 通常被用作一组协议、传输、路由和代理能力的统称。Project V 早期形成了核心概念与配置结构，随后社区维护形成不同内核家族。V2Fly 延续并维护 v2ray-core 方向，Xray 则在兼容既有配置思路的同时扩展协议与传输能力。图形客户端位于内核之外，负责提供配置管理、订阅更新、系统代理切换和日志查看等操作界面。
内核负责连接与规则执行
内核读取配置文件，建立入站和出站连接，并执行 DNS、路由、传输与策略设置。VMess、VLESS、Trojan 等协议参数最终都由内核解析。配置是否可用，不只取决于客户端界面中是否出现条目，还取决于所选内核能否识别相应字段，以及传输层、安全层参数是否成组匹配。
客户端负责日常配置管理
v2rayN 面向 Windows、macOS 与 Linux 桌面环境，提供订阅分组、路由设置、系统代理和多内核管理界面。v2rayNG 面向 Android，通常配合 Xray 内核使用；v2flyNG 同样面向 Android，但以内置 V2Fly 内核作为另一种选择。三者都是开源客户端，功能边界和内核取向并不完全相同。
开源协议约束代码使用方式
开源意味着源代码可供审阅、学习和按许可证条件修改，不代表所有客户端、内核和第三方配置都采用同一种许可证。查看具体组件时，应区分图形客户端代码、内核代码、规则数据和发布文件，各自可能有不同的版权声明与再分发条件。普通使用者通常更需要关注维护状态、兼容范围和配置迁移说明。
更新分为客户端、内核与规则数据
客户端更新主要改变界面、配置管理和系统集成；内核更新可能影响协议支持、字段解析与运行行为；geosite、geoip 等规则数据更新则影响分类匹配结果。这三类内容不应混为同一件事。遇到更新后的差异时，应记录具体更换了哪一层，并查看原配置是否包含已经调整或弃用的字段。
常见问题精选
先判断问题发生在哪一层
多数故障可以按订阅、核心、系统代理、DNS 和路由五个层次拆开。下面列出首页最常见的判断入口，详细字段可继续查阅术语表和配置参考。
订阅更新失败先检查什么？
先确认链接首尾完整、没有空格，并查看客户端给出的错误信息。若订阅地址无法访问，调整路由或重复导入通常不会解决根因。
查看订阅相关术语 →开启系统代理后仍有应用直连？
部分应用不会读取系统代理设置，另一些应用可能使用独立代理或直连网络栈。应先确认应用行为，再检查客户端的本地监听端口。
查看连接验证步骤 →规则模式和全局模式有什么区别？
规则模式按域名、IP、端口等条件选择出口；全局模式通常把更大范围的连接交给同一出口。排查时可短暂对比两种模式，以判断问题是否来自路由规则。
查看路由与分流术语 →修改 DNS 后为什么需要重启核心？
运行中的核心已经载入当前配置，保存文件不一定会自动重建 DNS 组件。重启可以让新服务器、域名条件和查询顺序完整生效。
查看 DNS 配置字段 →
教程动态
近期配置与排查文章
文章区围绕具体错误现象和配置字段展开。每篇内容只处理一个明确主题，便于根据客户端提示、系统现象或配置段名称直接查找。
v2rayNG 耗电快怎么办：后台运行策略与省电设置逐项排查
从系统电池优化白名单、前台服务通知到分应用代理范围，逐项判断后台耗电来自持续连接、系统调度还是代理范围设置。
阅读全文V2Ray 自定义路由规则写法：domain、ip 与 geosite 匹配优先级详解
拆解 routing 规则中的三类常用匹配写法，说明规则自上而下的判断顺序，以及宽泛条件覆盖具体条件时的调整方法。
阅读全文V2Ray 订阅失效与解析失败排查：从链接格式到客户端设置逐步自查
按照链接格式、编码方式、访问环境、客户端解析和订阅分组的顺序，定位更新报错或导入后列表为空的具体环节。
阅读全文