Windows
选择 v2rayN。桌面版使用跨平台界面，经典 WPF 版保留熟悉的桌面操作方式；按使用习惯选择即可。安装后先导入订阅，再设置系统代理，便于区分安装问题与连接问题。
前往下载CLIENT / 按系统选择
V2Ray 客户端下载入口
桌面使用 v2rayN，Android 按内核需求选择客户端。
先确认操作系统与处理器架构，再进入对应平台下载。客户端负责管理配置和启动内核，实际连接还需要可用的服务器参数或订阅地址。已有订阅时也不要跳过架构选择：安装包能否运行，与订阅能否连接是两件独立的事。
macOS
使用 v2rayN，按 Apple Silicon 或 Intel 芯片选择安装包。可在“关于本机”查看芯片信息。首次启动如遇系统安全提示，先确认文件来源，再按系统设置中的提示处理。
前往下载Android
首选基于 Xray 的 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。主流手机通常选择 arm64；不确定架构时查看通用版说明。首次连接需确认系统 VPN 授权，后台断连再检查电池限制。
前往下载Linux
使用 v2rayN 的 deb 或 rpm 安装包，结合发行版与处理器架构选择。桌面环境的代理设置不一定被终端程序读取；先在浏览器验证，再单独检查命令行工具的代理环境变量。
前往下载更换平台不等于更换协议。是否可用仍取决于客户端内核、服务端配置与传输参数是否匹配。
查看全部客户端 →CONFIGURATION / 配置关系
订阅、路由与代理模式
先分清每个设置控制哪一层，再修改参数。以下是局部配置示例，不是可直接连接的完整文件。
导入配置不等于启用代理
在订阅管理中添加可信来源的地址，保存后执行更新，再从列表选择服务器。订阅只负责批量提供配置，不会替代系统代理或 VPN 授权。相比逐条粘贴分享链接，订阅更适合集中更新，但也可能覆盖来源管理的条目。首次使用先保留默认分组，确认更新成功后再整理名称；不要把带访问凭据的订阅地址放进公开截图。右侧是本地入站片段，用来说明配置导入后仍需要流量入口，并非订阅文件格式。
操作顺序：添加订阅 → 更新 → 选择服务器 → 启用代理。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"udp": true
}
}
]
}规则按顺序决定出站
先使用客户端提供的路由预设，确认连接正常后，再为局域网、指定域名或应用需求增加规则。路由匹配通常从上到下进行，较具体的条件应放在宽泛规则之前。相比只切换全局模式，分流可以保留本地资源的直接访问，但需要检查出站标签是否存在。右侧片段将私有地址交给名为 direct 的出站；实际配置还需定义该出站并准备对应规则资源。新增规则后重载内核，用一个明确的目标验证结果。
先验证单条规则，再扩大匹配范围。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}按应用行为选择接管方式
浏览器等遵循系统代理的应用，可先使用自动配置系统代理；不读取该设置的程序，需要单独指定代理或使用 TUN。TUN 通过虚拟网卡接管流量，涉及权限、路由与 DNS，不能理解为速度增强开关。相比只改系统代理，它的覆盖范围更广，也更需要避免与其他网络工具冲突。初次配置不要同时启用多套接管方案。右侧是本地 HTTP 代理入口示例，端口必须与应用填写的值一致，具体值以客户端设置为准。
先用系统代理验证，再按需求启用 TUN。
{
"inbounds": [
{
"tag": "http-in",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
]
}按协议能力选择内核
先查看服务器要求的协议、传输与安全参数，再判断内核是否支持。v2rayN 可以管理不同内核配置，Android 则可在 v2rayNG 与 v2flyNG 之间按需求选择。相比只看客户端名称，检查实际运行的内核更能解释兼容性问题。切换前保存可用配置，切换后查看启动日志，确认字段被正确识别。两类内核存在共同语法，但扩展功能不能默认互通。右侧 freedom 出站是基础示例，不代表所有配置都能原样迁移。
协议兼容优先于界面习惯，不按名称判断性能。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}解析路径要与路由配合
先确认域名解析由系统、浏览器还是内核处理，再决定是否修改 DNS。浏览器的独立加密解析可能绕过系统设置，TUN 场景也可能使用另一条解析路径。相比只替换一个服务器地址，检查解析请求如何到达上游更有助于定位问题。右侧展示内核 DNS 的 servers 数组；使用远程解析服务时，还需确保其连接路径可达。若直接访问地址正常、域名访问失败，应优先检查解析结果与日志，不要同时改动路由和传输参数。
一次调整一条解析路径，保留可恢复的设置。
{
"dns": {
"servers": [
"https://1.1.1.1/dns-query",
"localhost"
],
"queryStrategy": "UseIP"
}
}安装后的操作顺序
v2rayN 快速上手：三步验证连接
先跑通最小配置，再添加分流、TUN 与个性化规则。
不同客户端的菜单名称可能略有差别，但配置逻辑一致：先让客户端获得服务器参数，再让应用把请求交给客户端，最后确认请求实际经过预期的出站。把这三层分开，出现问题时就能知道该检查订阅、系统设置还是路由，而不是反复重装软件。
导入订阅，选定一个服务器
准备来自可信来源的订阅地址，在 v2rayN 的订阅管理中添加分组并保存，然后执行更新。Android 用户可在 v2rayNG 的订阅分组设置中完成同类操作。更新后应能看到配置条目；若列表为空，先检查地址是否完整、订阅是否有效，以及更新日志是否提示格式或网络错误。
选中一个条目作为活动服务器，不要只停留在“已导入”的状态。协议、传输方式、端口及安全参数必须与服务端匹配，不能凭名称自行替换。订阅更新可能改变原有条目，建议先记下当前活动分组，后续排查时也能确认使用的是哪一份配置。
启用代理，保留默认路由预设
桌面端先启动内核，再选择自动配置系统代理，使用浏览器进行首次测试。已有代理扩展时，检查它是否接管了浏览器设置；同时运行其他代理程序，也可能使系统代理指向错误端口。Android 首次连接需要接受系统 VPN 授权，这与订阅是否导入成功没有直接关系。
初次使用先选择适合当前需求的路由预设，避免同时修改 DNS、出站规则与 TUN。需要接管不遵循系统代理的应用时，再阅读平台对应的 TUN 配置说明。退出客户端前清除不再使用的系统代理，防止应用继续向已关闭的本地端口发送请求。
验证网页，再检查具体应用
打开一个预期应通过代理访问的网页，并查看客户端日志中的连接与出站信息。能打开某个网页，只能说明该次请求成功，不能证明所有应用都在使用代理。终端工具、浏览器和桌面应用可能各自拥有独立设置，应按实际需要逐个验证。
若显示已连接却无法访问，依次检查服务器可用性、设备时间、DNS 解析、路由命中和本地端口。先记下错误文本，再修改一个变量，测试后决定保留或恢复。连接状态通常只表示内核或网络接管已经启动，不等于远端服务必然可用。
客户端、内核与开源许可
Project V、V2Fly 与 Xray 的关系
界面负责管理，内核负责处理连接，协议定义通信方式。
V2Ray 源于 Project V 的模块化代理工具体系，配置中常见的入站、出站、路由与 DNS，分别承担流量入口、连接出口、选择规则与域名解析等职责。日常所说的“V2Ray 客户端”经常是一个泛称：它可能指内核，也可能指带有图形界面的管理程序。下载前先分清两者，才能理解为什么同一份订阅可以被不同客户端读取，却未必能在所有内核上获得完全相同的行为。
内核家族：共同基础与独立演进
V2Fly 社区延续 V2Ray 核心的开发与维护，Xray 则在相关技术基础上独立演进。二者都采用配置驱动的代理架构，但功能扩展、字段支持与更新节奏并不完全相同。VMess、VLESS、Trojan 和 Shadowsocks 是协议名称；TLS、传输层与路由策略属于不同维度。看到一个熟悉的协议名称，并不能省略对传输方式和安全参数的检查，更不能把所有以 V2Ray 命名的程序视为同一个软件。
选择内核时，先根据服务器提供的完整参数确认兼容性，再考虑客户端是否便于管理。若导入后出现“不支持的协议”或配置字段错误，应先查看实际运行的内核与对应功能说明，而不是反复更换系统代理模式。系统代理决定请求如何进入客户端，内核兼容性决定进入之后能否正确建立远端连接，这两类问题需要分开处理。
三款客户端：桌面管理与移动端取舍
v2rayN 面向桌面平台，提供订阅分组、服务器选择、路由管理与内核配置等图形操作入口，适合需要在多个桌面环境保持相近使用逻辑的用户。v2rayNG 面向 Android，围绕 Xray 内核提供移动端代理管理；v2flyNG 同样面向 Android，作为 V2Fly 内核方向的备选。桌面端与移动端的网络权限机制不同，教程中的设置目标可以对应，按钮位置和授权流程却不应机械照搬。
三款客户端均以开源方式提供代码，客户端界面与所使用的内核仍是不同项目。更换客户端不会自动修复订阅中失效的服务器，也不会自动获得另一内核的全部扩展能力。已有可用配置时，优先选择能正确解释它的客户端；需要迁移时，先导出或记录自定义规则，再检查订阅、代理模式与 DNS 是否都已恢复。
开源许可：区分界面与依赖组件
v2rayN 与 v2rayNG 的开源许可属于 GPL 系列，v2flyNG 使用 GPL 许可；V2Fly 核心采用 MIT 许可，Xray 核心采用 MPL 2.0 许可。软件还可能组合其他独立授权的依赖组件，具体权利与义务应以所取得发行包中的许可证文本为准。开源意味着代码可按相应许可查看、使用和再分发，并不意味着所有网络服务、服务器资源或第三方订阅都由客户端项目提供。
对普通使用者，更实用的习惯是理解配置的边界：客户端可以保存服务器凭据和订阅访问地址，分享截图或日志前应移除这些敏感内容。日志通常足以帮助判断握手、解析或端口错误，不需要连同整份订阅一起公开。需要认识 UUID、出站标签、域名策略等词语时，可先查阅术语手册，再决定是否调整相关字段。
更新机制：分别检查程序、内核与规则
客户端更新、内核更新、订阅更新与规则资源更新解决的是不同问题。客户端更新可能改变界面或配置生成方式；内核更新影响协议与运行能力；订阅更新同步服务器参数；规则资源更新改变域名和地址集合。遇到问题先确认哪一层发生变化，再选择处理方式，不要把“更新订阅”当作所有故障的统一解决办法。
更新前保存自定义路由与重要设置，更新后确认活动服务器、代理模式和本地端口。若需要判断新配置是否可靠，应在同一网络、同一应用和同一目标下复测，减少环境变化带来的干扰。网站提供的是客户端选择与配置说明，具体功能以当前安装的程序为准；需要逐平台操作细节时，继续阅读全平台安装配置文档。
按问题继续阅读
不确定客户端差别，先看对比；已经安装但连接失败，直接进入配置文档。把术语、操作步骤与故障现象对应起来，通常比连续尝试多个开关更有效。
选型与故障排查
V2Ray 配置专题文章
基础配置跑通后，再根据实际问题阅读专题。浏览器与终端的代理行为、Android 的后台限制、客户端与内核的区别，分别对应不同的排查入口，不需要为了单个故障重新学习整套配置。
v2rayN 系统代理不生效：浏览器与命令行终端分开排查的方法
浏览器不走代理时检查扩展与代理模式，终端不走代理时检查环境变量与端口设置，并说明何时应改用 TUN 模式统一接管流量。
v2rayNG 安卓设置要点：VPN 授权、电池优化白名单与分应用代理
讲清 v2rayNG 基于 VpnService 的工作方式，演示如何加入省电白名单防止后台断连，以及如何用分应用代理只让指定应用走代理。
v2rayN、v2rayNG、v2flyNG 怎么选：三款 V2Ray 客户端的内核与平台差异
对比三款客户端的适用平台、内置内核、订阅与路由能力和界面习惯，说明桌面端为何首推 v2rayN，以及安卓端两款客户端的取舍。