Windows
v2rayN
提供 Desktop 桌面版与经典 WPF 版入口。前者采用新一代跨平台界面，后者保留经典操作方式。先确认系统与处理器条件，再阅读对应安装说明；首次配置建议只启动一个实例，避免本地监听端口冲突。
前往下载 →先选平台桌面端查看 v2rayN；安卓端比较 v2rayNG 与 v2flyNG。客户端负责管理配置，实际连接还需要可用的节点参数或订阅地址。
平台下载入口
安装包与处理器架构按设备选择
macOS
v2rayN
按芯片选择 Apple Silicon 或 Intel 安装包，可在“关于本机”中确认。安装后先完成系统允许的应用启动流程，再导入订阅。启用系统代理后，需要检查浏览器是否使用系统设置，不能仅凭客户端已运行判断连接生效。
前往下载 →Android
v2rayNG / v2flyNG
v2rayNG 使用 Xray，v2flyNG 作为 V2Fly 内核备选。安装包按 arm64 与通用版区分，优先依据设备架构选择。首次连接需要确认系统 VPN 授权；已有其他 VPN 应用运行时，先处理接口占用，再测试节点。
前往下载 →Linux
v2rayN
按发行版的软件包体系选择 deb 或 rpm，再区分 x64 与 arm64。图形界面的系统代理设置不一定被所有应用读取，终端程序还可能使用独立环境变量。安装完成后先验证浏览器，再分别检查需要代理的其他程序。
前往下载 →安装包格式解决“能否安装”，处理器架构决定“能否运行”，节点与内核兼容性决定“能否连接”。三项分开核对，比反复更换客户端更容易定位问题。升级前保留订阅分组、路由设置与自定义配置，升级后先用原有节点完成一次连接测试，再启用新增功能。
查看全部客户端 →规格表式特性
订阅、路由与日志按设置项查阅
"outbounds": [{ "protocol": "vless" }]订阅地址与节点列表
订阅用于批量获取节点，分享链接通常描述单个节点，原生 JSON 则可能包含完整的入站、出站与路由。三款客户端均提供订阅导入入口，但能解析的协议与字段仍取决于客户端和内核。导入后先更新订阅，确认分组中出现节点，再选择活动项。上方片段是内核出站键名，不是订阅地址格式；遇到导入失败时，应先核对来源格式与更新日志，不要直接把完整配置粘进地址栏。
v2rayNv2rayNGv2flyNG
"routing": { "domainStrategy": "AsIs" }匹配顺序与兜底出站
路由分流根据域名、目标 IP 等条件选择出站，通常按规则顺序处理。三款客户端可使用各自界面与内核支持的规则配置，但预设名称和编辑方式并不完全相同。先保留局域网访问，再安排具体域名规则，最后检查未命中流量的去向。规则引用 geosite 或 geoip 时，还要确认数据文件存在。切换为全局代理适合缩小排查范围，却不能替代日常分流；测试后应恢复目标模式并复查日志。
v2rayNv2rayNGv2flyNG
"inbounds": [{ "listen": "127.0.0.1", "protocol": "socks" }]应用流量如何进入内核
系统代理向遵循系统设置的应用提供本地代理入口，TUN 则通过虚拟网络接口接收流量。v2rayN 的 TUN 可用性、权限与配置方式应按平台和所用内核核对，不能把一个系统的操作直接套到另一个系统。v2rayNG 与 v2flyNG 使用 Android VPN 接口，不是桌面系统代理开关。首次测试宜只启用一种接管方式；连接正常后再检查应用范围、局域网例外和权限，避免同时开启多种方式导致路由难以判断。
v2rayN · 平台相关v2rayNG · VPN 接口v2flyNG · VPN 接口
"outbounds": [{ "protocol": "vmess" }]客户端界面与内核运行能力
客户端负责配置管理，内核负责协议处理，两者不能视为同一层。v2rayN 可管理多种内核，具体选择取决于安装内容、节点类型与客户端设置。v2rayNG 以 Xray 为内核，v2flyNG 以 V2Fly 为内核，后两者不应当作通用多内核切换器。更换内核前，应核对传输方式与字段兼容性，并保留可工作的配置。相同的协议名称不代表所有扩展参数都能互用；出现未知字段时，优先检查配置来源及内核支持范围。
v2rayN · 多内核v2rayNG · Xrayv2flyNG · V2Fly
"dns": { "servers": ["localhost"] }域名解析与流量路由配合
DNS 设置决定域名如何解析，路由规则决定连接如何发出，两者需要配合检查。先确认错误发生在节点服务器域名，还是目标网站域名，再核对解析器的访问路径。三款客户端使用各自内核的 DNS 配置能力，界面开关与 JSON 字段不能完全等同。上方仅展示键名和本地解析写法，不是通用分流方案。浏览器加密 DNS、系统私有 DNS 与客户端内置 DNS 可能同时参与解析，测试时应一次只调整一个变量，并记录结果。
v2rayNv2rayNGv2flyNG
"log": { "loglevel": "warning" }从第一条错误定位故障层
日志排查先区分内核未启动、节点连接失败与应用未走代理。内核未启动时，优先阅读第一条错误，检查端口占用、配置语法和数据文件；连接超时则继续检查节点地址与网络可达性。三款客户端均可用于查看运行信息，但日志入口和详细程度有所差别。必要时临时提高日志级别，重现一次问题后恢复。分享日志前应移除订阅地址、身份标识与节点凭据，只保留错误上下文，避免把完整配置作为公开排查材料。
v2rayNv2rayNGv2flyNG
这些设置分别作用于配置来源、匹配规则、流量入口、执行内核与域名解析。排查时不要一次改动全部选项：先证明节点可以连接，再检查应用是否进入代理，最后验证分流与 DNS 是否符合预期。每完成一层就保留测试结果，后续调整才有可对照的基线。
查阅全平台安装配置大全 →三步上手预览
从订阅到连接验证保留可复查的操作顺序
01 / IMPORT
导入订阅，检查分组
安装客户端后，先准备可用的订阅地址或节点分享链接。在订阅管理中新增分组、填写地址并更新，确认节点数量与名称确实发生变化。剪贴板导入适合分享链接，订阅管理适合后续持续更新，两种入口不要混用。
更新失败时先查看提示，判断是地址无法访问、内容格式不匹配，还是订阅本身已失效。客户端安装成功不等于已经具备可连接节点；空列表应先解决配置来源，而不是反复切换代理模式。
02 / CONNECT
选择节点，启用入口
选中一个节点作为活动配置，再使用客户端提供的真连接测试确认可达性。地区名称只能帮助整理列表，不能证明线路可用。测试有结果后，在桌面端启用系统代理，或在安卓端启动连接并完成 VPN 授权。
首次连接先采用容易理解的路由预设，保留局域网访问。不要同时启用其他代理应用、浏览器手动代理与多个虚拟接口；入口越少，越容易判断哪个设置真正改变了应用的访问路径。
03 / VERIFY
验证网页，复查出口
用浏览器访问预期经代理打开的页面，再检查出口 IP 与客户端日志。页面可打开只是一个信号，还需要确认请求确实命中目标出站。若开启分流，直连网站与代理网站的出口可能不同，这是规则结果，需要分别验证。
浏览器正常而其他应用失败时，应检查该应用是否读取系统代理，而不是立即更换节点。若所有应用均失败，先回到节点连接测试与内核日志。每次只改一项，再重复同一组测试，才能建立明确的因果关系。
退出客户端前，先关闭系统代理或停止 VPN 连接，避免留下指向已停止服务的入口。再次启动后先确认活动节点仍然存在，再恢复连接。需要跨设备迁移时，优先迁移订阅来源与必要规则，不要把包含本地路径、监听端口和平台权限的完整配置直接覆盖到另一台设备。
查看完整教程 →Project V · V2Fly · Xray
内核家族与图形客户端区分项目、协议与配置
PROJECT V
V2Ray 是生态关键词，不是单一界面
Project V 是围绕网络代理工具与模块化配置形成的开源生态，V2Ray 是其中广为使用的项目名称。用户搜索“V2Ray 客户端”时，通常需要的是能管理节点、生成配置并控制连接的图形程序，而不是独立运行的内核文件。v2rayN、v2rayNG 与 v2flyNG 位于这一使用层，承担订阅管理、参数编辑和运行信息展示等工作。
理解这一区分后，故障也可以按层拆开：界面是否保存了设置、生成的配置是否被内核接受、系统或应用是否将流量交给入口。三个问题对应不同位置，不必把所有失败都归结为“客户端不能用”。
CORE FAMILY
V2Fly 与 Xray 具有共同技术背景
V2Fly 延续 V2Ray 相关项目的社区维护与演进；Xray 从相关代码基础发展，形成自身的功能与协议实现。两者在不少基础配置概念上相近，但随着独立演进，支持的字段、传输组合与扩展能力并非完全一致。节点配置必须与实际运行内核匹配，不能只看分享链接前缀就认定全部参数兼容。
v2rayNG 以 Xray 为内核，v2flyNG 以 V2Fly 为内核；v2rayN 的多内核管理提供桌面端选择空间。选择时应以现有节点要求为依据，而不是把内核名称理解为速度排名。网络路径、服务端条件与本地接管方式同样影响使用结果。
OPEN SOURCE
开源许可与组件边界分别查看
三款客户端均以开源方式提供代码，内核与图形界面属于不同项目。V2Fly 的 V2Ray 核心与 Xray 核心采用 MPL 2.0 许可，客户端本身及随附组件应分别遵循各自许可。开源意味着代码和许可可供查阅，不代表所有项目采用相同条款，也不代表任何配置文件都适合直接套用。
日常使用重点是理解配置含义；涉及修改、再分发或集成时，则应阅读对应组件的许可文本。订阅中的节点地址、身份参数与服务器安排由配置来源决定，不属于图形客户端自动提供的能力，安装软件与取得连接配置是两个独立步骤。
UPDATE PATH
应用、内核与规则数据分别更新
客户端更新可能调整界面、订阅解析和配置生成方式；内核更新可能改变协议支持与参数要求；规则数据更新则影响域名或 IP 集合的匹配结果。三者并不总是同时变化。更新前记录当前可工作的节点、代理入口和自定义规则，更新后使用相同目标重复验证，才便于发现变化发生在哪一层。
订阅更新只负责重新获取配置列表，不等同于应用升级，也不会自动修复本地权限和端口冲突。遇到问题时，先查明最近修改的是哪一部分，再决定回查订阅、调整内核或恢复规则。长期使用建议保留必要的设置记录，同时避免把包含凭据的配置放进公开文档。
桌面端需要统一管理多个节点与路由时，先查看 v2rayN；安卓端已有 Xray 配置时，先查看 v2rayNG；配置依赖 V2Fly 行为时，再核对 v2flyNG。客户端选型看平台、内核与维护方式，连接质量则需要在实际网络中测试，两者不应混为同一个结论。
按平台与内核比较三款客户端 →配置文章
DNS、路由与启动错误最近三篇技术记录
V2Ray 内核启动失败怎么办：读懂日志定位配置错误
汇总端口被占用、JSON 语法错误、未知协议字段、geo 文件缺失等典型报错，教你从 v2rayN 和 v2rayNG 日志里读出错误位置并逐项修正。
阅读文章 →v2rayN 路由规则实战：geosite 与 geoip 分流场景配置
从绕过局域网与中国大陆到全局代理，逐条讲解 domain、ip、outboundTag 的组合写法，附常见分流场景的规则顺序与自定义规则集示例。
阅读文章 →Xray DNS 模块详解：境内外域名分开解析与防 DNS 污染配置
拆解 dns servers、domains 匹配与 queryStrategy 等字段，演示让境内域名走本地解析、境外域名走远程 DNS 的写法，避开常见的解析污染与泄漏问题。
阅读文章 →刚完成订阅导入，可先按上手教程验证节点与系统代理；已有正常连接但分流结果不符合预期，再阅读路由和 DNS 文章。内核尚未启动时，应先处理日志中的配置错误，解析器和路由优化不能替代基础启动条件。
查看全部文章 →