Windows
v2rayN / Desktop · WPF
适合在桌面上集中管理订阅分组、节点选择与系统代理。下载页提供桌面版和经典 WPF 版：前者使用新一代跨平台界面，后者保留经典桌面操作方式。选型时先看系统兼容性，再决定界面偏好，不必为同一台电脑同时安装两套。
首次启动后，先确认内核能够运行、本地监听端口没有冲突，再导入节点。更新前保留订阅分组与自定义路由；需要迁移配置时，使用客户端支持的导出方式，而不是随意覆盖运行目录。
前往下载 Windows 客户端 →CLIENT / PLATFORM
按平台选择客户端
桌面端优先查看 v2rayN，安卓端优先查看 v2rayNG。先确认操作系统与处理器架构，再选安装包；同一订阅可以用于不同客户端，但界面选项、本地端口与路由预设不一定相同。下载页集中说明安装入口与包类型，首页不列具体版本。
macOS
v2rayN / Apple Silicon · Intel
桌面订阅与路由管理同样可以使用 v2rayN。先在系统的“关于本机”中查看芯片信息，Apple Silicon 选择 arm64，Intel 选择 x64。处理器架构决定安装包类型，不能只凭电脑的外观或购买年份判断。
安装后留意系统对应用启动和网络权限的提示。系统代理只影响遵循该设置的应用，终端工具或自带代理选项的软件可能需要单独配置。排查连接时，应先确认目标应用实际使用了哪一种代理入口。
前往下载 macOS 客户端 →Android
v2rayNG / v2flyNG
优先查看采用 Xray 内核的 v2rayNG；需要 V2Fly 配置兼容性时，再考虑 v2flyNG。多数较新的设备使用 arm64，架构不确定时可查看通用安装包说明。两款客户端的内核能力不同，不能把名称相近理解为所有字段都通用。
首次连接通常需要确认系统 VPN 授权。若系统已有其他 VPN 连接，应先检查是否发生占用。后台连接中断还可能与电池优化、后台运行限制有关；允许后台运行后，再通过日志判断是否仍有节点或解析问题。
前往下载 Android 客户端 →Linux
v2rayN / deb · rpm
按发行版的软件包体系选择 deb 或 rpm，再确认 x64 与 arm64 架构。Debian 系与采用 RPM 包管理的发行版使用不同入口，包格式不是功能等级。桌面环境、系统依赖与网络权限，也会影响安装和启动结果。
图形客户端负责节点与配置管理，实际流量仍由内核处理。系统代理设置是否生效取决于桌面环境与应用支持情况。若浏览器能连接而命令行工具不能，应检查工具自己的代理设置，不要立刻更换节点或重写整份配置。
前往下载 Linux 客户端 →CONFIG / FIELD INDEX
客户端功能与配置字段
图形界面负责组织节点和设置，内核读取配置后执行连接。下面按实际用途拆解两者的边界。代码均为局部示例，用于识别字段位置，不是可以直接连接的完整节点配置；具体语法仍需与所用内核对应。
协议、传输与安全层
VMess、VLESS、Trojan 与 Shadowsocks 描述不同的出站协议；传输方式和安全层则由另外的字段控制。导入节点后，需同时核对服务器地址、端口、传输与 TLS 设置。REALITY 属于安全机制，不应当作独立节点协议理解。v2rayN 与 v2rayNG 能否使用某种组合，取决于实际选择的内核。相比只按协议名称筛选，更可靠的做法是按服务端给出的整组参数检查兼容性，再观察握手日志。
阅读出站字段 →{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}分组管理与出站标签
分享链接通常描述一个节点，订阅地址用于获取可更新的节点集合。先创建订阅分组，再更新并选择节点，能减少手动导入造成的重复。订阅分组属于客户端管理数据，并不是 config.json 的通用顶层字段。运行时，客户端会把选中节点转换成内核可识别的出站对象。示例中的 tag 是路由引用的名称，不是订阅地址。保留自建节点时，建议使用独立分组，避免与订阅更新产生混淆。
查看订阅导入步骤 →{
"outbounds": [
{
"tag": "local-socks",
"protocol": "socks",
"settings": {
"servers": [
{
"address": "127.0.0.1",
"port": 1080
}
]
}
}
]
}按条件引用出站
路由分流把请求条件与出站标签连接起来。规则可以匹配域名、IP 或入站标签，再通过 outboundTag 指向目标出站。规则顺序会影响结果，较具体的条件通常应放在较宽泛的条件之前。示例让 example.com 及其子域名使用 direct 出站，要求该标签已在 outbounds 中定义。相比不断切换全部流量的出口，明确的小范围规则更方便验证；每次只修改一条，并结合访问日志确认实际命中情况。
阅读 routing 规则 →{
"routing": {
"rules": [
{
"type": "field",
"domain": [
"domain:example.com"
],
"outboundTag": "direct"
}
]
}
}解析与连接生命周期
DNS 决定域名怎样解析，policy 则控制部分连接行为，两者不是同一个设置。内核 DNS、系统 DNS 与浏览器自带解析可能同时存在，修改其中一处不代表所有请求都会改变。示例以 localhost 表示使用本地解析，并为用户等级零设置握手超时。实际部署还要检查路由是否需要解析目标域名，以及解析请求采用哪条路径。遇到只有域名访问失败的情况，先区分解析与连接阶段，再调整参数。
阅读 DNS 配置 →{
"dns": {
"servers": ["localhost"]
},
"policy": {
"levels": {
"0": {
"handshake": 4
}
}
}
}先确认内核，再迁移配置
v2rayN 可管理不同内核，但切换内核不等于自动转换全部字段。V2Fly 与 Xray 具有共同的生态背景，也有各自演进的协议与参数；涉及 REALITY 等配置时尤其需要确认支持范围。v2rayNG 与 v2flyNG 的主要区别也包括内核路线。配置中没有一个通用的 core 字段负责切换，操作入口属于客户端。更换后先以 warning 日志检查启动结果，再验证节点连接，最后恢复自定义路由与 DNS 设置。
比较三款客户端 →{
"log": {
"loglevel": "warning"
}
}START / THREE STEPS
从导入到连接验证
先区分三个对象
客户端、节点、订阅
客户端是本地管理界面，节点是一组远端连接参数，订阅是获取节点集合的地址。下载安装客户端后，仍需要可用节点；软件本身不附带通用的服务器账户。先分清这些对象，才能判断问题发生在安装、导入还是连接阶段。
分享链接和订阅地址可能包含访问凭据。不要把完整地址贴进公开截图，也不要为了测试将它交给不熟悉的转换服务。需要反馈问题时，保留错误类型、内核名称与相关字段即可，隐藏地址中的身份参数。
如果已有旧客户端配置，先记录正在使用的节点、代理模式和自定义规则。首次迁移应优先建立最小可用连接，确认正常后再逐项恢复附加设置，避免把历史配置问题一并带入新环境。
先看客户端选型 →-
导入订阅或分享链接
在 v2rayN 中进入订阅分组设置，添加自己持有的订阅地址，保存后更新订阅；单个节点则使用剪贴板导入。v2rayNG 也可通过订阅分组或分享链接添加节点。菜单文字可能随界面调整，判断依据是输入内容：远程节点集合用订阅入口，单条协议链接用节点导入入口。
更新后先确认列表确实出现节点，并检查名称、地址和协议是否符合预期。导入成功只代表客户端能够读取内容，不代表服务器一定在线。若列表为空，先检查订阅地址是否过期、是否需要授权，以及当前网络能否获取订阅内容。
-
选择节点与代理模式
选中一个节点，再根据当前任务设置系统代理与路由模式。系统代理解决“应用是否将流量交给客户端”，路由解决“收到流量后送往哪里”，两项不能互相替代。桌面端应先用遵循系统代理的浏览器测试，安卓端则确认系统 VPN 授权已完成。
首次使用建议沿用客户端提供的基础路由设置。TUN 会引入虚拟网卡与额外权限，并不是每次连接都需要启用。等普通代理路径稳定后，再根据目标应用是否支持代理来决定是否使用 TUN，避免同时修改多个网络层次。
-
验证访问并查看日志
打开一个明确需要通过所选路径访问的页面，再结合客户端日志检查连接。延迟测试是辅助信息，不能替代真实应用访问；某个节点有测试结果，也不代表 DNS、TLS 与目标网站访问都正常。可先测试单个页面，避免大量并发请求让日志难以阅读。
出现超时时，按本地入站、系统代理、路由命中、远端出站的顺序逐项检查。连接被拒绝通常要核对监听与目标端口，握手错误则检查系统时间、服务器名称与安全层参数。记录一次修改前后的结果，比连续更换所有设置更容易定位原因。
PROJECT V / CORE / CLIENT
开源生态与内核边界
界面负责管理，内核执行连接
Project V 生态
V2Ray 是 Project V 生态中的网络代理工具。理解它时，可以把配置拆成入站、路由与出站三个部分：入站接收应用请求，路由检查匹配条件，出站执行连接。DNS、策略与日志分别补充解析、连接行为和运行记录。这种结构也是阅读 config.json 的基本顺序。
V2Fly
延续 V2Ray 的社区开发路线，维护内核及相关配置能力。
Xray
源于 V2Ray 生态的另一条内核路线，发展了自身的协议与安全机制。
共同的配置外观不等于完全相同的语法。遇到某字段无法识别，应先核对内核类型与支持范围，而不是直接认定节点失效。尤其是协议扩展、传输选项与安全层组合，需要按对应内核的能力判断。
三款图形客户端的分工
v2rayN 面向桌面使用，集中管理订阅、节点、路由与可选内核。v2rayNG 面向安卓设备，采用 Xray 内核；v2flyNG 则提供 V2Fly 路线的安卓选择。三款客户端均为开源项目，但客户端名称并不是协议名称，客户端更新也不能简单等同于内核能力完全一致。
图形界面把常见操作整理成选项，运行时仍需生成内核配置。因此，界面里的一项开关可能影响多个 JSON 字段；反过来，客户端也未必提供每个底层参数的可视化入口。需要自定义配置时，应先了解客户端如何保存、生成与覆盖运行文件，避免编辑后又被界面重新生成的内容替换。
开源许可与社区维护
开源意味着源代码按照相应许可提供使用、研究和修改条件，不代表所有组件采用同一种许可。V2Fly 与 Xray 的核心代码主要采用 MPL-2.0；客户端、依赖和附带组件应分别查看各自许可说明。涉及修改与再分发时，应遵守对应项目的署名、源码提供及其他条款，不能只根据“免费”判断使用边界。
社区维护通常分别推进界面改进、配置适配与内核更新。阅读更新说明时，要区分修复属于哪一层：界面调整可能只改变操作位置，内核变化则可能影响协议参数、连接行为或规则支持。本站以下载与配置参考组织这些入口，不替代软件项目自身的许可说明，也不提供节点服务。
更新前后保留可回退路径
更新前先保存订阅分组、自建节点和自定义规则；更新后检查启动日志，再验证常用节点与应用。若只有某一类连接异常，可暂时恢复相关路由或 DNS 设置，逐项对比，而不是清空全部数据。运行日志用于诊断时，应避免长期启用过于详细的记录，并注意其中可能包含目标域名等访问信息。
配置学习也适合采用同样的顺序：先运行基础连接，再了解出站标签与规则匹配，最后调整解析与策略。只有明确每个字段影响的环节，才能判断一次修改是否真正解决了问题。详细字段类型与示例可继续查阅配置文件参考。
NOTES / LATEST
配置与故障排查文章
基础连接建立后，再按具体问题阅读专题。协议文章解释字段背后的机制，节点选型文章说明如何理解测试结果，排查清单则帮助缩小故障范围。阅读时保留当前能够工作的配置，每次只验证一个变化。
V2Ray 显示已连接却无法上网：逐项排查清单
按系统代理状态、本地端口、DNS 解析、路由规则、节点可用性与系统时间的顺序逐项检查，覆盖 v2rayN 桌面端与 v2rayNG 安卓端的常见情形。
阅读文章 →V2Ray 节点怎么选：延迟、倍率、地区与协议类型对照指南
从测速延迟的正确读法、流量倍率的计算方式、地区与线路的关系到 VMess、VLESS、Trojan 的取舍，给出一套挑选节点的判断顺序。
阅读文章 →REALITY 与 XTLS Vision 原理科普：VLESS 传输为什么更快
用通俗的方式讲清 XTLS Vision 如何减少重复加密、REALITY 如何改进 TLS 握手，以及在 Xray 内核配置里对应的 flow 与 security 字段。
阅读文章 →