订阅管理：分组更新与活动服务器选择
订阅地址用于批量取得服务器配置，不等于连接按钮。正确顺序是先建立订阅分组，再执行更新，最后从服务器列表选择活动项。v2rayN 适合按用途建立多个分组；v2rayNG 可通过右上菜单更新当前订阅。更新失败时应先区分地址失效、网络访问失败和返回内容格式异常，不要反复删除已经可用的本地配置。
04 支持平台
03 图形客户端
CORE Xray · V2Fly
OPEN 开源协议
DOCS 中文配置文档
配置能力
订阅与路由按任务拆开说明
先明确客户端负责什么，再决定协议、代理模式和分流规则。下列面板使用客户端中的真实设置名称，避免把不同功能混在一个模糊开关里。
协议支持：先匹配服务端参数
VMess、VLESS、Trojan 与 Shadowsocks 代表不同的协议结构，不能只按名称判断速度。导入配置后，客户端会读取地址、端口、身份字段、传输方式和安全参数；其中任意一项与服务端不一致都可能导致连接失败。手动录入时应逐项核对，不要把 WebSocket 路径、TLS 服务器名称或 REALITY 参数省略。
路由分流：域名、IP 与进程规则分层处理
路由决定每一类连接走代理、直连还是阻断。入门配置可先使用客户端提供的预设模式，确认基本连接后再添加自定义规则。域名规则适合网站与服务名称，IP 规则适合固定网段，桌面端还可按进程处理特定应用。规则存在重叠时通常按顺序匹配，因此更具体的条目应放在通用条目前面。
系统代理：明确应用流量的接管范围
启动客户端只表示内核进程可用，浏览器和其他应用是否经过代理，还取决于系统代理、应用自身设置或 TUN 模式。桌面端通常先启用系统代理完成基础验证；Android 端通过系统 VPN 接口接管所选应用。遇到部分软件不生效时，应检查该软件是否忽略系统设置，或是否配置了独立代理。
配置迁移：订阅地址与本地规则分别处理
跨设备迁移时，订阅地址可以重新导入，但本地路由、应用选择和系统代理状态通常不会自动跟随。桌面端更换系统后，应重新确认内核路径、监听端口和开机启动设置；Android 端则需要重新授权 VPN 接口与后台运行权限。分享配置前还应检查其中是否包含个人订阅凭据。
订阅分组与更新顺序
一个客户端可以保存多个订阅来源，但更新操作应以分组为单位执行。新增地址后先检查分组名称和地址是否完整，再触发更新并查看返回结果。服务器列表出现后，仍需手动选定活动服务器。长期不用的订阅可停用或删除，避免同名服务器混在一起影响判断。对于临时手动配置，建议放入独立分组，使订阅更新不会覆盖本地调整。
内核选择与客户端边界
v2rayNG 默认面向 Xray 内核生态，v2flyNG 面向 V2Fly 内核，v2rayN 则提供桌面图形界面并管理对应核心组件。客户端界面负责导入、切换和系统集成，真正解析协议和执行路由的是内核。遇到新协议参数无法识别时，应先判断客户端和内核是否支持该字段，而不是只检查服务器地址。
路由模式与规则优先级
全局、直连和规则模式解决的是不同问题。全局模式便于快速确认代理链路是否可用；直连模式适合暂停接管；规则模式用于长期使用，通过域名、IP、端口或进程决定出口。排查时先用简单模式缩小范围，再回到规则模式检查命中顺序。不要一次加入大量来源不明的规则，否则出现异常时很难定位是哪条规则改变了流量方向。
系统接管与应用范围
桌面系统的系统代理主要影响遵循系统网络设置的程序，TUN 模式则可覆盖更广的流量类型。Android 客户端通过系统 VPN 接口建立本地转发，并可使用分应用代理控制哪些应用参与。选择方式时应以实际需求为准：浏览器访问可先用系统代理，命令行程序或不读取系统设置的软件再考虑单独配置或 TUN。
平台入口
按操作系统选择客户端
桌面端统一从 v2rayN 开始，Android 优先使用 v2rayNG。安装包页面会按处理器架构和发行格式继续细分。
Windows
使用 v2rayN。桌面版采用跨平台界面，经典 WPF 版适合希望延续传统 Windows 操作方式的用户。安装后先导入订阅，再启用系统代理；若程序无法启动，应继续核对系统组件、安装目录权限与所选架构。
前往下载macOS
使用 v2rayN 的跨平台桌面版。下载前需要判断设备采用 Apple Silicon 还是 Intel 处理器，两类安装包不能随意混用。首次运行后还要允许系统打开应用，并按客户端提示配置系统代理或 TUN 权限。
前往下载Android
优先使用基于 Xray 内核的 v2rayNG，需要 V2Fly 内核时可选择 v2flyNG。多数近年设备适合 arm64 安装包，无法确认架构时再使用通用版。连接前需授予系统 VPN 权限，并根据设备省电策略设置后台运行方式。
前往下载Linux
使用 v2rayN 的 Linux 桌面版。Debian、Ubuntu 系发行版通常选择 deb，Fedora、Rocky Linux 等体系使用 rpm，同时还需区分 x64 与 arm64。安装后应确认桌面会话、托盘支持和系统代理配置是否符合当前发行版。
前往下载快速上手
三步完成基础连接配置
这三步只处理最小可用流程。连接确认正常后，再配置路由规则、分应用代理、DNS 或 TUN，排查时会更容易找到问题所在。
-
01
安装匹配平台的客户端
Windows、macOS 与 Linux 使用 v2rayN；Android 优先使用 v2rayNG。下载前先核对操作系统、处理器架构和安装格式。桌面端安装完成后启动客户端，Android 端完成安装后先允许通知和必要的后台运行权限，但此时还不需要立即开启连接。
-
02
导入订阅并选择活动服务器
复制有效订阅地址，在客户端的订阅分组中新增来源，然后执行更新。列表生成后选择一个服务器作为活动项。若更新失败，先在浏览器或服务方页面确认地址仍然有效，再查看客户端提示的是网络错误、格式错误还是鉴权错误。手动分享链接也可导入，但要确认协议字段完整。
-
03
启用代理并验证流量路径
桌面端先启用系统代理，Android 端点击连接并允许系统 VPN 请求。验证时先使用规则较少的模式，确认浏览器可按预期访问，再逐步恢复自定义分流。如果浏览器正常而某个程序无效，应检查该程序是否使用独立代理设置，或是否绕过了系统网络配置。
开源生态
Project V内核与客户端关系
客户端、内核、协议和订阅是四个不同层次。理解边界后，选型与故障定位会更直接。
Project V 与 V2Ray 配置体系
Project V 建立了以 JSON 配置、入站、出站和路由为核心的网络代理体系。常见客户端并不是另一套协议，而是把复杂配置转换为可操作的图形界面。订阅导入后，客户端将服务器参数整理成内核可读取的配置，再负责启动进程、切换活动服务器和接入系统网络设置。因此，同一条分享配置能否使用，不只取决于客户端名称，还取决于内核是否支持对应协议与传输参数。
V2Fly 与 Xray 内核家族
V2Fly 延续 V2Ray Core 的社区维护方向，保留成熟的入站、出站、路由和传输结构。Xray 在相近配置模型上继续扩展协议与传输能力，两者共享不少基础概念，但具体字段和新功能并非始终一致。v2flyNG 更贴近 V2Fly 内核，v2rayNG 通常使用 Xray 内核；v2rayN 在桌面端负责管理核心组件。遇到配置不兼容时，应把客户端版本、内核类型和服务端参数放在同一条排查链中。
三款图形客户端的职责
v2rayN 面向 Windows、macOS 和 Linux，适合管理多个订阅分组、路由模式、系统代理与桌面运行状态。v2rayNG 面向 Android，以 Xray 内核为主要执行层，提供扫码、剪贴板导入、分应用代理和本地 VPN 接入。v2flyNG 同样面向 Android，但内核路线偏向 V2Fly。三者都属于社区维护的开源软件，功能更新由各自项目节奏决定，界面名称和支持字段可能存在差异。
开源协议与可审阅代码
v2rayN、v2rayNG 与 v2flyNG 的源代码按各自开源许可证发布；V2Fly 与 Xray 内核也有明确的许可证边界。开源意味着实现方式、配置解析和更新记录可以被社区审阅，同时也要求使用者理解软件、内核与订阅服务并非同一主体。本站文档只整理客户端操作与公开技术概念，不代替软件维护者发布说明，也不把第三方订阅来源归入客户端项目。
更新机制与配置兼容性
客户端更新、内核更新和订阅更新是三件独立事项。客户端更新主要改变界面、导入逻辑与系统集成；内核更新可能新增协议字段、修复传输问题或调整行为；订阅更新则从服务端重新取得服务器列表。出现问题时，不应同时重装客户端、删除配置并更换订阅，这会丢失判断依据。更稳妥的方式是记录当前设置，一次只改变一个变量，再观察错误信息是否变化。
常见问题精选
连接前后优先检查这些项目
导入订阅后为什么没有自动连接？
订阅导入只负责生成服务器列表。还需要选择活动服务器，并在桌面端启用系统代理，或在 Android 端启动系统 VPN 连接。若列表为空，应先重新更新当前订阅分组并查看错误提示。相关术语可查看订阅与节点解释。
全局模式和规则模式应该怎样选择？
全局模式适合短时间验证代理链路，所有受客户端接管的流量使用同一出口；规则模式根据域名、IP、端口或进程决定直连与代理，更适合日常配置。先用全局模式确认连接，再切回规则模式排查具体规则，路径最清晰。
节点测速正常但应用无法访问怎么办？
测速结果只能说明某个测试请求完成，不代表所有应用都读取了系统代理。继续检查系统代理状态、分应用列表、路由命中、DNS 设置和目标应用自身的代理选项。若只有一个程序异常，优先查看该程序是否绕过系统网络设置。
v2rayNG 与 v2flyNG 的主要差别是什么？
两者都是 Android 图形客户端，主要区别在内核路线。v2rayNG 以 Xray 内核为主，v2flyNG 对应 V2Fly 内核。选择时应以订阅包含的协议和参数为依据；已有配置在当前客户端稳定运行时，不需要仅因名称不同频繁迁移。
技术文章
配置原理与故障排查记录
文章按具体问题拆解客户端行为，不用笼统结论替代配置步骤。