订阅分组列表
将来源、筛选条件与更新动作放在同一分组
桌面端先在“订阅分组”中保存完整订阅地址，再执行“更新当前订阅”。家庭、办公或测试用途可以分别建组，避免不同来源全部堆在一张服务器列表中。若更新后列表为空，应先检查分组过滤关键字和地址是否完整，而不是反复切换系统代理。
设置路径：订阅分组 → 添加订阅 → 更新当前订阅
桌面与 Android 客户端中文说明
V2Ray中文站 · v2rayN 指南
集中整理 客户端安装、订阅导入 与 路由分流。设置名称与客户端界面保持一致，按步骤即可完成基础配置。
永久免费
代码开源
Xray 与 V2Fly 生态
中文配置文档
客户端设置面板
订阅、路由与系统接管
先选择使用场景，再查看对应设置项。示例名称采用客户端中的常见菜单与规则语法。
规则从上到下匹配
用明确条件决定 direct 与 proxy 出站
路由规则适合处理固定域名分类、私有地址和其余连接。常见起点是让 geosite:cn 与 geoip:private 使用 direct，再让 geosite:geolocation-!cn 使用 proxy。规则命中后通常停止继续检查，因此具体规则应放在宽泛规则之前。
修改后保存路由配置，并确认当前运行模式使用规则分流
接管范围选择
系统代理处理常规应用，TUN 覆盖更多连接
浏览器和遵循系统代理的桌面应用，通常开启“系统代理”即可。遇到不读取系统代理的程序，再评估启用 TUN 模式。TUN 会改变更广的流量接管范围，首次启用可能需要系统授权；切换前应先确认路由与 DNS 配置，避免把本地服务错误送入代理出站。
先使用系统代理验证配置，再按应用需求启用 TUN
配置导入
区分单条分享链接与持续更新的订阅地址
单条配置可以从剪贴板或二维码导入，适合临时添加。订阅地址应保存到分组中，后续通过更新动作同步内容。导入后先核对协议、地址、端口、传输方式与 TLS 相关字段；二维码识别失败时，可改用复制完整链接，避免截图压缩影响识别。
导入完成后选择配置，再启动本地 VPN 接管
系统网络授权
本地 VPN 模式负责把应用连接交给客户端处理
Android 客户端启动时会请求系统网络连接授权，这是创建本地接管通道所需的步骤。授权后，状态栏会显示系统网络图标。若启动后应用仍无法连接，应依次检查当前配置、路由模式、DNS、分应用范围和省电限制，而不是只观察主界面的启动按钮。
系统授权只需按系统提示确认，配置内容仍在客户端中管理
应用范围
包含模式与排除模式只选择其中一种逻辑
分应用代理适合让部分程序使用当前配置，或让本地服务保持原连接。包含模式只处理勾选的应用，排除模式处理未被排除的应用。设置前先确定目标范围，再检查新安装应用是否需要补充到列表，避免同时使用相反逻辑造成判断混乱。
修改应用范围后重新启动连接，使系统重新建立接管关系
协议字段
协议名称相同，不代表传输参数可以互换
VMess、VLESS、Trojan 与 Shadowsocks 使用不同的身份字段和连接方式。导入配置时还要同时核对 TCP、WebSocket、gRPC、TLS、REALITY 等传输层参数。客户端负责把这些字段交给对应内核处理，但不会自动修复缺失的服务器名称、路径或公钥配置。
先确认协议，再逐项核对传输、安全层与地址字段
解析路径
DNS 结果应与域名路由采用一致的判断逻辑
域名规则依赖解析和嗅探结果。基础配置可先使用客户端默认 DNS，再根据分流需求设置本地与远程解析。启用 FakeDNS 或 TUN 后，需要同步检查 DNS 接管范围、私有域名和局域网地址；否则可能出现规则看似命中、实际连接却走错出站的情况。
DNS 调整应一次只改一组设置，并通过日志观察实际查询路径
逐层排查
把订阅、配置、内核启动与系统接管分开检查
订阅更新失败不等于现有配置无法运行，服务器测试失败也不一定是系统代理问题。排查时先确认订阅能否解析，再确认配置字段和内核日志，随后检查系统代理或本地 VPN 是否已接管目标应用。按层次记录结果，比连续更换多个设置更容易找到原因。
日志中的第一条明确错误通常比后续连锁提示更有参考价值
按平台选择
V2Ray 客户端下载入口
桌面端使用 v2rayN。Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。首页只负责平台定位，具体安装包类型与系统要求在下载页列出。
Windows
选择 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面，WPF 版保留熟悉的 Windows 操作方式，均可管理订阅、路由与系统代理。
前往下载macOS
v2rayN 提供适配不同芯片架构的安装入口。下载前先在“关于本机”查看芯片类型，首次运行时再按系统提示处理应用与网络权限。
前往下载Android
v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核。多数较新的设备可优先选择 arm64 架构，不确定设备架构时再使用通用安装包。
前往下载Linux
v2rayN 提供 deb 与 rpm 两类桌面安装入口，并区分 x64 与 arm64。应根据发行版的软件包格式和处理器架构选择对应文件。
前往下载快速上手
从安装到规则分流的三个步骤
先完成最小可用配置，再逐步加入路由、DNS 与 TUN 设置。一次修改过多选项，会增加故障定位难度。
-
1
安装客户端并导入订阅
根据平台进入下载页。Windows、macOS 与 Linux 使用 v2rayN；Android 可选择 v2rayNG 或 v2flyNG。安装完成后打开“订阅分组”，新建分组并粘贴完整订阅地址，再执行更新。若使用单条分享链接，可从剪贴板导入，但单条链接不会像订阅那样集中更新。
更新后先查看服务器列表是否出现内容。列表为空时，重点检查地址是否被复制截断、分组过滤条件是否过严，以及更新动作是否作用于当前分组。此时无需急着修改系统代理，因为订阅解析发生在连接之前。
-
2
选择配置并开启系统接管
在服务器列表中选中一条配置并设为活动项。桌面端先启用“系统代理”，让浏览器和读取系统代理的应用使用当前配置；Android 启动连接后按系统提示授予本地 VPN 权限。完成后先访问常用页面，确认基础连接正常。
只有当目标程序不读取系统代理，或确实需要覆盖更多网络连接时，再考虑 TUN 模式。启用后应检查本地开发服务、局域网设备与 DNS 是否仍按预期访问。基础连接尚未确认前，不建议同时启用复杂路由和 FakeDNS。
-
3
添加路由规则并查看日志
基础连接稳定后，再配置规则分流。规则按顺序匹配，建议先放具体域名或私有地址条件，再放覆盖范围更广的规则。常见写法包括
geosite:cn、geoip:private与geosite:geolocation-!cn，对应出站可设置为 direct 或 proxy。保存后重新加载配置，并通过日志确认规则、DNS 与出站选择。出现问题时回到上一步，逐项撤销最近修改，不要同时更换订阅、协议、DNS 和系统接管方式。这样可以明确是哪一层设置影响了连接。
开源生态
Project V、V2Fly 与 Xray 的关系
理解客户端、内核和协议之间的分工，有助于判断配置错误发生在哪一层。图形客户端负责导入、编辑与启停；内核负责解析协议、建立连接和执行路由；订阅则是批量传递配置的载体。
Project V 与 V2Fly
Project V 形成了以 V2Ray 配置体系、协议实现和路由能力为核心的开源生态。V2Fly 延续并维护相关核心组件，保留常见的入站、出站、路由、DNS 与传输配置结构。v2flyNG 采用 V2Fly 内核，适合希望保持这一内核体系的 Android 用户。
“V2Ray”在日常使用中常被同时用来指代生态、配置方式和客户端类别，但这些概念并不完全相同。遇到错误时，应先确认提示来自图形界面、订阅解析还是内核运行日志。把层次区分开，可以避免将客户端界面问题误判为协议问题。
Xray 内核家族
Xray 在相近的配置生态上继续扩展协议与传输能力。v2rayN 可根据具体功能和配置使用相应核心组件，v2rayNG 则以 Xray 内核作为 Android 端的主要执行层。VLESS、REALITY、gRPC 等字段能否正常工作，不只取决于客户端名称，还取决于内核支持、服务端配置和参数是否完整对应。
客户端导入链接后会把字段转换为内部配置，但转换并不意味着所有组合都有效。例如服务器名称、流控、指纹、公钥、短标识、路径与主机字段各有明确用途。出现握手错误时，应对照协议和传输层逐项检查，而不是仅在多个配置之间反复切换。
三款客户端的开源属性
v2rayN 是面向 Windows、macOS 与 Linux 的桌面图形客户端，提供服务器列表、订阅分组、路由设置、系统代理、TUN 和日志等管理入口。v2rayNG 与 v2flyNG 面向 Android，交互相近，但使用的内核家族不同。三者均由社区持续维护，发布节奏和平台适配范围并不要求完全同步。
开源许可允许社区审阅代码、讨论实现并持续改进兼容性。对普通用户而言，更直接的价值是设置名称、配置结构与问题讨论能够被公开理解。选择客户端时仍应以操作系统、内核需求、协议字段和使用习惯为依据，而不是只比较界面外观。
更新机制与配置兼容
客户端更新、内核更新和订阅更新是三类不同动作。客户端更新改变图形界面与功能集成；内核更新影响协议实现和运行行为；订阅更新只同步配置内容。排查更新问题时，应先确认是哪一层发生变化，并保留当前可用配置以便对照。
旧配置在新版本中通常可以继续导入，但新增字段可能需要重新保存或手动补充。多订阅用户应给分组设置清晰名称，避免更新错误来源。路由与 DNS 等本地设置也应独立记录，因为它们不一定包含在远程订阅中。
常见问题精选
安装、订阅与连接判断
以下问题用于快速确定排查入口。完整原因、界面路径和处理步骤收录在 FAQ 与进阶配置手册中。
geosite 与 geoip 应该怎样排列
规则从上到下匹配，具体条件应放在宽泛条件之前。域名使用 geosite 分类，目标地址使用 geoip 分类，私有地址通常应优先直连。
查看路由规则实战 →