三款客户端的职责
v2rayN 是面向桌面系统的开源图形客户端，用于服务器管理、订阅分组、路由与代理方式设置。v2rayNG 面向 Android，使用 Xray 内核并对接系统 VPN 接口。v2flyNG 同样面向 Android，使用 V2Fly 内核，适合作为具有明确内核需求时的备选。它们都负责把用户操作转换为底层网络配置，而不是提供服务器服务。
客户端下载入口
v2rayNG 与 v2rayN 平台选择
Windowsv2rayN
桌面版使用跨平台界面，经典 WPF 版保留熟悉的操作布局。先按系统要求选择，再导入订阅分组；系统代理与 TUN 是不同的流量接管方式，不必同时开启。
x64 · Desktop / WPF前往下载 →
macOSv2rayN
在“关于本机”查看芯片：Apple Silicon 对应 arm64，Intel 对应 x64。安装后先用系统代理验证浏览器连接，再根据应用是否遵循系统代理决定是否配置 TUN。
arm64 / x64 · dmg前往下载 →
Androidv2rayNG / v2flyNG
优先使用 Xray 内核的 v2rayNG；需要 V2Fly 内核时再选择 v2flyNG。主流较新手机通常选 arm64，无法确认架构时选通用包。首次启动连接需要确认系统 VPN 授权。
arm64 / universal前往下载 →
Linuxv2rayN
按发行版的软件包格式选择 deb 或 rpm，再核对 x64 与 arm64。图形界面能启动并不代表所有程序都使用代理；终端程序、浏览器与桌面环境可能各自读取不同的代理设置。
x64 / arm64 · deb / rpm前往下载 →
安装包架构不匹配会导致无法安装或启动；订阅格式不匹配则通常表现为导入失败。先判断问题发生在哪一步，再调整对应设置，避免反复更换客户端。
查看全部客户端 →设置项与配置片段
Xray、订阅、路由与 DNS
先理解设置的作用范围，再修改参数。以下片段用于说明配置结构，不是可直接连接的完整配置；字段是否可用，以所选客户端和内核的实际支持为准。
Xray 内核与流量嗅探
v2rayNG 提供图形设置，Xray 负责实际处理连接。启用流量嗅探后，内核可从受支持的流量中识别域名，帮助域名路由匹配；它不等于解密应用内容。排查时先确认协议、传输和安全参数与服务器一致，再检查 Sniffing。Mux 是独立的多路复用选项，并非所有协议组合都适合开启；先保持关闭，建立可工作的基线，再按实际需求调整。
{
"sniffing": {
"enabled": true,
"destOverride": [
"http",
"tls"
],
"routeOnly": true
}
}订阅分组与更新范围
订阅地址用于获取一组连接配置，单节点分享链接只导入对应条目。在“订阅分组设置”中为不同来源分别命名，可以明确每次更新影响哪些服务器。修改订阅生成的条目后，后续更新可能覆盖本地修改，需要长期保留时应先复制为独立配置。首次导入失败时先检查地址是否完整、返回内容是否为兼容格式；更新是否通过代理应按当前网络条件选择，不要盲目重复更新全部分组。
订阅分组设置
├─ 分组名称：日常使用
├─ 订阅地址：使用实际获取的订阅地址
└─ 更新范围：当前分组
单节点导入
├─ vmess:// → 从剪贴板导入
└─ vless:// → 从剪贴板导入
说明：以上为操作路径，不是内核 JSON。按顺序匹配路由规则
路由决定连接使用哪个出站，不负责补齐服务器参数。规则通常按顺序匹配，具体例外应放在宽泛规则之前。示例将私有地址和境内域名交给 direct；实际使用前必须已有同名出站标签，并准备对应规则数据。IPIfNonMatch 表示域名规则未命中时，按需解析 IP 后继续判断，不表示所有域名都先解析。遇到规则不生效，依次检查规则顺序、域名识别和 outboundTag 拼写。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
},
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
]
}
}区分域名解析与连接出站
DNS 决定域名解析成什么地址，路由决定后续连接走哪里，两者需要一起检查。示例让 geosite:cn 使用境内解析器，其他查询使用另一解析器；这只是 servers 片段，还需保证 DNS 请求本身的路径可达。DoH 能加密解析传输，但不会自动修复错误路由。FakeDNS 使用虚拟地址映射，需要客户端流量接管与嗅探配合；首次配置先验证普通解析，再逐项启用额外选项。
{
"dns": {
"servers": [
{
"address": "223.5.5.5",
"domains": ["geosite:cn"],
"skipFallback": true
},
"1.1.1.1"
]
}
}限定 Android 应用接管范围
分应用代理先决定哪些应用进入 VPN，再由路由规则决定已进入的流量如何转发。“代理所选应用”适合只接管少量应用，“绕行所选应用”适合接管大部分应用并保留少数例外。两种模式对同一选择列表的含义相反，切换前应重新核对。更新应用列表或模式后，重启 VPN 连接使设置生效。若浏览器可用而某个应用不可用，先检查它是否进入接管范围，再排查 DNS 与协议。
模式：代理所选应用
选择列表：
浏览器应用
需要代理的业务应用
流量路径：
已选应用 → Android VPN → 内核路由
未选应用 → 系统原有网络路径
注意：应用选择属于客户端设置，
不是 routing.rules 的域名条件。系统代理、TUN 与 VPN 的边界
v2rayNG 的 VPN 模式通过 Android 系统接口接收流量；v2rayN 的系统代理主要影响遵循该设置的桌面应用。TUN 则通过虚拟网络接口扩大接管范围，可能需要额外权限和配套 DNS 设置，不能把它理解成“全局代理”的同义词。右侧仅展示本地 SOCKS 入站，不是 TUN 配置。初次使用先让一种接管方式工作，确认连接正常后再引入 TUN，避免多个代理工具同时修改路由。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}设置面板展示的是示例状态，不代表所有安装环境的默认值。完整规则、DNS 请求出站与自定义配置的组合方式，见进阶手册。
查看进阶配置 →首次连接操作顺序
安装、导入、验证
先建立一条参数明确、结果可复现的连接。首次设置时不要同时修改路由、DNS、多路复用与应用范围，否则出现问题后很难定位原因。
-
安装客户端并准备连接资料
按操作系统和处理器架构选择安装包。安卓端安装 v2rayNG 后，先打开设置查看 VPN 模式、路由和 DNS 选项；桌面端安装 v2rayN 后，先确认界面能正常启动。系统提示权限时，阅读用途再决定是否授权，只有采用相应接管方式时才需要对应权限。
安装客户端本身不会生成可用服务器。继续操作前，准备已有的订阅地址、分享链接或完整服务器参数。订阅地址可能包含访问凭据，不应发到公开讨论区；需要他人协助时，只提供删除认证信息后的错误描述和设置截图。
-
导入配置并选择活动服务器
单节点链接使用“从剪贴板导入”或扫描二维码；订阅地址则进入“订阅分组设置”，保存后执行该分组的更新。两者不要混用。导入完成后，检查服务器地址、端口、协议、传输方式和 TLS 或 REALITY 参数是否齐全，再选择一个条目作为活动服务器。
先使用客户端现有的常规路由方案，不急于添加复杂规则。安卓端点击连接并确认 VPN 授权；桌面端启动内核后，选择需要的系统代理方式。若订阅更新为空，先确认返回内容是否为订阅而非登录页面；不要把导入失败直接判断为服务器离线。
-
验证实际请求，再调整分流
打开浏览器访问日常使用的网站，结合客户端日志确认请求是否进入内核。TCPing 只说明目标端口的连接情况，真连接延迟更接近一次经代理的请求，但两者都不能单独代表所有应用的可用性。验证时还要检查 DNS 解析、网页加载和目标应用是否正常。
连接异常时，按“客户端是否运行、流量是否进入、服务器是否可达、域名是否解析、路由是否命中”的顺序检查。保留一套已验证的基础配置，每次只修改一项并重新测试。确认基础链路正常后，再配置分应用代理、自定义路由或 TUN，便于随时回退。
开源项目与维护边界
Project V、V2Fly 与 Xray
内核处理网络连接，客户端组织设置和系统接入。理解这两层，才能判断问题应通过修改参数、更新客户端还是调整系统权限来解决。
从协议能力到图形界面
Project V 是以 V2Ray 为代表的网络代理工具生态。它把入站、出站、路由、DNS 和传输配置拆成不同部分，允许按实际网络需求组合。V2Fly 延续 V2Ray 的社区维护，Xray 则是相关生态中独立演进的内核项目。两者共享部分配置概念，但支持的特性和参数细节并不始终相同。
VMess、VLESS、Trojan 和 Shadowsocks 是连接协议；TCP、WebSocket、gRPC 等属于传输层选择；TLS 与 REALITY 涉及连接安全机制。这些名称处于不同层次，不能任意互相替换。复制一条 VLESS 分享链接后，也仍需检查其中的传输与安全参数，不能只凭协议名称判断兼容性。
Project V 生态V2Fly 内核Xray 内核图形客户端
开源协议与使用成本
三款客户端均为免费使用的开源软件。客户端项目与所集成内核分别遵循各自许可证，修改、再分发时应阅读随软件提供的许可说明，不能把某个组件的许可条件直接套用到全部依赖。客户端免费与服务器资源是否收费是两件事，订阅有效期、流量额度及连接质量也不由客户端决定。
客户端更新与订阅更新
更新客户端会改变界面、功能或随附内核；更新订阅则刷新服务器配置，两种操作不能互相代替。服务器更换了认证或传输参数时，应先更新对应订阅。某项新功能无法识别时，再核对客户端与内核的支持情况。更新前保存必要的自定义规则，更新后检查日志和既有连接，不要只确认程序能打开。
本地配置与远端服务的边界
路由规则、DNS 地址和分应用列表主要影响本机如何处理流量；远端服务器的可达性、证书和认证由服务端配置决定。客户端显示已启动，只能说明本地服务进入运行状态，并不保证远端连接成功。遇到超时、认证失败或解析错误，应保留错误类型和发生时机，再沿对应链路检查，避免把所有问题都归结为代理模式。
技术笔记
延迟测试、入门排查与界面说明
按当前问题选择阅读入口：测试数字之间的差异、首次配置的常见卡点，以及桌面客户端主要功能区的用途。
v2rayNG 延迟测试怎么看：TCPing、真连接延迟与下载测速的区别
解释 TCPing、真连接延迟与下载测速各自测的是哪一段链路，说明数值为何互相矛盾，以及挑选节点时该优先参考哪一项。
阅读测试说明 →V2Ray 新手常见问题十问：导入失败、无法联网、代理模式选择一次讲清
汇总新手最常卡住的十个问题，覆盖订阅导入失败、连上却打不开网页、全局与规则模式选择、开机自启等情况，并给出快速判断方法。
阅读排查步骤 →v2rayN 主界面功能速览：服务器列表、订阅分组、日志窗口与参数设置
按区块走一遍 v2rayN 主窗口：服务器列表操作、订阅分组切换、日志排查入口、参数设置与系统代理开关的位置和用途。
阅读界面说明 →需要直接开始配置，可先阅读入门指南；已经能够连接，再继续查阅路由与 DNS 的进阶说明。
查看全部文章 →