客户端下载 · 协议配置参考

V2Ray中文社区 客户端下载

下载v2rayN 查看教程

从开源客户端到订阅导入，按设备选择入口，按服务端参数核对协议与安全层，再设置系统代理与路由。

  • 协议 / 安全层
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY
Windows Android macOS Linux

按平台选择客户端

桌面端先看 v2rayN，安卓设备先看 v2rayNG；需要沿用 V2Fly 内核配置时，再考虑 v2flyNG。客户端负责管理配置，连接能力由内核与服务端共同决定，下载前不必只凭协议名称猜测兼容性。

Windows

使用 v2rayN 管理桌面订阅；下载页区分跨平台桌面版与经典 WPF 版，按界面习惯和运行环境选择。

前往下载

macOS

选择 v2rayN，并在“关于本机”确认芯片类型；Apple Silicon 与 Intel 对应不同安装入口。

前往下载

Android

优先选择基于 Xray 的 v2rayNG；需要 V2Fly 配置兼容性的用户可查看 v2flyNG，并核对设备架构。

前往下载

Linux

v2rayN 提供桌面图形配置入口；按发行版选择 deb 或 rpm，再核对处理器是 x64 还是 arm64。

前往下载

同一客户端的不同安装入口不代表不同的服务套餐。安装客户端之后，还需要自行准备有权使用的服务端配置或订阅链接；本网站提供客户端与配置说明，不提供可直接连接的节点。已有订阅的用户，应先确认提供方注明的客户端要求，再选择对应平台的软件。

如果准备从旧客户端迁移，建议先保留原配置与路由记录，使用单个已知可用的配置完成测试，再导入其余订阅。一次迁移所有分组、改动 DNS 并启用虚拟网卡，会让故障来源难以区分。下载页集中说明安装入口和架构区别，详细的操作顺序则放在教程中。

查看全部客户端 →

协议与配置边界

核对协议参数，区分流量入口

导入成功只说明配置被识别，不代表连接条件已经满足。订阅获取、出站握手、路由选择与程序流量接管是不同环节，排查时一次只改变一个条件。

先让订阅地址可访问

订阅更新是获取远程配置，不是自动建立代理连接。先在订阅分组中保存完整地址，再按当前网络条件选择更新方式；已有可用连接时，可尝试通过代理获取。若列表为空，先检查链接是否过期、响应是否为配置内容，再核对协议字段。与只导入单条分享链接相比，订阅分组便于后续同步变更，但更新可能覆盖远程管理的项目，手工调整应另存副本。

首次使用尚无可用连接时，不要把“通过代理更新”作为唯一获取方式。

从安装到验证

订阅导入的三步顺序

查看完整教程 →

先确认配置来源，再检查连接，最后扩大接管范围。下面的顺序适用于初次使用，也适合迁移配置时建立一个容易排查的起点。客户端的菜单名称可能随界面调整，但这三个环节的依赖关系不变。

  1. 安装客户端，保存订阅分组

    从下载中心进入设备对应的平台，按处理器架构选择安装入口。桌面端使用 v2rayN，安卓端优先使用 v2rayNG。首次启动后，先检查程序能否正常打开、内核能否启动，再进入订阅管理新增分组。把提供方给出的完整订阅地址粘贴到地址栏，并为分组取一个便于识别的名称。

    订阅链接与网页地址不一定相同。登录页面、说明页面或需要交互验证的页面，通常不能直接当作订阅导入。复制时注意不要带入前后空格、换行或聊天软件附加的标点。订阅地址可能包含访问凭据，排查时不要把完整链接发布到公开评论或截图中。

    保存分组后执行更新，确认列表中出现可识别的配置。只有单条分享链接时，应使用相应的导入功能，而不是强行填入远程订阅地址栏。具体入口见订阅准备与导入说明。

  2. 选择配置，设置流量入口

    从已导入的列表中选择一条配置作为活动出站，核对地址、端口与协议是否完整。v2rayN 中先使用系统代理方式进行验证；已有浏览器手动代理设置时，还需要确认浏览器究竟遵循系统代理，还是继续使用自己的固定端口。两个入口同时存在，容易出现客户端已切换、浏览器仍走旧配置的情况。

    安卓端启动连接时，需要确认系统给出的 VPN 连接授权。授权只说明允许客户端建立本地流量通道，不代表远程服务已经连通。若使用按应用接管，应检查测试程序是否在接管范围内。不要把系统出现连接标识当作订阅有效或远程握手成功的证据。

    这一阶段优先使用明确的路由预设，暂缓添加复杂例外。桌面导入过程见v2rayN 订阅导入，安卓操作见v2rayNG 订阅导入。

  3. 验证实际请求，再调整分流

    使用一个明确需要经过所选出站的请求进行测试，同时确认普通直连访问与局域网访问仍符合预期。客户端内的连通性测试、浏览器实际访问和其他应用请求属于不同验证范围；其中一个成功，不能自动证明其他程序也采用了同样的流量入口和 DNS 路径。

    连接失败时，先分辨是订阅无法获取、内核启动失败、远程握手失败，还是请求没有进入客户端。查看相关日志时保留错误类型与发生顺序，隐藏订阅地址、认证字段和个人网络信息。若改动了路由或 DNS，记录改动前的值，逐项恢复对照，比反复重装客户端更容易找到原因。

    普通代理验证通过后，再按需要启用 TUN 或设置应用范围。退出客户端后也应检查系统代理是否恢复，避免程序停止监听后，其他应用仍把请求发向本地端口。进一步排查可查看疑难解答，无需同时更换协议、内核和路由。

