v2rayN · Windows
首推发布清单版本 7.24.1
这里的两个文件都是 ZIP 包。下载后先完整解压到可写的本地文件夹，再打开其中的安装程序，按提示完成安装。不要在压缩软件的预览窗口中直接启动，也不要把安装目录与配置备份混在同一个临时文件夹里。
CLIENT PACKAGES / 按平台选择
V2Ray 客户端下载
v2rayN 桌面端，v2rayNG 与 v2flyNG 安卓端。
先确认系统与芯片，再选择安装包。
免费使用
代码开源
图形配置界面
安装包用于安装客户端；连接前还需要有使用权限的订阅或服务器配置。首次安装可对照使用文档完成导入。
系统与安装包
切换平台查看对应入口。macOS 默认展开；从其他页面的平台链接进入时，会打开对应分组。
Windows 系统要求与安装检查
| 检查项 | 选择依据 | 操作建议 |
|---|---|---|
| 处理器架构 | 本页为 x64 安装入口 | 在系统设置的“系统类型”中确认设备架构。 |
| 系统与运行环境 | 以所选发行包要求为准 | 安装器提示缺少运行组件时，先核对包内说明与系统更新状态。 |
| 文件访问 | 需要可写的安装或配置位置 | 先完整解压；受组织管理的设备需遵循设备策略。 |
| 代理接管 | 系统代理与 TUN 权限不同 | 先用系统代理完成基础验证，再按需要配置 TUN。 |
Desktop 与 WPF 的主要区别是界面技术和操作布局，不是订阅服务等级。已有配置不应仅靠复制程序文件迁移；先导出或备份订阅、路由与个人设置，确认新版本能够读取后，再处理旧目录。同一时间只保留一个客户端管理系统代理，避免退出其中一个程序时把另一个程序的代理设置清掉。
首次启动后先导入订阅并执行更新，确认服务器列表出现条目，再选择当前服务器。开启系统代理只是在系统中写入代理地址，不代表远端连接已经成功。若浏览器仍不能访问，应分别检查订阅有效性、当前服务器、客户端日志与浏览器是否使用系统代理。
v2rayN · macOS
首推发布清单版本 7.24.1
打开 DMG 后，将应用拖入“应用程序”文件夹，再从该文件夹启动。安装完成后可推出磁盘映像。这样后续更新、系统授权与应用路径更明确，也能避免一直从下载目录或已挂载的映像中运行。
macOS 系统要求与安装检查
| 检查项 | 选择依据 | 操作建议 |
|---|---|---|
| 芯片类型 | Apple Silicon 或 Intel | 按“关于本机”的实际显示选择，不依赖兼容转换运行。 |
| 系统版本 | 须满足当前发行包的最低要求 | 如提示系统过旧，先查看安装包说明，不反复替换架构包。 |
| 安装位置 | 应用程序文件夹 | 复制完成后从本机应用目录启动，再推出 DMG。 |
| 系统权限 | 按代理模式与系统提示授予 | 系统代理与 TUN 分开配置，不为排错批量开放权限。 |
如果系统阻止首次打开，先核对下载来源、文件是否完整下载以及应用是否已复制到本机。在系统设置的“隐私与安全性”中查看对应提示，确认后再按系统提供的方式处理。不要为了运行单个应用关闭整机安全机制；“应用已损坏”、架构不匹配与系统版本不兼容也不是同一种问题，应依据原始提示分别排查。
v2rayN 启动后，先添加订阅分组并更新，再选择服务器。基础使用可从“自动配置系统代理”开始；“清除系统代理”用于移除当前系统代理设置，“不改变系统代理”则保留系统原状。修改前先记下原有配置，尤其是公司网络或已有手动代理的设备。
系统代理主要影响遵循该设置的应用。某个程序仍然直连时，不应立即认为客户端失效；先检查程序自己的网络设置。确实需要更广的流量接管时，再阅读 macOS 安装配置章节，了解 TUN 所需权限、DNS 与路由的配合方式。
v2rayNG
首推 · Xray 内核发布清单版本 2.2.6
v2rayNG 使用 Xray 内核，适合作为安卓端的起点。安装后从订阅分组设置添加链接，保存并更新订阅，再返回主界面选择配置。首次连接会出现系统 VPN 连接请求，确认应用名称与操作意图后再授权。
v2flyNG
备选 · v2fly 内核发布清单版本 1.10.31
v2flyNG 是不同内核路线的备选，不是 v2rayNG 的附加组件。通常只需安装并运行一款符合配置要求的客户端；如果需要比较行为，先停止另一款的连接，再进行测试，避免两个连接服务相互替换。
Android 系统要求与安装检查
| 检查项 | 选择依据 | 操作建议 |
|---|---|---|
| 架构 | arm64 或通用版 | 新近主流设备优先 arm64，不确定时选择通用版。 |
| 系统版本 | 满足所选 APK 的安装要求 | “解析软件包失败”时同时检查系统兼容性与下载状态。 |
| 安装权限 | 允许当前来源安装应用 | 仅在明确需要时给当前浏览器或文件管理器授权。 |
| 连接与后台 | VPN 授权及后台运行条件 | 频繁断连时检查电池优化、后台限制与现有 VPN 连接。 |
安卓安装器会检查包的架构、系统要求与签名。遇到“应用未安装”时先保留原有数据，确认是否存在同名应用，以及新旧包是否来自相同发行渠道。不要直接卸载后重试；卸载可能删除订阅和自定义规则，应先在原应用内完成导出或备份。
客户端能够打开但锁屏后断连，通常应从后台运行限制与电池管理查起。客户端能够连接却只有部分应用可用，则应检查分应用代理、路由规则和 DNS 设置。把安装阶段与连接阶段分开处理，比连续更换客户端更容易定位问题。
v2rayN · Linux
首推发布清单版本 7.24.1
deb · x64
下载 v2rayN · debDebian、Ubuntu 系发行版通常选用 deb。这里的主入口对应 x64，也常标记为 amd64。
ARM 设备：下载 arm64 deb →先确认发行版的软件包格式，再确认 CPU 架构。下载后通过系统的软件安装器打开文件，查看依赖与安装位置，完成后从应用菜单启动。不要把更换扩展名当作包格式转换，也不要在依赖不满足时强制安装。
Linux 系统要求与安装检查
| 检查项 | 选择依据 | 操作建议 |
|---|---|---|
| 软件包体系 | deb 或 rpm | 查看发行版的软件中心与包管理方式，不按桌面外观判断。 |
| 处理器架构 | x64 或 arm64 | x64 常对应 amd64、x86_64；arm64 常对应 aarch64。 |
| 桌面与依赖 | 图形桌面及所需系统库 | 本页提供图形客户端，安装器须能解析当前软件包的依赖。 |
| 系统代理 | 取决于桌面环境与应用行为 | 核对桌面网络设置，单独配置不读取系统代理的应用。 |
同为 rpm 或 deb 的发行版，也可能使用不同版本的基础库。文件能够被安装器识别，不等于它适配当前系统。若提示依赖版本不满足，先查明缺少哪一项，再决定是否更新系统或采用符合该发行版要求的发行包，不要从不明位置逐个补装系统库。
安装成功后，先用普通用户启动图形客户端并导入订阅。不同桌面环境对系统代理的写入和读取方式并不完全一致；浏览器可用而其他应用不能连接时，应检查应用自己的代理设置。TUN 还涉及网络权限、路由与 DNS，建议在基本连接确认后再单独配置，避免把多个变量同时引入排查过程。
AFTER INSTALLATION
安装完成后的配置顺序
准备订阅或分享链接
确认链接来自有使用权限的服务，区分订阅地址与单条配置分享链接。客户端不会随安装包提供可用的远端服务器。完整订阅地址可能含有身份凭据，保存时应与普通网页书签分开管理。
导入并更新配置
在订阅分组中添加地址，保存后执行订阅更新。仅保存地址还不等于已获取配置。更新后检查服务器列表；若列表为空，先看更新结果和链接格式，不急于改端口或重装客户端。
选择连接与代理模式
选择当前服务器，再设置桌面系统代理或安卓连接模式。先用一种接管方式验证访问，再调整分流。需要 TUN 时另行确认权限和 DNS；不要把开启开关本身当作连接成功的依据。
区分客户端、内核与服务器配置
v2rayN、v2rayNG 与 v2flyNG 是图形客户端，负责把订阅、路由与连接选项组织成可管理的界面。Project V 是相关技术生态的起点，V2Fly 与 Xray 是其中常见的内核路线。客户端名称相近，不代表协议、传输与扩展参数完全一致。遇到导入错误时，应核对配置需要的功能与客户端实际能力，而不是只比较应用名称。
开源说明的是代码与许可层面的属性，免费使用说明的是客户端本身的费用；远端服务是否收费、允许多少设备连接、订阅何时到期，都由相应服务约定决定。升级客户端通常不会改变订阅账户状态，也不会自动修复失效的远端配置。排查前先区分应用问题、配置问题与网络问题，可以减少不必要的重装。
首次验证只改变一个设置
建议先保持路由和 DNS 的默认配置，选定一条明确可用的服务器，再进行基础访问测试。如果出现异常，记录测试时使用的服务器、接管模式和日志信息；反馈时删去订阅地址、访问凭据与个人网络信息。随后每次只调整一项设置，才能确认是哪一项改变了结果。
确认基础连接后，再逐步增加分应用代理、域名分流或 TUN 等功能。系统代理并不会强制所有应用读取同一配置，TUN 也不意味着所有协议与应用都能在任意网络下工作。需要查看菜单入口和完整步骤时，使用 使用文档；涉及平台权限、网络接管与常见错误时，查看 完整文档。
DOWNLOAD / FAQ
下载与安装常见问题
Mac 应该下载 Apple Silicon 还是 Intel 安装包？
打开苹果菜单中的“关于本机”。显示“芯片”且名称为 Apple M 系列时选择 Apple Silicon；显示 Intel 处理器时选择 Intel。优先使用与芯片对应的安装包，不要仅凭电脑购买年份判断。
Windows 的 Desktop 与经典 WPF 版怎么选？
Desktop 使用新一代跨平台界面；WPF 是经典稳定版，适合熟悉传统 Windows 操作布局的用户。两者均用于管理代理配置。首次使用可从 Desktop 开始，迁移前先导出或备份配置，不要同时运行两个实例接管系统代理。
Android 的 arm64 与通用版有什么区别？
arm64 面向 64 位 ARM 设备，2015 年后的主流手机通常优先选择这一包型，但仍应以设备实际支持的架构为准。无法确认架构或遇到包不兼容提示时选择通用版；不要把所有安装失败都归因于架构，系统版本和现有安装的签名也可能影响安装。
Linux 应该选 deb 还是 rpm？
先看发行版的软件包管理体系。Debian、Ubuntu 系通常选择 deb，Fedora、RHEL 系通常选择 rpm，再核对 x64 或 arm64 架构。包格式正确不代表依赖一定满足，安装器提示缺少库或系统版本不兼容时，应先核对依赖要求。
下载客户端后就能直接连接吗？
客户端负责读取配置和转发流量，不附带可用的服务器配置。需要准备有使用权限的订阅链接或分享链接，导入并更新后选择服务器，再设置系统代理或连接模式。订阅地址可能包含访问凭据，不要公开截图或转发给不相关的人。
更新客户端前需要卸载旧版吗？
不要直接卸载。先备份订阅、路由和自定义设置，退出正在运行的客户端，再按安装器提示更新。同一客户端不同发行渠道可能使用不同签名或配置目录；若不能覆盖安装，先确认迁移方式，避免因卸载而丢失应用数据。
CONFIGURATION BACKUP
更新前保留配置，更新后验证连接
备份不等于复制安装包
保留订阅分组、个人路由和 DNS 设置，记录当前使用的代理模式。不同界面版本、发行渠道或系统账户可能使用不同的数据目录；确认新版本读取到原有配置，再清理旧文件。
先测试，再恢复自动启动
更新时先退出旧进程，安装完成后手动启动，检查订阅、当前服务器与系统代理状态。确认访问正常后，再恢复登录启动等选项。需要比较三款客户端的适用场景，可查看客户端对比。