Windows
v2rayN
桌面版采用跨平台界面，经典 WPF 版延续熟悉的桌面操作方式。两种入口都适合管理订阅、编辑节点和查看日志，按操作习惯选择即可。
首次安装先核对系统要求。已有配置时，先导出需要保留的订阅分组与路由规则，避免把旧设置直接覆盖到新的使用环境。
前往下载CLIENT / SYSTEM
客户端与系统选择
先确定设备系统和处理器架构，再选择客户端。桌面端以 v2rayN 为主，安卓端优先考虑使用 Xray 内核的 v2rayNG；已有 V2Fly 配置需求时，再对照 v2flyNG 的支持范围。客户端负责管理界面，实际协议能力仍要以所选内核为准。
macOS
v2rayN
根据“关于本机”中的芯片信息选择 Apple Silicon 或 Intel 对应安装入口。处理器架构与系统名称是两个条件，不能只凭文件扩展名判断。
安装完成后先导入一个可用节点，确认客户端能够发起请求，再设置系统代理。若浏览器与其他应用表现不同，检查应用是否遵循系统代理。
前往下载Android
v2rayNG / v2flyNG
v2rayNG 使用 Xray 内核，v2flyNG 是 V2Fly 内核备选。主流设备通常选择 arm64；架构不确定时，查看设备信息，再考虑通用安装包。
首次连接需要确认系统 VPN 授权。后台连接被中断时，先检查电池优化和应用后台限制；不要把系统回收进程误判为订阅或协议错误。
前往下载Linux
v2rayN
按发行版的软件包体系选择 deb 或 rpm，同时区分 x64 与 arm64。桌面图形客户端适合集中管理节点，不必为了日常订阅操作先搭建命令行服务。
安装后检查桌面环境的代理设置与本地监听端口。部分应用需要单独填写代理地址；系统代理已启用，并不代表所有进程都会使用同一路径。
前往下载CONFIGURATION PATH
入站、路由、出站。
按请求路径阅读配置。
FIELDS / CAPABILITIES
协议、传输与分流设置
分享链接中的协议名，只描述配置的一部分。身份认证、传输方式、安全层和路由规则各有职责。按下列索引区分这些层次，再进入配置参考核对字段；不要将其他内核的示例整段复制到当前客户端。
协议字段与节点参数
VMess、VLESS、Trojan 与 Shadowsocks 使用不同的认证和加密结构。导入节点后，先核对协议类型，再检查服务器地址、端口和认证信息。VLESS 本身不提供内容加密，通常还需结合 TLS 或 REALITY；VMess 的参数也不能直接套用到 VLESS。与只显示连接开关的工具相比，图形客户端便于逐项查看节点设置，但最终支持范围仍由内核决定。协议名相同，也不代表传输方式与安全层可以省略。
{
"tag": "proxy",
"protocol": "vless"
}安全层与传输层分别核对
TLS、REALITY 与 WebSocket 不属于同一个配置层。前两者涉及安全传输，WebSocket 则是承载数据的传输方式。设置时应先确认服务端要求，再核对 serverName、fingerprint 与路径等字段。不能仅通过切换 TLS 开关，让任意节点适配另一种连接组合。与自动选择参数的简化界面相比，明确展示字段更利于排查握手错误。客户端与服务端必须相互匹配，保留证书验证也应作为常规设置的一部分。
"streamSettings": {
"security": "tls",
"tlsSettings": {
"allowInsecure": false,
"fingerprint": "chrome"
}
}按规则顺序选择出站
路由分流把域名、地址或端口匹配到指定出站，而不是为每个应用自动挑选最快节点。规则通常按顺序检查，先匹配的规则会影响后续处理；因此，应把明确的例外放在宽泛规则之前。domainStrategy 控制路由判断中的域名解析时机，不等于整个客户端的 DNS 配置。相比只有全局切换的方式，规则路由更容易表达细分需求，但需要同步检查 outboundTag 是否存在，并用新请求确认修改结果。
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}订阅地址与分享链接分开管理
订阅链接用于获取一组节点，单条分享链接则用于导入具体连接参数。新增订阅后，还需执行更新，才能看到解析后的节点列表。与逐个手动维护节点相比，订阅分组便于集中刷新，但远端更新也可能覆盖本地对节点的修改。Base64 只是一种编码形式，并不代表内容已经加密。遇到导入失败，应先区分链接格式、订阅响应和内核兼容性；含访问凭据的订阅地址不宜粘贴到公开转换工具中。
{
"tag": "proxy",
"protocol": "vmess"
}复用节点，分别设置本地接入
桌面端与移动端可以使用相同的节点参数，但系统接入方式不同。桌面客户端常通过本地 SOCKS 或 HTTP 监听配合系统代理工作，安卓客户端则通常借助系统 VPN 接口接管流量。相比把整份运行配置直接搬到另一台设备，更稳妥的方式是先导入节点，再按设备调整本地端口、路由和 DNS。文件路径、权限与后台限制也各不相同。跨平台意味着管理方式相近，并不意味着每项本地设置都能原样复用。
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks"QUICK START / THREE STEPS
订阅导入到连接验证
客户端安装完成只是起点。首次设置建议使用一个来源明确、参数完整的节点完成整条连接路径，再添加复杂的分流规则。这样出现问题时，可以区分节点本身、客户端设置和应用接入三个环节。
-
导入订阅，确认节点内容
在订阅管理中新增分组并填入订阅地址，保存后执行更新。单条分享链接则使用从剪贴板导入的入口。列表为空时，先检查复制内容是否包含多余空格，以及订阅是否需要有效的访问凭据；网页地址不一定就是订阅地址。
导入后查看一个节点的详细设置，确认协议、服务器地址、端口和传输方式。节点备注只是便于识别的名称，不能用于判断实际线路、可用性或加密方式。已有手动修改时，先记录差异，再刷新订阅。
-
选择节点，设置流量入口
把准备测试的节点设为活动项，再选择适合当前需求的路由模式。桌面端启用系统代理前，检查本地监听端口是否被占用；安卓端则按系统提示确认 VPN 授权。系统代理只影响遵循该设置的应用，不能据此推断所有流量都已进入客户端。
初次使用先保留清楚、简单的规则。需要切换 TUN 等接入方式时，再单独检查权限、路由与 DNS 行为。不要同时修改传输、安全层和分流规则，否则很难确定哪一项导致结果变化。
-
发起新请求，对照日志验证
打开一个允许访问的测试页面，观察客户端日志是否产生对应连接。TCP 测试成功只说明某个端口可建立连接，不代表身份认证、TLS 握手和完整请求都成功；真连接测试与下载测速又分别覆盖不同环节。
若浏览器仍不能访问，先检查应用代理，再看日志中的域名解析、连接超时或握手错误。每次只改动一个条件，保存并重新加载配置，再用新请求复测。转发日志求助前，应删除订阅地址、认证字段和其他个人信息。
CORE / CLIENT / CONFIG
区分内核能力，
再判断客户端设置。
PROJECT V / V2FLY / XRAY
开源内核与客户端关系
搜索“V2Ray”时，常会同时遇到项目名称、内核名称与客户端名称。它们处于不同层次：项目生态提供技术背景，内核处理连接，图形客户端负责把节点和设置组织成可运行的配置。理解这层关系，才能判断一份教程是否适用于当前环境。
Project V：配置结构的共同背景
V2Ray 起源于 Project V 生态。入站接收应用流量，路由决定处理方向，出站负责连接目标，这一结构让协议与流量策略可以分别组织。今天许多图形客户端仍沿用这些概念，因此看懂 inbounds、outbounds 和 routing，比记住某个界面按钮的位置更容易迁移到不同环境。
配置结构相近不代表所有字段通用。阅读旧教程时，应同时确认所用内核、协议组合和文档适用范围。界面名称可能随更新改变，但请求从哪里进入、按什么规则匹配、经哪个出站发送，仍然是排查问题的基本路径。
V2Fly 与 Xray：相关但独立演进
V2Fly 延续 V2Ray 的社区开发，Xray 从相关代码基础分支发展，并引入了自己的协议和传输能力。两者具有共同历史，也存在配置差异。例如 REALITY 与 XTLS Vision 的设置应放在 Xray 的支持范围中核对，不能仅因配置同为 JSON，就推断另一内核会识别相同字段。
客户端能够切换内核时，切换并不是简单的性能选项。应重新确认节点协议、安全层和 flow 等字段是否受支持。遇到“未知字段”或协议不支持的提示，先检查内核选择，比反复改动服务器地址更有针对性。
三款客户端：管理界面与运行内核分工
v2rayN、v2rayNG 和 v2flyNG 都属于代码开源的图形客户端。v2rayN 面向桌面使用，可管理节点、订阅与路由；v2rayNG 在安卓端使用 Xray 内核；v2flyNG 提供基于 V2Fly 的另一种选择。客户端保存的订阅分组、界面偏好与内核读取的运行配置，不一定是同一种文件。
这三款客户端可免费使用，但客户端本身不提供远端节点或网络服务。订阅链接和节点参数需要来自有权使用的服务来源。选择软件、选择内核和选择连接服务，是三个独立判断，不宜用其中一个名称替代另外两个。
开源许可与更新：分别检查组件
开源意味着源代码在相应许可条件下开放，使用、修改和再分发仍须遵守各项目的许可文本。V2Fly 的主要代码采用 MIT 许可，Xray-core 采用 MPL-2.0；客户端及附带组件则按各自许可处理。许可名称描述权利与义务，不等于对任意运行配置作出安全保证。
客户端、内核和规则数据可能采用不同更新节奏。升级前记录现有内核选择，备份路由与 DNS 设置，升级后用同一测试请求验证。只有某个站点异常时，优先检查规则与解析；全部连接都失败时，再沿本地入口、节点参数和内核运行状态逐层定位。
READING / RECENT NOTES
订阅格式与连接诊断
完成基本连接后，再处理格式转换、协议差异和测试结果。下面三篇文章从具体字段与测量过程出发，说明容易混淆的概念，适合在配置遇到对应问题时查阅。
v2rayN 测速功能解读：TCPing、真连接延迟与下载测速的区别
TCP 握手、经代理完成的请求与持续下载，测量的是不同阶段。文章说明数值为什么不能直接互比，以及如何结合日志、真连接测试和实际访问判断节点状态。
阅读文章 →VMess 和 VLESS 区别对照：UUID、alterId 与加密方式入门
从身份认证、时间要求与安全层组合区分两种协议，解释 UUID 与 alterId 的作用。先理解字段属于哪一层，再判断哪些参数需要跟随节点来源填写，哪些不能互相替换。
阅读文章 →V2Ray 订阅格式对照：Base64 订阅、原生 JSON 与 vmess:// 分享链接互转
拆解订阅响应、运行配置与单节点分享链接的区别，说明导入入口如何选择。转换格式前先检查目标客户端支持范围，避免把编码成功误认为配置已经兼容。
阅读文章 →