客户端负责整理配置，内核负责执行连接。先把订阅、节点与代理模式分清，再处理路由和规则集。下面的大纲按常用设置排列，选择一个主题即可查看操作要点。
订阅分组
备注：日常使用
地址：由订阅提供方获取
操作：更新当前订阅
节点列表
操作：设为活动服务器订阅是更新节点信息的入口，不是连接开关。在 v2rayN 的订阅分组中填写地址和备注，保存后更新该分组，再从节点列表选择活动服务器。v2rayNG 也需要先添加订阅再执行更新。二维码适合临时传递单个节点，长期维护更适合使用订阅分组。更新失败时先检查地址、订阅有效期和更新时的网络路径，不要连续创建相同分组。分享截图前遮住完整订阅地址，它可能包含访问凭据。
订阅更新后，仍需确认活动节点。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}路由按域名、目标地址等条件选择出站，规则通常从上到下匹配。局域网地址可以直连，需要代理的目标走代理，明确要拒绝的目标交给阻断出站。先放具体条件，再放宽泛条件，避免一条规则提前接住所有流量。示意中的 direct、proxy、block 是出站标签，必须与实际配置一致。图形客户端可以生成这些设置，初次使用先选择合适的路由预设，再用连接日志确认命中结果，逐条调整。
分流问题先看顺序，再看条件。
配置核对顺序
节点协议
传输方式
TLS / REALITY 参数
当前内核支持情况
启动日志v2rayN 的图形界面与代理内核承担不同工作，多内核支持让桌面端可以按节点要求选择兼容实现。切换前先核对协议、传输与安全参数，不能只凭节点名称判断。v2rayNG 以 Xray 内核为主，v2flyNG 属于 V2Fly 内核路线，二者不是简单换一个界面的关系。导入成功仅说明客户端读到了信息，不代表当前内核能执行全部参数。若启动失败，优先阅读首条配置错误，再考虑兼容性调整。
按节点能力选内核，不按名称猜。
应用连接路径
遵循系统代理 → 本地代理入口
手动代理设置 → 核对地址与端口
TUN 虚拟网卡 → 核对权限与路由
Android VPN → 核对应用分流系统代理向遵循该设置的应用提供代理地址，并不会自动接管所有程序。浏览器正常而其他应用不通时，应先检查应用自己的代理选项。TUN 通过虚拟网卡处理流量，覆盖方式不同，也涉及权限、路由和 DNS。先用系统代理建立可用基线，再按实际需求启用 TUN，避免同时修改多个入口。Android 客户端使用系统 VPN 接口接入流量，切换客户端前应停用另一项 VPN 连接。
代理入口与路由模式需要分别确认。
规则引用与数据
geosite:cn 域名分类
geosite:category-ads-all 域名分类
geoip:private 地址分类
更新后
重新加载配置 → 检查日志geosite 与 geoip 表达的是数据分类，不是写上名称就能自动得到完整规则。内核需要对应的数据文件，配置中的分类也必须实际存在。更新订阅主要刷新节点，规则数据通常要从客户端提供的独立入口更新。若日志提示分类不存在，先检查数据来源与当前内核是否匹配，再处理下载失败。调整前记录原来的路由方案，更新后重新加载并测试常用目标，以免把数据问题误判为节点故障。
订阅更新与规则更新是两件事。
第一次打开客户端，不必同时改订阅、路由、DNS 和 TUN。先导入一个已知有效的节点，设为活动服务器，使用系统代理验证浏览器连接。确认这一条路径能工作后，再调整分流规则。这样每次出现变化，都能对应到最近修改的设置；否则多个选项一起变化，很难判断是哪一层出了问题。
测试也要区分本地入口、远端连接和目标站点。节点测试有结果，只能说明某个测试目标在当时有响应，不能证明所有应用都已经使用代理。浏览器能访问目标，也不能证明规则里的每一类域名都走了预期出站。需要时查看日志中的目标、出站标签和错误类型，记录现象而不是反复重装。完整步骤见v2rayN 使用教程，按症状检查见故障排查大全。
桌面设备选择 v2rayN，安卓设备优先查看 v2rayNG，已有 V2Fly 配置需求时再考虑 v2flyNG。安装包要同时匹配系统与处理器架构；进入下载页后可查看对应入口和系统要求。
Windows 上的 v2rayN 提供新一代跨平台桌面界面与经典 WPF 界面。两种入口服务于不同界面习惯，选定一种后先完成基础配置，不必为了连接问题来回换界面。安装前查看系统信息中的处理器类型，不能把其他架构的安装包当成通用包。首次启动如果没有出现主窗口，先检查系统提示、运行环境与客户端日志，再进入代理设置。
macOS 上先在系统的“关于本机”中查看芯片信息，Apple Silicon 与 Intel 使用不同入口。安装后先确认客户端能正常启动，再按系统提示处理所需权限。不要把授权失败、内核启动失败和节点连接失败混成一个问题。切换系统代理时，还要留意浏览器是否使用了自己的代理配置；它可能覆盖系统设置，让实际连接路径与客户端显示的模式不同。
Android 优先选择 v2rayNG。多数较新的设备适合 arm64 包，无法确认处理器架构时可查看通用版入口。首次连接会出现系统 VPN 授权提示，授权后客户端才能接入应用流量。若锁屏后断开，应检查系统的电池优化与后台限制；若只有个别应用连接异常，再检查按应用分流设置。v2flyNG 适合需要 V2Fly 内核路线的配置，不建议在同一次测试中让两个客户端争用 VPN 连接。
Linux 的 v2rayN 安装包按发行版包管理体系区分，使用 deb 的系统与使用 rpm 的系统应选择各自入口，再核对 x64 或 arm64 架构。安装完成并不意味着当前桌面环境里的所有应用都会读取系统代理。先用支持代理设置的浏览器测试，确认本地入口工作后，再决定是否启用 TUN。涉及虚拟网卡和路由权限时，按界面说明处理，不要用重装替代权限排查。
先理解客户端与内核的分工，再判断配置兼容性。界面名称、节点协议和内核项目是三个层次，不应互相替代。
代理工具生态与配置思路
延续 V2Ray 技术路线，提供代理协议、传输与路由能力。v2flyNG 是这一内核路线的安卓图形客户端选择。
从相关技术生态发展而来，包含自身演进的协议与传输能力。v2rayNG 以 Xray 内核为主，参数支持需按实际内核确认。
桌面图形客户端负责管理节点、订阅和路由配置，再调用兼容的内核执行连接。它不是某一种代理协议的名称。
Project V 是理解这类工具的重要背景。V2Ray 的配置思路把流量处理拆成入口、路由和出口：入口接收本机应用的连接，路由按条件选择处理方式，出口执行直连、代理或阻断。V2Fly 社区延续相关项目维护，Xray 则在关联技术基础上发展自己的实现。这种关系可以解释配置为什么相似，却不能证明任意配置都能在两条内核路线之间直接交换。
VMess、VLESS、Trojan 与 Shadowsocks 是协议名称，TLS、REALITY 等涉及连接安全或握手机制，路由规则又属于流量选择层。阅读订阅参数时，需要逐层核对这些信息。某个客户端能够显示一个节点，不代表它的当前内核支持该节点所有传输和安全选项。遇到不兼容提示时，先确认参数要求，再选择适合的客户端与内核，不要通过关闭安全检查来绕过问题。
v2rayN、v2rayNG、v2flyNG 都属于代码开源的图形客户端项目。v2rayN 与 v2rayNG 采用 GPL-3.0 许可，v2flyNG 采用 GPL-3.0 许可；V2Fly 与 Xray 内核项目采用 MPL-2.0 许可。开源许可说明代码使用、修改和再分发的规则，不应理解为任何节点服务的质量保证。客户端免费使用，也不表示订阅提供方的服务必然免费，二者的维护主体和使用条件需要分别看待。
图形客户端的价值在于把订阅刷新、活动节点选择、规则预设和日志查看放到明确的操作入口中。桌面端的 v2rayN 适合持续整理多组配置；安卓端的 v2rayNG 结合系统 VPN 接口处理移动应用流量；v2flyNG 为 V2Fly 路线提供另一种选择。选型不需要追求装齐全部客户端，只要当前方案支持节点参数、适合设备使用方式，并且日志足以帮助定位问题即可。
客户端更新、内核更新、订阅更新和规则数据更新解决的是不同问题。客户端更新可能改变界面入口或配置生成方式；内核更新可能调整协议支持；订阅更新刷新远端节点信息；规则数据更新改变域名或地址分类。将这些动作分开执行，可以在异常发生时缩小排查范围。已有可用配置时，先保留必要的本地备份，注意备份可能包含敏感参数，不要上传到公开讨论区。
更新后先确认内核能够启动，再验证一个已知目标，最后测试常用应用和分流场景。出现证书报错时检查系统时间、服务器名称与安全参数；出现域名解析错误时检查 DNS 路径；只有某个应用失败时检查它是否读取系统代理。本站的中文文档按操作和症状组织，具体按钮名称可能随客户端界面调整，理解连接路径比记住某一张截图的位置更容易迁移。
从具体配置问题进入：电脑与手机如何共用节点，REALITY 与 Vision 如何配合，TLS 握手失败应该从哪里开始检查。
归纳证书无效和握手失败的常见原因，逐项检查系统时间、SNI 与指纹参数。遇到报错先保留错误信息，不要把跳过证书验证当成长期解决办法。
阅读文章 →说明 Vision 如何处理重复加密场景，REALITY 的握手机制如何与 Xray 配合。理解各层的作用后，再判断当前节点需要哪些参数，避免只按名称选择配置。
阅读文章 →对比订阅链接、二维码与配置备份的适用范围。节点参数可以共用，但系统代理、应用分流与路由预设仍需在每台设备上检查，不能把导入成功等同于配置完全一致。
阅读文章 →订阅更新只负责拉取节点信息。还要选择活动节点、确认内核启动，并让浏览器使用正确的代理入口。先在客户端检查当前服务器，再检查系统代理模式，最后看日志中的错误。若提示解析失败，优先检查 DNS；若是连接超时，再检查远端参数和网络路径。订阅、节点与出站的区别可在概念速查中查看。
不一定。系统代理设置决定应用是否把连接交给本地客户端，路由模式决定进入内核的流量走哪个出站。即便应用使用了系统代理，路由规则仍可能让某些目标直连。反过来，选择代理路由也不能让忽略系统代理的应用自动接入。排查时先确认入口，再确认出站。相关术语见系统代理与路由分流概念。
是否允许多设备使用取决于订阅提供方的条件，客户端不会替代这些限制。参数兼容时可以在两台设备分别导入，但代理入口和应用分流仍要各自设置。分享单个二维码通常只传递节点，不会连同桌面路由习惯一起迁移。公开求助时只贴错误类型和必要的脱敏参数。订阅与节点的关系可先阅读订阅与节点术语说明。
geosite 主要引用域名分类，geoip 主要引用地址分类。域名规则适合按站点归类，地址规则适合处理局域网或已知地址范围。两者不能简单互换，域名解析策略也会影响地址规则何时参与匹配。先确认数据中存在所用分类，再检查规则顺序和出站标签，减少把规则失配误判为节点故障的情况。详细解释见路由与分流概念速查。