客户端下载 · 首次配置清单

V2Ray下载中心 v2rayN 客户端下载

下载v2rayN 查看教程

选择开源客户端，导入订阅配置，再逐项设置路由与代理模式。

  • VMess
  • VLESS
  • Trojan
  • REALITY
图形客户端 v2rayN · v2rayNG · v2flyNG 内核家族 Xray · V2Fly 操作路径 订阅 → 路由 → 连接

先选安装包

按操作系统选择客户端

先确认系统与处理器架构，再进入对应下载分组。桌面端选择 v2rayN；安卓先看 v2rayNG，需要 V2Fly 内核时再了解 v2flyNG。订阅地址不随安装包提供，安装完成后仍需导入可用配置。

Windows

v2rayN

选择 v2rayN 桌面版或经典 WPF 版。桌面版使用跨平台界面框架，WPF 版面向 Windows；两种界面的按钮位置可能不同，订阅管理与代理配置的基本流程相通。

先查看系统类型是否为 x64，再阅读下载页的运行环境说明。首次安装后，先完成一次订阅更新和连接验证，不必同时调整 DNS、路由与 Tun，以免把安装问题和配置问题混在一起。

前往下载

macOS

v2rayN

选择 v2rayN 的 Apple Silicon 或 Intel 安装包。打开“关于本机”，查看显示的是芯片名称还是 Intel 处理器，再选对应架构，避免仅凭电脑外观判断。

按系统提示完成应用安装与首次打开。系统代理是否生效还取决于应用有没有读取代理设置；若浏览器可用而其他程序不能连接，先检查程序自身的网络选项，再考虑是否需要虚拟网卡接管。

前往下载

Android

v2rayNG

先选择使用 Xray 内核的 v2rayNG。多数较新的手机适用 arm64 包；不确定设备架构时，可查看系统信息或选择通用版。需要 V2Fly 内核时，下载页另列 v2flyNG 作为备选。

导入订阅后，选择一条配置，再点击连接并确认系统的 VPN 授权。授权表示允许客户端建立本地流量接管通道，并不代表远端配置一定可用。遇到后台断连，再检查省电限制与后台运行权限。

前往下载

Linux

v2rayN

选择 v2rayN 的 deb 或 rpm 包，并匹配 x64、arm64 架构。Debian、Ubuntu 系列通常使用 deb；Fedora 等发行版通常使用 rpm，具体以系统的软件包管理方式为准。

安装后先从桌面环境启动图形界面，确认配置能够加载。不同桌面环境对系统代理的读取方式可能不同，终端程序也可能需要独立设置代理。启用 Tun 前，先检查权限与现有网络服务是否冲突。

前往下载

查看全部客户端 →

逐项完成配置

订阅、分流与代理模式

按顺序处理入口、规则和接管范围。下方展示常见设置名称，属于静态操作示意，不代表当前设备已完成配置；实际菜单以安装的客户端界面为准。

打开“订阅分组设置”，添加订阅地址与便于辨认的备注，保存后执行更新订阅。首次还没有可用连接时，可先尝试“不通过代理”的更新入口；若地址本身需要代理访问，再用已有可用连接更新。v2rayNG 也要先添加订阅分组，再更新订阅，单纯粘贴地址不会自动生成配置。更新后检查分组中是否出现条目；失败时先确认链接有效期和返回内容，不要反复添加相同地址。

区分客户端与内核

Project V、V2Fly 与 Xray 生态

先理解各层负责什么，再选择配置方式。界面名称、内核能力与订阅格式是三个不同问题，不能仅凭客户端名称判断某项协议或传输组合能否使用。

理解 Project V 的位置

把 Project V 理解为代理工具与相关技术的开源生态，而不是一个统一的图形应用。V2Ray 是其中的重要项目，配置体系涵盖入站、出站、路由等部分。日常看到的 v2rayN、v2rayNG 和 v2flyNG，则负责把配置管理和连接操作放进图形界面。用户通常不必手写完整配置，也应知道“安装了客户端”与“已有可用连接参数”并不是同一件事。

在后续社区发展中，V2Fly 延续 V2Ray 的社区维护，Xray 则形成了相关的内核分支与功能演进路径。两者存在共同技术背景，但功能细节与配置选项并不始终相同。因此，教程里出现的某个字段，需要结合实际运行内核理解，而不是看到 V2Ray 一词就直接照填。

按配置要求选择内核

