桌面客户端
前往下载
Windows
Windows 用户使用 v2rayN，可在新一代桌面界面与经典 WPF 界面之间选择。前者的界面结构与其他桌面平台更接近，后者适合已经熟悉传统菜单和托盘操作的用户。安装完成后先导入订阅，再设置系统代理或按需要开启 TUN 模式。
客户端下载入口
按当前设备选择安装包
桌面平台统一使用 v2rayN，Android 可在 v2rayNG 与 v2flyNG 之间选择。下载页会按照处理器架构和安装格式拆分入口，这里先确定平台，避免把不适用的文件带入后续安装步骤。
桌面客户端
前往下载
macOS
macOS 使用 v2rayN 桌面版，下载前需要先确认设备使用 Apple Silicon 还是 Intel 处理器。处理器架构只影响安装包选择，不改变订阅格式和路由配置。首次运行后建议先完成系统权限确认，再导入订阅并验证浏览器是否遵循系统代理。
移动客户端
前往下载
Android
Android 首选 v2rayNG，其内核路线和界面操作适合常见订阅配置；需要使用 V2Fly 内核时可选择 v2flyNG。多数较新的设备可使用 arm64 安装包，无法确认架构时再使用通用安装包。连接前还要允许客户端创建本地网络连接。
桌面客户端
前往下载
Linux
Linux 使用 v2rayN，并按发行版的软件包体系选择 deb 或 rpm，再按设备架构区分 x64 与 arm64。安装后如果图形界面能够启动但应用流量没有进入客户端，应分别检查桌面环境的代理设置、终端环境变量和 TUN 所需权限。
配置重点
从订阅内容到实际流量路径
客户端显示连接状态，只能说明核心进程已经进入运行阶段。要判断配置是否完整，还需要继续检查订阅内容、活动服务器、代理接管方式、路由命中结果与运行日志。下面四个主题对应最常见的配置链路。
先确认订阅地址与分组，再把服务器列表更新到本地。
规则按顺序匹配，第一条命中规则决定请求的出站方式。
先用系统代理完成基础验证，再按应用范围决定是否开启 TUN。
状态栏只给出结果，运行日志才记录连接失败发生在哪一步。
先验证基础链路，再增加规则
首次配置时，建议只保留一个明确可用的服务器，使用最简单的系统代理方式完成连接验证。确认浏览器请求已经通过客户端后，再加入路由规则、DNS 策略和 TUN 等设置。若一开始就同时修改订阅、内核、路由和接管方式，出现问题时很难判断是哪一项造成影响。
把配置变化控制在可追踪范围
每次只修改一组相关选项，并记录修改前后的现象。例如更换服务器后只观察连接结果，调整路由后只检查命中与出站，开启 TUN 后重点检查权限和 DNS。这样的操作节奏虽然多一步确认，却能显著减少重复安装和无方向切换配置的时间。
快速上手
从安装到验证的三个步骤
下面是完整教程的精简路径，适合已经准备好订阅链接的用户。每一步都包含一个明确的检查点：客户端能启动、服务器列表能更新、实际请求能通过代理。检查点通过后再进入下一步。
选择平台并完成安装
进入下载中心后，先按操作系统切换平台。Windows 可根据界面习惯选择桌面版或经典 WPF 版；macOS 需要按处理器选择安装包；Android 可按内核路线选择 v2rayNG 或 v2flyNG；Linux 则根据发行版包管理体系与处理器架构选择文件。安装完成后先启动客户端，确认主界面、托盘菜单或连接权限能够正常使用。
如果系统阻止首次运行，应从系统提供的应用权限入口确认文件来源与运行权限，不要通过反复解压或重复安装绕过问题。Linux 环境还要确认桌面组件和安装依赖是否完整。此阶段暂不修改复杂路由，目标只是让客户端稳定启动并能进入设置界面。
导入订阅并选择服务器
在订阅分组中新增链接，保存后对该分组执行一次手动更新。更新成功应当能看到服务器条目；如果分组存在但列表为空，先检查链接是否完整，再确认更新动作作用于正确分组。列表出现后选择一个服务器作为活动项，并使用真连接测试或直接访问验证，不要仅依赖网络层面的简单响应结果。
订阅内容可能包含多个协议和传输组合，客户端会根据配置调用对应内核能力。用户通常不需要手工改写每个字段，但服务器端与客户端参数必须保持一致。若日志提示认证、地址或传输参数错误，应回到订阅来源确认配置，而不是通过随机切换本地选项尝试碰撞结果。
启用代理并确认流量生效
桌面端可先启用系统代理，让遵循系统设置的浏览器和应用使用客户端。Android 端连接时需要确认系统网络连接授权。随后打开一个未缓存的页面进行验证，并同时观察客户端日志是否出现对应请求。能够看到请求进入正确出站，才说明从应用、系统代理到客户端核心的链路已经打通。
如果浏览器可用而命令行工具不可用，通常说明两者读取代理设置的机制不同；如果开启 TUN 后全部请求异常，则应检查权限、DNS 和路由冲突。不要只看客户端的连接图标，最终判断应由实际访问、日志记录和路由命中结果共同完成。
生态与内核
Project V、V2Fly 与 Xray 的关系
客户端名称、内核名称和协议名称经常同时出现。理解三者的层级后，下载与排错会更直接：图形客户端负责交互和配置管理，内核负责网络处理，协议与传输参数则描述客户端和服务端如何通信。
从 Project V 生态理解客户端结构
Project V 形成了一套围绕代理协议、路由能力和网络传输的工具生态。随着项目演进，V2Fly 延续了 V2Ray 相关实现与社区维护，Xray 则在同一技术脉络上发展出不同的功能侧重和更新节奏。两条内核路线共享不少概念，但具体协议能力、配置字段和实现进度可能并不完全同步。
v2rayN、v2rayNG 与 v2flyNG 属于图形客户端，不等同于底层内核。它们负责订阅管理、服务器列表、系统代理、路由设置和日志展示，再把整理后的配置交给内核运行。因此，界面显示正常并不代表所有内核参数都有效；遇到连接问题时，需要同时核对客户端设置、当前内核与服务器配置。
这种分层结构也解释了为什么同一份订阅在不同客户端中的展示可能略有差异。客户端会按照自身界面模型读取配置，内核再按照支持范围执行。选择客户端时，应优先考虑当前操作系统、需要的内核路线与使用习惯，而不是把所有产品名称视作完全相同的替代项。
v2rayN：桌面端配置入口
v2rayN 覆盖 Windows、macOS 与 Linux，提供订阅分组、服务器选择、系统代理、TUN、路由与日志等图形化设置。桌面平台之间的安装格式不同，但订阅导入和基础配置逻辑保持一致，适合需要在多台桌面设备上复用操作流程的用户。
v2rayNG：Android 与 Xray 路线
v2rayNG 面向 Android，通常与 Xray 内核路线配合。界面围绕移动设备的连接授权、服务器切换、路由与按应用处理展开。移动网络切换频繁，排错时除了配置本身，还要关注 Wi-Fi 与蜂窝网络变化、后台限制和系统网络授权。
v2flyNG：Android 与 V2Fly 路线
v2flyNG 同样面向 Android，主要区别在于采用 V2Fly 内核路线。若订阅配置明确依赖 V2Fly 的实现方式，或用户希望保持该内核体系的一致性，可以选择 v2flyNG。选型时应以服务端配置和实际协议需求为准。
开源协议与代码审阅
这些项目以开源方式维护，许可证会规定代码使用、修改和再分发条件。开源属性的实际价值在于实现细节可以被审阅，问题能够围绕具体代码和配置讨论，衍生客户端也需要遵循相应许可。用户仍应从明确的下载入口获取适合自己平台的构建，并阅读版本说明和配置变化。
社区维护与更新节奏
图形客户端和底层内核由不同项目维护，发布节奏不必完全一致。客户端更新可能调整界面、安装方式或配置转换逻辑，内核更新则可能改变协议实现、路由行为和参数支持。出现升级后的行为差异时，应先判断变化属于客户端层还是内核层，再决定回看设置、日志或订阅内容。
协议支持不是单一标签
协议名称只是配置的一部分，地址、端口、身份参数、传输方式、TLS 相关设置和路由动作都可能影响连接。即使两个客户端都列出同一协议，也应确认它们调用的内核、参数支持范围与配置格式。遇到兼容问题时，从完整配置链路检查比只比较协议名称更有效。
常见问题精选
安装之后先检查哪些位置
多数首次配置问题集中在订阅未更新、活动服务器未选择、应用没有读取系统代理，以及路由或 DNS 改动过多。下面四个入口给出判断方向，相关概念可在术语手册中继续查阅。
订阅导入后为什么没有服务器？
先确认订阅分组已经保存，再手动更新该分组并查看日志。分组名称存在只代表链接记录已经建立，不代表订阅内容已经成功下载和解析。若日志出现请求错误，应检查链接完整性与当前网络；若下载完成但解析失败，则要核对订阅格式。
查看订阅与节点术语 →系统代理开启后为什么部分程序不生效？
不同程序读取代理设置的方式并不一致。浏览器通常会遵循系统代理，部分终端工具、开发环境和独立网络程序则需要自己的代理参数，或者需要通过 TUN 接管。应先区分是单个程序未接入，还是所有流量都未经过客户端。
查看系统代理与 TUN →测试显示可用，网页仍然打不开怎么办？
测试结果只能覆盖某一段连接过程。继续检查系统时间、DNS、路由命中、活动服务器和应用代理设置，并清空日志后重新发起一次访问。若日志没有对应请求，问题多半发生在应用到客户端之间；若已有请求和报错，再按关键词定位内核或配置。
查看日志与排错术语 →什么时候需要开启 TUN 模式？
当目标应用不读取系统代理，或需要统一处理更广范围的网络流量时，可以考虑 TUN。开启前应先通过系统代理验证基础连接，之后再处理权限、DNS 和局域网路由。这样能够把服务器配置问题与流量接管问题分开判断。
查看路由与分流术语 →
教程动态
近期配置与排错文章
文章围绕实际操作中的单一问题展开，分别说明检查顺序、日志依据和配置项之间的关系。遇到具体故障时，可以先按标题选择最接近的场景，再回到完整文档补充相关概念。
代理已连接但无法上网：v2rayN 与 v2rayNG 逐项排查清单
按服务器可用性、系统时间、DNS、路由规则和系统代理五个环节逐项检查，区分连接状态与实际请求是否成功经过客户端。
阅读全文 →v2rayN 运行日志怎么看：常见报错信息含义与定位思路
解释 rejected、timeout、invalid user 等常见日志关键词，并说明如何从报错时间、目标地址和出站标签定位到具体配置项。
阅读全文 →Xray 与 V2Fly 内核区别详解：版本关系梳理与客户端选择
梳理两个内核在 Project V 技术脉络中的关系，再对应到 v2rayN、v2rayNG 与 v2flyNG 的平台和内核选择。
阅读全文 →