Windows
桌面端优先选择 v2rayN。新一代桌面界面适合常规安装，经典 WPF 版适合需要传统操作布局的用户。两种版本都可管理订阅、路由与系统代理。
前往下载CLIENT WORKBENCH
客户端工作台：从订阅到内核日志
常见操作集中在五个位置：订阅分组、路由模式、系统代理、内核选择和日志窗口。先辨认设置所在层级，再修改具体参数，比反复导入配置更容易定位问题。
- 分组名称常用订阅
- 自动更新
- 更新入口订阅分组
订阅地址与节点分开管理
订阅是由服务端维护的一组配置入口，客户端更新订阅后才会把其中的节点、协议与传输参数写入本地。实际使用时应先创建有明确名称的分组，再粘贴完整订阅地址并执行更新。更新失败时不要连续重复点击，应先查看提示属于网络访问失败、返回内容格式不符，还是地址已经失效。分组管理的价值在于保留来源边界：多个订阅互不覆盖，停用某一组也不会影响其他配置。手工添加的单个节点则适合临时测试，不应与长期维护的订阅混在同一分组中。
- 域名策略IPIfNonMatch
- 局域网地址direct
- 未命中规则proxy
路由规则决定每个请求的出口
路由分流不是简单的开关，而是一组按顺序匹配的规则。客户端可依据域名、IP、端口或协议类型，把请求交给代理出口、直连出口或阻断出口。规则越具体，越应放在列表前面；范围较大的兜底规则放在末尾。修改后要同时观察域名解析方式，因为只写 IP 规则而没有合适的域名策略，可能导致规则始终无法命中。对于日常配置，先使用客户端内置的稳定规则集，再逐条添加确有需要的自定义项，比一次导入大量来源不明的规则更便于维护和排错。
- 代理模式自动配置
- 允许局域网连接
- 本地监听127.0.0.1
系统代理与内核运行是两个状态
内核成功启动只代表本地代理端口已经监听，系统中的应用是否使用该端口，还取决于系统代理设置或应用自身的代理选项。浏览器可以访问而某个独立程序无法连接时，应检查该程序是否读取系统代理；所有程序都无法连接时，再检查内核日志、本地端口和当前节点。允许局域网连接会改变监听范围，只有确实需要让同一网络中的其他设备接入时才应启用，并同步确认操作系统防火墙规则。理解这两个层级，可以避免把系统代理未开启误判成节点或协议配置错误。
- 当前内核Xray
- 配置检查启动前执行
- 运行日志info
客户端负责界面，内核负责协议执行
v2rayN、v2rayNG 与 v2flyNG 提供订阅、节点和系统代理等图形操作，真正读取配置并建立连接的是底层内核。Xray 与 V2Fly 具有共同的生态来源，但维护方向、协议扩展和部分字段支持并不完全相同。选择内核时应以节点配置要求为准，而不是只比较名称。若配置包含特定流控、传输或安全字段，客户端必须配合支持这些字段的内核；普通配置则更应关注客户端与内核组合是否稳定。切换内核后需要重新启动连接，并从启动日志确认实际加载的是目标内核。
loading config: config.json
routing: domainStrategy=IPIfNonMatch
inbound: socks / http
outbound: proxy / direct先看第一条明确错误，再处理后续连锁提示
配置解析失败、端口占用、域名解析异常和 TLS 握手失败会留下不同的日志线索。排查时应从一次全新启动开始，找到最早出现的 error 或 failed 行，并结合它前后的配置字段判断原因。JSON 语法错误通常会指出行列位置；端口占用会出现监听失败；证书与握手问题则要检查系统时间、serverName、SNI 和传输参数。后续大量重复日志往往只是第一处故障造成的连锁结果。保留原始报错文字并逐项修改，比同时调整节点、DNS、路由和内核更容易确认是哪一步恢复了连接。
PLATFORM ENTRY
按系统选择客户端与安装包
平台页面集中展示适用客户端、安装格式与架构选择。首页不直接分发文件，进入对应平台后再根据设备类型选择具体安装包。
macOS
macOS 使用 v2rayN 桌面客户端。下载前先在系统信息中确认处理器类型，再选择 Apple Silicon 或 Intel 对应安装包，避免安装格式与设备架构不匹配。
前往下载Android
Android 可在 v2rayNG 与 v2flyNG 之间选择。前者采用 Xray 内核路线，后者采用 V2Fly 内核路线；多数近年设备可选 arm64，无法确认架构时使用通用安装包。
前往下载Linux
Linux 桌面端使用 v2rayN，可按发行版的软件包体系选择 deb 或 rpm，并根据处理器架构选择 x64 或 arm64。安装后仍需在桌面会话中设置系统代理。
前往下载OPEN SOURCE ECOSYSTEM
Project V、V2Fly 与 Xray 的关系
客户端、内核、协议与订阅不是同一个层级。理解各自职责后，才能判断一次故障应当检查图形界面、配置文件，还是底层协议实现。
从 Project V 生态到两条内核路线
Project V 形成了一套以配置驱动的网络工具生态。早期 V2Ray 项目确立了入站、出站、路由、DNS、策略和传输层等核心配置结构，随后社区维护逐步形成 V2Fly 与 Xray 两条常见内核路线。两者在大量基础概念上相通，例如都以 JSON 配置描述监听入口、远端出口与匹配规则，但在新增协议、传输特性、字段扩展和版本演进节奏上各有侧重。
因此，“V2Ray 客户端”通常指管理这类内核与配置的图形工具，而不是单一程序名称。v2rayN 负责桌面端的订阅、节点、路由、系统代理和内核启动；v2rayNG 与 v2flyNG 负责 Android 端的配置管理。图形客户端会把用户操作转换成内核可读取的配置，再启动本地监听端口。连接是否成功最终取决于订阅内容、协议参数、传输层设置、域名解析、系统时间和本地网络环境共同作用。
开源协议与社区维护意味着什么
代码开源使协议实现、配置结构与客户端行为能够被公开讨论和持续改进，但不同项目的发布节奏并不一致。客户端升级可能带来新的界面或配置生成逻辑，内核升级则可能增加协议字段、修复兼容问题或调整默认行为。更新前应先阅读变更说明，保留可用配置，并确认现有订阅是否依赖特定内核功能。稳定使用不等于追逐每一次更新；出现明确兼容需求、错误修复或系统适配变化时再升级，通常更容易控制变量。
开源许可还规定了代码复制、修改与再分发的边界。普通用户更需要关注的是项目名称与安装包来源是否对应、客户端实际调用哪一种内核，以及配置中是否包含该内核支持的字段。本站的教程把客户端操作与内核概念分开讲解：入门步骤聚焦可见界面，配置大全解释 JSON 各段含义，术语表用于查找协议与网络基础概念，故障文章则从日志表现回溯到具体设置。
桌面客户端
覆盖 Windows、macOS 与 Linux，集中处理订阅分组、节点选择、系统代理、路由规则和内核管理。适合需要图形化维护多组配置的桌面环境。
Android · Xray 路线
采用 Xray 内核路线，提供订阅更新、配置导入、路由设置和连接日志。包含特定 Xray 扩展字段的配置通常优先使用这一组合。
Android · V2Fly 路线
采用 V2Fly 内核路线，界面操作与常见订阅流程相近。选择时应以配置要求和内核兼容范围为依据，不需要同时安装两种客户端。
订阅更新失败先检查什么？
先确认地址完整且仍可访问，再查看返回内容是否为客户端能够识别的订阅格式。网络错误、地址失效与格式错误应分别处理，不要直接删除所有本地配置。
查看订阅导入步骤 →DNS 与路由为什么要一起看？
域名规则是否命中，可能受到解析位置与域名策略影响。只调整 DNS 或只调整路由都可能掩盖真正原因，应从请求域名、解析结果和最终出口三个环节核对。
查看 DNS 与 routing 配置 →Xray 与 V2Fly 怎么选？
先看订阅或手工配置使用了哪些协议、流控与传输字段，再选择能够完整解析这些字段的内核。基础配置通常都能理解，扩展功能则需要逐项确认。
查看内核与协议术语 →连接失败为什么先看日志？
日志能区分配置解析、端口监听、DNS、连接超时与握手错误。每次只修改一个变量，并从一次全新启动记录首条错误，排查路径会更清晰。
查看配置排错参考 →LATEST NOTES
配置与故障排查文章
围绕内核启动、协议原理和 TLS 报错整理可复用的检查顺序。文章中的配置片段用于解释字段关系，实际参数应以自己的订阅或服务配置为准。
V2Ray 内核启动失败怎么办：通过日志定位 config.json 配置错误
从客户端日志窗口入手，按 JSON 语法错误、端口占用、字段拼写和协议参数缺失四类高发原因解读典型报错行，并给出逐条修正与重新启动的判断标准。
阅读全文 →REALITY 协议与 XTLS Vision 科普：握手原理与性能优势解析
解释 REALITY 的握手特征与 XTLS Vision 减少重复加密开销的流控思路，并说明客户端、内核与节点配置之间必须对应的关键字段。
阅读全文 →V2Ray TLS 证书报错排查清单：系统时间不同步与 SNI 配置详解
针对 certificate invalid、handshake failed 等常见提示，按系统时间偏差、serverName 不匹配与证书链问题整理检查顺序。
阅读全文 →