开源生态与维护边界

Project V、V2Fly 与 Xray

V2Ray 是生态名称，也是理解协议与内核关系的起点。图形客户端、连接内核、远程服务与订阅提供方各有职责，把这些层次分开，才能判断一项功能应在哪里配置、一次更新可能影响什么。

CLIENTv2rayN / v2rayNG / v2flyNG

订阅管理、界面操作与配置组织

COREXray / V2Fly

协议实现、连接处理与路由执行

Project V：从协议集合到配置体系

Project V 以 V2Ray 为核心，形成了围绕入站、出站、传输与路由组织网络连接的配置思路。VMess 是其中具有代表性的协议，但 V2Ray 并不等于只有 VMess，也不能把所有相关客户端都理解为同一个程序。一个图形界面中看到多个协议选项，通常意味着客户端能够为底层内核生成多种配置，并不意味着每种组合都适用于现有服务端。

对日常使用者而言，最有用的概念是分层：本地程序把请求交给入站，路由规则决定采用哪个出站，出站再使用约定的协议与安全层连接远程服务。任何一层不匹配，都可能表现为“网站打不开”。因此，协议选型需要结合完整配置，而不是脱离服务端只比较某个名称是否更新。

V2Fly 与 Xray：有关联，不是任意互换

V2Fly 延续 V2Ray 的社区维护，Xray 从相关代码基础发展出另一条内核路线。两者有共同的配置背景，也有各自演进的功能和参数。涉及 VLESS、REALITY 及特定流控组合时，尤其需要核对具体内核支持；同名协议能被识别，不代表服务端所用的全部扩展都能被另一个内核接受。

订阅导入通常还会经过客户端自身的格式解析与配置转换。即便两个客户端使用相近的内核，分享链接字段、默认值或传输选项的处理仍可能不同。更换内核之前，先查看提供方要求的协议组合，并保留原始配置。需要理解 VMess 的适用条件、时间同步要求与协议差异时，可以继续阅读VMess 协议参考。

三款客户端：图形管理与内核选择

v2rayN 面向桌面平台，提供订阅分组、活动配置、系统代理与路由等图形管理入口，可使用其支持的内核。v2rayNG 面向安卓设备，采用 Xray 内核；v2flyNG 则是采用 V2Fly 内核的安卓备选。选择安卓客户端时，应先看服务端要求与参数兼容性，再考虑界面习惯，不宜把两款客户端视为只换了名称的同一安装包。

这三款客户端均以 GPL-3.0 许可证发布。开源许可证说明代码使用、修改与分发的条件，但不代替对订阅来源、远程服务或实际网络行为的判断。内核也有各自的许可范围，例如 V2Fly 与 Xray 的核心代码采用 MPL-2.0；涉及再分发时，还应分别阅读对应组件的许可证与附带声明，而不是仅依据客户端的名称推断。

更新管理：客户端、内核与订阅分别检查

客户端更新可能调整界面、导入逻辑与配置生成方式；内核更新影响实际协议实现；订阅更新则替换远程提供的配置内容。这三类更新解决的问题不同。遇到订阅到期，升级客户端通常不能恢复服务；遇到内核不识别的字段，仅重复更新订阅也未必有效。先确定故障所在层次，再选择对应的处理动作。

准备更新时，先备份订阅分组、手工出站与自定义路由，记录当前使用的内核类型。更新后用原来已知可用的配置进行对照，再尝试新功能。移动设备还应关注后台运行限制与省电策略：电量表现不仅受协议影响，也取决于连接数量、DNS 请求、信号状况和应用行为，不能仅凭协议名给出固定的耗电排名。

操作记录与配置说明

近期技术文章

查看全部文章 →

按当前遇到的问题选读：初装先确认目录、权限与代理模式，订阅更新问题先区分地址访问和内容解析，路由器部署则需要另外考虑设备资源与网络拓扑，不宜直接照搬桌面客户端的操作。