CONFIGURATION NOTES
客户端界面会把复杂配置拆成表单，但字段之间仍有严格对应关系。下面按使用顺序校注协议、订阅、路由、传输和内核。选择左侧键名，可查看该字段解决的问题、核对方式以及容易混淆的边界。
01 / PROTOCOL
协议是客户端与远端服务之间解释数据的基本规则。VMess 带有自身身份与时间校验机制；VLESS 采用更精简的认证结构，常与不同安全层组合；Trojan 的配置重点通常落在密码、服务器名称和证书相关参数；Shadowsocks 则由加密方法与密码共同确定连接方式。导入节点后，先核对协议类型，再检查该协议对应的必填字段，不要只看节点名称判断。
协议与 TCP、WebSocket、gRPC 等传输类型属于不同层级。更改协议并不会自动修正传输参数。客户端提示格式错误时，应把协议、端口、用户标识、传输和安全层作为一组逐项比对。
阅读协议选型说明 →02 / SUBSCRIPTION
订阅地址用于取得一组节点及其更新结果。添加地址后，还需要执行更新订阅，客户端才会读取远端内容并写入本地列表。更新成功只表示格式能够读取，不代表列表中的每个节点都能建立连接。选择节点后，应继续执行真连接测试，并通过网页访问或出口地址查询确认系统代理是否已经生效。
多个订阅可以分别命名和管理。更新前先确认地址首尾完整，避免复制时夹入空格或换行。订阅失效、返回内容为空、格式不受当前客户端支持，会表现为节点没有新增或旧节点未变化，应按这三个方向依次检查。
查看订阅导入步骤 →03 / ROUTING
路由规则不会改变节点本身，而是判断一条连接应该走代理、直连还是阻断。常见条件包括域名、IP、端口、网络类型和进程。规则通常按顺序匹配，前面的宽泛条件可能提前接住流量，使后面的精细规则不再执行。因此，排查分流结果时既要看规则内容，也要看排列顺序和对应的出站标签。
新用户可先使用客户端提供的预设模式，确认基本连接稳定后再添加自定义规则。规则改动后应分别验证目标网站、常用应用和本地网络资源，避免只用一个页面的结果推断全部流量状态。
查阅路由与分流术语 →04 / STREAM SETTINGS
streamSettings 描述底层网络类型、安全层及其附加参数。TCP、WebSocket 与 gRPC 的字段结构不同；启用 TLS 或 REALITY 后，还会增加服务器名称、指纹、公钥、短标识或路径等设置。只要其中一项与节点资料不一致，就可能出现握手失败、连接后立即断开或持续超时。
核对时建议固定顺序：网络类型、安全类型、服务器名称、路径或服务名、附加标识。不要在一次排查中同时改动多个字段，否则即使恢复连接，也难以确认真正影响结果的是哪一项。
阅读传输层对比 →05 / CORE
v2rayN、v2rayNG 与 v2flyNG 是图形客户端，真正解析配置、建立连接和执行路由的是其所配套的内核。Xray 与 V2Fly 具有共同的技术源流，基础配置概念高度相似，但新协议支持、传输扩展和部分字段实现并不完全相同。节点能否导入与能否运行也要分开判断：客户端可能识别链接格式，而当前内核未必具备对应能力。
选择客户端时先看平台，再看节点所需协议。更新客户端通常也会带来内核能力调整。遇到旧配置在新环境下行为变化时，应查看字段兼容关系，而不是直接复制另一内核的全部高级参数。
查看内核家族说明 →PLATFORM ENTRY
平台决定安装包格式和推荐客户端。桌面系统以 v2rayN 为主，Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。首页只负责分流到对应平台，具体安装包类型和架构说明集中在下载中心。
DESKTOP / X64
推荐使用 v2rayN。桌面版采用跨平台界面，经典 WPF 版保留熟悉的 Windows 操作结构。两者都提供订阅管理、系统代理、路由规则和日志查看入口，可根据界面习惯选择。
前往下载DESKTOP / ARM64 · X64
使用 v2rayN 桌面端。下载前需要先确认处理器架构：Apple Silicon 设备选择 arm64，Intel 处理器设备选择 x64。安装后可沿用桌面端相同的订阅、节点选择与系统代理流程。
前往下载MOBILE / ARM64
优先选择采用 Xray 内核的 v2rayNG；需要 V2Fly 内核时可选择 v2flyNG。多数较新的手机使用 arm64 安装包，无法确认架构时可使用通用包。两款客户端的订阅入口和连接流程相近。
前往下载DESKTOP / DEB · RPM
使用 v2rayN 桌面端。Debian、Ubuntu 系发行版通常选择 deb，Fedora、RHEL 系发行版通常选择 rpm；还需按设备处理器确认 x64 或 arm64。安装后先检查桌面会话与系统代理设置。
前往下载QUICK START
首次配置不必同时修改所有高级选项。先完成订阅、节点和系统代理三项基本操作，确认链路成立，再根据需要设置路由或更换协议。
从节点服务资料中复制完整订阅地址。在 v2rayN 中进入订阅分组设置，在 v2rayNG 中进入订阅管理，填写名称与地址并保存。保存只是记录来源，随后还要执行更新订阅。更新结束后检查节点列表是否出现新条目，并确认协议、服务器和端口等基础信息能够正常显示。
如果列表没有变化，先重新复制地址，检查首尾空格和换行，再确认订阅内容是否仍然有效。不要把单个 vmess:// 或 vless:// 节点链接误填到只接受订阅地址的输入框。
从更新后的列表选择一个节点作为活动服务器。先使用客户端的真连接测试观察是否能完成实际请求，不要只依赖网络可达性测试。随后按需求选择规则模式或全局模式：规则模式依据路由条件分配流量，全局模式通常把更多连接交给当前出站，二者的差别在于流量处理范围，不会改变节点配置本身。
初次使用建议保持客户端默认路由，减少变量。若所有节点都超时，应先检查本机时间、订阅状态和传输参数；若只有个别节点失败，则优先更换节点比较结果。
启动客户端连接后，再开启系统代理或客户端要求的本地接管方式。连接图标发生变化并不等于所有应用都已经使用代理，应打开网页完成一次真实访问，再查询当前出口地址进行交叉确认。浏览器有效而其他程序无效时，重点检查该程序是否遵循系统代理，或是否需要单独设置代理地址与端口。
验证完成后再配置开机启动、自动更新订阅与自定义路由。每次只调整一类设置并记录结果，出现异常时就能快速回退到上一组可用状态。
OPEN SOURCE CONTEXT
生态源流
V2Ray 最初形成了一套可组合的代理、传输与路由设计。配置中的入站、出站、路由和传输层可以分别描述，再由内核组合执行。Project V 因而更适合被理解为一组技术概念与实现生态。用户日常看到的 v2rayN、v2rayNG 和 v2flyNG，则是在这些内核能力之上提供图形操作入口的客户端。
区分“客户端”和“内核”很重要。客户端负责订阅管理、界面交互、系统代理开关与日志展示；内核负责解析配置、建立连接、处理协议并执行路由。界面看起来相似，不代表底层支持范围完全相同。
内核家族
V2Fly 延续 V2Ray 的社区化维护方向，保留入站、出站、路由和多种传输组合能力。Xray 在相同技术源流上扩展了部分协议、安全层与传输实现。两者许多基础字段可以互相理解，例如地址、端口、用户标识、路由规则和传输网络，但涉及 REALITY、XTLS Vision 或特定扩展字段时，需要按照实际内核能力判断。
配置兼容不能只看文件能否导入。客户端成功识别分享链接，只说明链接格式被解析；真正启动连接时，仍要由当前内核处理全部字段。遇到“能导入但无法连接”的情况，内核能力、字段命名与传输组合应列入检查范围。
维护方式
V2Fly、Xray 及其图形客户端由不同社区和维护者推进，发布节奏并不完全一致。功能更新通常涉及协议实现、依赖组件、平台适配和界面调整。用户升级时应先查看目标客户端适用的平台与内核方向，再决定是否需要迁移设置。长期配置建议保留订阅地址、路由规则和必要的自定义参数记录，便于重装或更换客户端时重新建立环境。
代码开源意味着实现与变更过程可被技术社区检查、讨论和改进，但具体连接质量仍取决于节点参数、网络环境、服务端配置和本地系统设置。判断问题时应依据日志与可复现步骤，而不是只根据客户端名称下结论。
TECHNICAL NOTES
技术笔记聚焦可以重复执行的操作顺序。每篇文章先界定问题，再解释字段或界面入口，最后给出验证方法，便于在不同客户端之间对照。
集中说明三款客户端的适用平台、订阅链接的作用、全局与分流模式的边界，以及更新客户端后如何保留原有配置。适合在首次安装前快速建立概念顺序。
阅读全文 →按固定顺序检查系统时间、本地代理端口、节点字段、传输设置与订阅状态。每完成一步都安排对应验证，减少同时修改多个参数带来的判断干扰。
阅读全文 →分别标注桌面端和 Android 端的订阅添加入口，解释保存、更新、选择节点三步之间的关系，并说明 Base64、vmess 与 vless 等常见内容形式。
阅读全文 →