准备与导入
添加订阅分组
客户端负责管理配置，不会在安装后自动生成可用节点。先准备来源明确、仍在有效期内的订阅地址。订阅地址通常带有账户识别信息，复制时应保留完整内容，不要把浏览器中的管理页面地址误当成订阅链接。
在 v2rayN 顶部菜单打开“订阅分组”中的“订阅分组设置”，新建分组并填写地址，保存后执行“更新当前订阅（不通过代理）”。如果当前网络无法直接访问订阅服务，再考虑通过已有可用代理更新。操作完成后查看日志，确认服务器列表出现节点；更新失败时先核对地址和返回内容，不必反复重装客户端。
首次配置
V2Ray 快速上手
先导入有效配置，再检查流量是否进入客户端。安装程序、节点订阅和系统代理是三个不同环节，按顺序处理，排查时才有明确起点。
节点与模式
选择活动服务器
在服务器列表选择需要使用的节点，通过右键菜单“设为活动服务器”确认选择。服务器名称只是备注，不能据此判断协议是否适用。导入后应检查地址、端口和传输设置是否保留完整，再运行“测试服务器真连接延迟”，观察代理握手是否能够完成。
首次验证可以使用默认路由规则，先保持配置简单。在主窗口底部“系统代理”中选择“自动配置系统代理”，然后检查“路由”选项。系统代理负责让遵循系统设置的应用连接本地代理，路由规则负责决定进入内核后的流量去向；这两个选项不能互相替代。
访问与检查
核对实际连接
打开需要测试的网页，同时观察 v2rayN 底部日志。能够看到相应的连接记录，才说明该应用的请求进入了客户端。浏览器能打开页面并不等于所有应用都使用代理，某些程序会采用独立的代理设置，也有程序只读取启动时的系统配置。
若页面仍然失败，按系统时间、活动节点、本地监听端口、TLS 参数和路由规则逐项检查，每次只调整一项。退出客户端前先清除系统代理，避免系统仍然指向已经关闭的本地端口。Android 使用 v2rayNG 时，还需要确认系统连接授权和后台运行状态，不能照搬桌面的托盘菜单操作。
平台与客户端
V2Ray 下载入口
桌面使用 v2rayN。Android 首选采用 Xray 内核的 v2rayNG，需要 V2Fly 内核时再选择 v2flyNG。下载页集中列出安装格式、芯片架构与客户端差异，先选系统，再选安装包。
Windows
新安装可先了解采用跨平台界面的桌面版，习惯经典界面布局的用户可选择 WPF 版。两种界面的菜单位置可能不同，教程中的“订阅分组”“系统代理”和“路由”仍分别对应订阅管理、应用流量入口与内核分流，不要仅凭按钮外观判断配置是否生效。
安装前在系统“设置 → 系统 → 系统信息”中查看系统类型，并阅读下载页的适用说明。启动后先验证普通系统代理，再按应用需求考虑 TUN。需要提升权限的功能与普通代理不是同一条检查路径，遇到失败时先看日志，不要同时修改多个开关。
macOS
在系统菜单“关于本机”中查看“芯片”或“处理器”，再选择对应架构。Apple Silicon 与 Intel 使用不同的安装入口，安装格式相同并不意味着二者可以随意互换。导入订阅前，先完成首次启动与系统授权，确认客户端窗口和日志能够正常显示。
系统代理可在“系统设置 → 网络 → 当前网络服务 → 详细信息 → 代理”中检查。若退出客户端后网页无法访问，优先确认代理是否仍指向本地监听地址。切换无线网络、有线网络或其他网络服务后，也应重新检查正在使用的服务，而不是只查看之前连接的那一项。
Android
多数较新的手机可优先查看 arm64 安装选项，架构不明确时再阅读通用版说明。v2rayNG 与 v2flyNG 的主要区别在所用内核及相应配置兼容性，界面看起来接近，不代表所有协议和传输参数都能相互迁移。先确认订阅要求，再决定是否使用备选客户端。
在 v2rayNG 右上角菜单进入“订阅分组设置”，添加订阅后返回更新节点。首次启动连接时，系统会显示 VPN 连接授权；授权用于建立本地流量接管通道，不表示远端节点已成功连通。若锁屏后连接中断，再到系统应用设置检查电池优化与后台活动权限。
Linux
先区分发行版采用的包格式，再确认处理器架构。deb 和 rpm 对应不同的软件包管理体系，x64 与 arm64 对应不同硬件，四种组合不能只按文件扩展名选择。安装和首次启动可通过发行版的软件安装界面完成，桌面环境所需依赖以下载页说明为准。
Linux 的系统代理是否被应用读取，取决于桌面环境与应用自身实现。浏览器可以使用系统设置，终端程序和后台服务却可能需要单独配置。验证时先选一个明确支持代理设置的应用，确认本地入口可用，再扩展到其他程序；不要把应用未接管误判为订阅导入失败。
配置分镜
订阅、路由与内核
订阅决定有哪些节点，路由决定请求走哪里，内核决定如何执行协议。先把三个层次分开，再定位问题所在。客户端负责生成运行配置，分享链接并不是可直接交给内核读取的完整配置文件。
订阅更新与节点导入
订阅地址是获取节点集合的入口，分享链接通常只描述单个节点。在 v2rayN 的“订阅分组设置”填写地址并保存，再更新对应分组。若列表没有变化，先读更新日志，区分网络请求失败、返回内容无法识别和订阅已失效。传统 VMess 分享链接把节点字段编码后放在协议前缀之后，它不是内核原生 JSON；需要由客户端解析，不能直接粘贴到内核运行配置中。
- 更新前确认分组，避免覆盖手动编辑的节点。
- 订阅地址与分享链接都可能包含身份信息。
v2rayN · 菜单与格式结构
订阅分组
订阅分组设置
更新当前订阅（不通过代理）
更新当前订阅（通过代理）
传统 VMess 分享链接结构
vmess:// + Base64(JSON)
解码后常见字段
add → 服务器地址
port → 服务器端口
id → 用户标识
net → 传输方式
tls → 传输安全设置路由规则与代理模式
系统代理是应用访问本地代理的入口，路由是内核接收请求后的分流规则。在 v2rayN 主窗口底部检查“系统代理”和“路由”，不要把全局路由与流量接管范围混为一谈。右侧片段表示匹配中国域名集合后交给直连出站，依赖相应域名数据及已定义的出站标签。规则通常按顺序匹配，更宽泛的规则放在前面可能截走后续请求，因此修改后应结合日志确认实际命中结果。
- 先确认应用流量进入客户端，再检查分流。
- 片段用于说明规则，不能替代完整运行配置。
routing · 域名集合 → direct
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
]
}
}
规则字段：domain
匹配内容：geosite:cn
出站标签：direct内核类型与协议兼容
内核负责协议握手、传输与路由执行，客户端界面负责管理这些设置。v2rayN 可在“设置 → 参数设置 → Core 类型设置”查看协议对应的内核选项，实际可选项随客户端而异。v2rayNG 采用 Xray，v2flyNG 采用 V2Fly；同样的分享链接能被导入，不代表其中每项扩展参数都受目标内核支持。迁移配置时应核对协议、传输方式与 TLS 字段，不能把切换内核当成所有连接失败的通用修复。
- 先确认节点所需协议与传输，再选择内核。
- 导入成功之后，仍需进行实际连接验证。
客户端 · 内核设置位置
v2rayN
设置
参数设置
Core 类型设置
按协议检查内核选项
Xray
V2Fly
Android 客户端对应关系
v2rayNG → Xray
v2flyNG → V2FlyDNS 也需要分层检查。系统解析、浏览器的安全 DNS 与内核 DNS 配置可能采用不同路径。只修改系统 DNS，不一定改变内核的解析行为；只修改内核 DNS，也不一定影响绕过代理的应用。记录请求来自哪个应用、采用哪种接管方式，再到对应位置调整，比同时替换所有解析地址更容易复现问题。相关步骤见V2Ray DNS 设置。
Project V · V2Fly · Xray
V2Ray 开源生态
客户端、内核与节点服务是不同角色。开源属性说明代码的授权和协作方式，连接能力则取决于配置、远端服务与当前网络，不能仅凭客户端名称判断。
Project V 与内核家族
V2Ray 来自 Project V 代理工具生态，核心思路是把入站、出站、路由与传输模块分开配置。V2Fly 延续 V2Ray 的社区开发，Xray 则从相关代码基础发展出独立的内核路线。三者在概念和部分配置字段上存在联系，但不能因此认为所有新增功能都保持一致。阅读教程时应同时看客户端和实际运行内核，单写“V2Ray 配置”往往不足以确定兼容范围。
VMess、VLESS、Trojan 与 Shadowsocks 是协议名称，TCP、WebSocket 等属于传输层面的选择，TLS 又涉及传输安全。它们处在不同层次，不是同一组选项。服务器地址正确而连接仍失败时，需要继续核对端口、协议身份字段、传输路径及服务器名称，而不是只比较节点备注。
图形客户端的分工
v2rayN 面向桌面平台，提供订阅管理、服务器列表、日志查看、系统代理和路由配置界面。v2rayNG 面向 Android，使用 Xray 内核；v2flyNG 则提供以 V2Fly 内核为基础的 Android 选择。三款客户端均为代码开源的软件，承担的是本地配置管理与连接控制，不负责提供远端服务，也不会因为安装完成就自动拥有可用订阅。
桌面和手机可以导入相同来源的订阅，但系统权限、流量接管与后台运行机制不同。桌面教程中的托盘操作不能直接用于手机，手机的连接授权也不能替代桌面的系统代理设置。需要跨设备使用时，优先同步订阅来源，再分别检查各设备上的运行状态。
开源协议与配置边界
v2rayN、v2rayNG 与 v2flyNG 的客户端项目采用 GPL-3.0 授权，V2Fly 与 Xray 的核心代码采用 MPL-2.0 授权；具体文件和所含依赖仍以各自授权声明为准。开源协议约束的是代码使用、修改与再分发，不能把它理解成远端节点服务的可用性说明。客户端免费使用，也不意味着任何第三方订阅都免费或始终有效。
配置中的订阅地址、用户标识和认证字段可能关联个人账户。请只向可信设备传递完整配置，公开日志时移除这些内容。需要求助时，保留错误类型、协议名称和必要的设置项即可，不要为了描述故障公开整条订阅或完整节点二维码。
更新与故障定位
客户端更新、内核更新、订阅更新和路由数据更新分别改变不同内容。客户端更新可能调整界面及配置生成方式，内核更新影响协议实现，订阅更新获取远端节点，路由数据更新则影响域名或地址集合。某一项完成后，其他内容不会因此自动全部刷新。排查前记录刚刚进行的操作，有助于判断变化发生在哪一层。
出现异常时，先保留可复现的最小配置，确认系统时间和本地端口，再检查 TLS、路由与 DNS。不要在一次测试中同时换节点、改内核和启用 TUN。需要逐平台查看菜单位置时，使用全平台指南；只想确认某个概念时，先查常见问题，再回到当前操作。
- Project V
- V2Fly core
- Xray core
- GPL-3.0 / MPL-2.0
配置记录
近期教程与排查
已经完成首次连接后，再处理测速、设备同步和间歇性超时。先确认文章讨论的链路层次，再调整对应设置，避免把端口可达当成代理可用，把配置一致当成网络环境相同。
V2Ray 延迟测试怎么看：TCPing、真连接延迟与下载测速的原理区别
TCPing 只到端口，真连接延迟走完整代理握手，下载测速看实际吞吐。三种结果回答的问题不同，不能只按一个数字排序。文章拆开各项测试的链路范围，说明选择节点时应参考什么，以及为何低延迟不一定对应更高下载速度。
阅读文章 →v2rayN 与 v2rayNG 多设备共用节点：订阅链接、二维码与配置备份同步方案
订阅共享适合持续更新，二维码适合单个节点传递，分享链接便于批量导入，配置备份则需要注意本地参数。文章对照四种同步方式，区分能够复用的节点字段和需要重新检查的设备设置，并说明敏感信息的处理范围。
阅读文章 →V2Ray 节点超时连不上：按系统时间、端口占用、TLS 与路由顺序逐项排查
节点超时不只来自远端服务器。本地时间偏差、监听端口冲突、TLS 服务器名称不匹配以及路由选择都可能中断连接。文章按检查成本排列步骤，逐项指出客户端里的观察位置，先记录错误，再用单项修改确认原因。
阅读文章 →