Windows
使用 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面，适合新环境；WPF 版延续传统操作结构，托盘菜单、服务器列表和系统代理入口较集中。
平台入口
按操作系统选择客户端
桌面平台统一从 v2rayN 开始，Android 可按内核类型选择 v2rayNG 或 v2flyNG。入口会打开下载页对应平台标签。
macOS
使用 v2rayN 桌面客户端。下载前先在系统信息中确认处理器类型，再选择 Apple Silicon 或 Intel 安装包；首次启动后按系统提示完成应用确认和网络权限设置。
Android
首选采用 Xray 内核的 v2rayNG；需要 V2Fly 内核实现时可使用 v2flyNG。多数近年设备适合 arm64 安装包，无法确认架构时可选择通用版。
Linux
使用 v2rayN 桌面客户端。Debian、Ubuntu 等系统选择 deb，Fedora、RHEL 系发行版选择 rpm；还需根据设备处理器确认 x64 或 arm64 架构。
核心设置
从订阅到路由的操作链
功能目录按实际配置顺序组织。选择左侧项目可查看用途、操作边界与对应设置项。
订阅导入与分组更新
订阅用于集中读取服务器配置，适合在多个节点之间切换。导入时应先确认链接来源和分组名称，再执行一次订阅更新，让客户端重新读取当前内容。更新完成后，服务器列表会按订阅提供的名称写入对应分组；已有手动配置通常可继续独立保留。若导入后列表为空，应先检查选中的订阅分组，再确认链接是否完整，而不是反复切换系统代理。
v2rayN 可以设置定时更新间隔，也允许手动更新单个分组。多设备使用同一订阅时，各客户端仍需分别执行更新，订阅本身不会直接同步客户端里的路由模式、系统代理状态和界面偏好。这样可将服务器配置与本地策略分开管理，修改其中一项不会覆盖另一项。
订阅更新
更新当前订阅
系统代理与应用生效范围
系统代理控制采用操作系统代理设置的应用是否通过当前客户端。自动配置适合浏览器及遵循系统代理的桌面程序，启用后客户端会写入本地代理地址；关闭时应同步清理系统代理状态，避免应用继续指向已经停止监听的端口。部分程序使用独立网络栈，不读取系统代理，这类场景需要查看程序自身的代理选项或使用客户端提供的其他接管方式。
连接节点和开启系统代理是两个不同动作：前者让内核建立可用出站，后者决定系统流量是否送入该出站。排查时应依次确认当前服务器已激活、内核运行正常、系统代理状态已切换。分开检查比反复重启客户端更容易定位问题。
系统代理
路由模式与按目标分流
路由规则决定进入内核的请求应直连、代理还是阻止。常用预设会按域名、地址范围和局域网目标进行匹配，例如绕过局域网及大陆模式适合保留本地设备访问，并减少不需要经过代理的连接。规则判断发生在流量进入客户端之后，因此路由模式不能替代系统代理或 TUN 等流量入口，两者需要分别配置。
自定义规则时应从范围明确的条件开始，先处理局域网、特定域名和应用需求，再设置兜底出站。规则顺序会影响最终匹配结果；修改后应重新连接当前节点，并用目标站点做一次实际访问验证。若规则数量较多，可先暂时切回预设模式，判断故障来自节点还是来自自定义匹配条件。
路由模式
绕过局域网及大陆
Xray 与 V2Fly 内核选择
图形客户端负责界面、订阅和系统集成，实际协议连接由内核完成。Xray 与 V2Fly 来自 Project V 相关生态，基础配置概念相近，但扩展特性和协议支持并不完全相同。使用 VLESS、REALITY、XTLS Vision 等配置时，应核对服务端要求与客户端内核能力；普通 VMess、VLESS 或 Trojan 配置也需要保证传输层参数一致。
v2rayN 可管理桌面环境中的多种内核配置，v2rayNG 主要采用 Xray 内核，v2flyNG 对应 V2Fly 内核。选择依据应是节点协议和传输参数，而不是仅看客户端名称。遇到配置可导入但无法连接的情况，先比对协议、地址、端口、传输方式与安全参数，再检查内核是否支持相关扩展。
核心类型
按配置要求选择
延迟测试、连接日志与速度判断
ICMP ping、真连接延迟和下载测速反映的是不同环节。ping 主要观察到服务器网络接口的往返时间，不包含完整代理握手；真连接延迟会经过协议与传输建立过程，更接近打开网页前的等待；下载测速关注持续吞吐，容易受到服务器负载、中间线路和本地网络状态影响。三个结果不一致属于常见情况，不能只凭单一数字判断配置质量。
排查连接失败时，先确认客户端日志中是否完成域名解析和协议握手，再检查本地端口是否被其他程序占用。速度偏慢则按节点、线路、本地设置三层对照：更换节点测试同一目标，换时间段判断拥塞，最后检查路由、内核和并发相关设置。每次只改一项，结果更容易复现。
测试方式
真连接延迟
开源生态
Project V、V2Fly 与 Xray
客户端、内核与协议处在不同层级。理解三者关系，有助于正确选择安装包、判断配置兼容性，并在更新后快速定位变化来源。
从核心项目到图形客户端
Project V 形成了以配置驱动网络代理核心的技术生态。V2Ray 的入站、出站、路由和传输层概念，为后续客户端提供了统一的配置基础。图形客户端不重新定义这些协议，而是把 JSON 配置、订阅内容、系统代理和进程管理转换成可操作的界面。用户在服务器列表中切换节点时，客户端会根据选中项生成内核可读取的运行配置。
V2Fly 延续 V2Ray 核心的社区维护方向，侧重通用协议与模块化配置。Xray 则在相近配置体系上发展了自己的扩展能力，包括与 XTLS、REALITY 相关的实现。两者共享不少基础概念，但功能加入时间、参数名称和兼容边界可能不同。配置提供方标注了特定内核要求时，应按要求选择，不宜直接假设所有扩展都能互换。
VMess、VLESS 与 Trojan 是代理协议名称；WebSocket、gRPC、TCP 等属于传输方式；TLS、REALITY 等负责不同层面的安全与握手设置。订阅只是配置的分发形式，不会改变协议本身。把这些字段分层核对，可以避免将“订阅更新失败”“内核不兼容”和“路由未生效”混为同一个问题。
相关项目采用开放源代码方式维护，代码变更、问题修复和协议实现由各自社区持续推进。开源协议规定了代码使用、修改与再分发的边界，也使不同图形客户端能够围绕同一内核体系提供界面和系统集成。客户端更新通常包含界面调整、订阅解析、平台适配或内核管理变化；内核更新则更直接影响协议支持与连接行为。
实际维护中，客户端与内核不一定同步发布。遇到更新后的行为差异，应先确认变化发生在客户端界面、订阅内容还是底层内核，再决定回看设置或调整配置。保留当前可用的订阅来源和路由策略记录，有助于在跨设备迁移时复现同一套连接条件。
v2rayN
面向 Windows、macOS 与 Linux 的图形客户端。功能覆盖订阅分组、服务器切换、系统代理、路由规则、日志查看和内核管理。桌面端配置集中在同一工作区，适合需要维护多个订阅、手动节点和自定义路由的环境。
v2rayNG
面向 Android 的图形客户端，以 Xray 内核为主要执行组件。可通过订阅链接、剪贴板内容或二维码导入配置，并通过系统的 VPN 服务接管设备流量。适合使用 Xray 扩展协议与相关传输参数的配置。
v2flyNG
面向 Android 的 V2Fly 内核客户端，界面操作与常见安卓代理客户端接近。适用于明确要求 V2Fly 内核的配置场景，可作为按内核类型选择的备选。导入前仍需核对协议、传输方式与安全参数。
教程动态
查看全部文章 →
配置原理与排查记录
文章按安装、内核、测速和多设备管理展开，重点说明设置之间的因果关系。
V2Ray 速度慢分层排查：先测节点、再查线路、最后调本地设置
按节点本身、中间线路、本地配置三层定位瓶颈。通过更换节点、错峰对照和逐项检查路由及内核设置，避免同时修改多个变量后无法判断原因。
阅读全文多设备同步 V2Ray 配置的三种方案：订阅链接、导出导入与二维码分享
对比集中维护订阅、传递配置文件和二维码分享三种方式，说明桌面 v2rayN 与安卓客户端之间可以同步哪些字段，以及哪些本地设置需要分别完成。
阅读全文延迟测试数字怎么看：ICMP ping、真连接延迟与下载测速的区别
解释三类测试各自覆盖的网络环节，说明为何短往返时间不等于高吞吐，也不代表代理握手一定成功，并给出按问题类型选择测试方法的顺序。
阅读全文首次配置从哪里开始
先完成客户端安装与订阅导入，再选择当前服务器，最后开启系统代理并验证访问。遇到问题时保留日志中的时间和错误阶段，按教程步骤回查。