内核负责实际的协议处理与连接建立。v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核；v2rayN 可结合其发行包与设置管理支持的内核。需要确认具体功能时，先查看客户端的内核设置与日志，再核对连接配置要求。界面能够导入某条分享链接，不代表所有传输参数都已满足运行条件。

VMess、VLESS、Trojan 是常见协议名称，REALITY 则涉及安全握手机制，不宜把它们当成完全平行的选项。一个可用配置还可能包含传输方式、服务器名称和认证参数。导入后先保留来源提供的参数；只有确认服务端要求时，才修改相关选项，避免把协议识别成功误当作完整兼容。

认识三款客户端的开源属性

v2rayN、v2rayNG、v2flyNG 都属于开源图形客户端，源代码按各项目许可提供。图形界面、连接内核与附带组件可能采用不同许可，分发或修改时应分别阅读相应许可文本。开源描述的是代码使用与协作方式，不代表订阅服务、远端线路或网络资源也由客户端项目提供。

选择时先看任务：桌面端管理订阅与系统代理，优先了解 v2rayN；安卓使用 Xray 相关配置，先看 v2rayNG；需要 V2Fly 内核时，再看 v2flyNG。三者有相近的配置概念，但菜单和备份格式并不完全一致。跨设备迁移时优先共用订阅地址，界面偏好和路由规则再分别核对，不把整份设置直接覆盖到另一款应用。

区分软件更新与订阅更新

更新客户端是更换应用程序，更新订阅是重新获取连接配置，两者解决的问题不同。订阅内容改变时，重复下载安装包通常不会刷新列表；应用功能或兼容性变化时，仅更新订阅也不会升级内核。先判断需要更新的对象，再进入相应入口，可以避免误删原有配置。

升级前备份分组信息、自定义路由及必要设置，并记录当前使用的内核和接管模式。升级后先用原有配置复测连接，再检查自定义规则、后台运行与系统代理状态。若界面变化，按设置含义寻找入口，不依赖旧截图中的坐标。下载页集中提供安装包选择，首页不固定展示具体版本，便于把选型与版本信息分开阅读。

按故障所在层级阅读日志

连接按钮处于开启状态，只说明客户端进入运行流程，不代表目标网站已经可达。先看订阅是否更新成功、是否选中配置，再看内核有没有启动错误，最后检查域名解析和远端连接。超时、认证失败、端口占用与解析失败对应的处理方向不同，先保留关键报错文本，避免同时替换多个设置。

延迟测试也要区分类型：连接测试主要观察端点响应，真实访问测试还会受到目标站点、DNS 和路由影响。一次测试结果不能概括所有应用的使用表现。使用固定目标连续复测，比只看列表中的单次结果更有参考价值。需要系统排查时，可按 系统教程 的章节顺序检查；分享日志前，先隐藏订阅地址、认证信息和个人网络信息。

连接前后检查

常见问题精选

先定位具体症状，再进入对应说明。保留能复现问题的操作顺序，排查时一次只改变一个条件。

保存订阅后，为什么列表仍为空？

保存地址只是建立订阅分组，还需要执行更新订阅。先检查是否切换到了正确分组，再查看更新提示。若返回的是网页而非可识别的订阅内容，应向配置提供方确认地址用途，不要把服务管理页面当作订阅链接导入。

查阅订阅导入问题 →

系统代理与全局路由有什么区别？

系统代理决定哪些应用按系统设置接入本地代理；全局路由通常表示进入内核的流量采用代理出站策略。两者分别处理“流量有没有进来”和“进来以后往哪里走”，不能互相替代。某个程序未读取系统代理时，改成全局路由也未必有用。

区分代理模式与路由术语 →

显示已连接，为什么仍无法访问？

先固定一个测试目标，确认配置有效，再检查目标应用是否使用代理。浏览器能访问、另一程序不能访问时，重点检查接管方式；所有目标都失败时，再检查日志中的解析、认证与超时信息。先保留原配置，避免边排查边大量修改参数。

查阅连接故障排查 →

电脑与手机能否共用同一订阅？

只要服务允许多设备使用，且各客户端支持订阅中的配置，就可分别添加同一地址。订阅同步的是连接条目，不一定包含自定义 DNS、路由和界面偏好。设备数量与同时连接限制以服务规则为准；分享二维码或导出备份前，也要确认其中是否包含认证信息。

阅读多设备配置方法 →

继续阅读

配置教程与设备使用

先完成基础连接，再按具体需求扩展配置。以下文章分别处理虚拟网卡接管、订阅格式与多设备同步，适合在基础设置已验证后逐项阅读。

查看全部文章 →