v2rayN
首推7.24.1
两项下载均为 ZIP 压缩包。先完整解压，再运行其中的安装程序；不要直接在压缩包预览窗口中启动。
客户端安装包与架构选择
V2Ray 下载
v2rayN 与安卓客户端
先选操作系统，再选处理器架构。桌面端使用 v2rayN，Android 首选 v2rayNG，需要 V2Fly 内核时可选 v2flyNG。
三款客户端均为免费开源软件。安装包用于准备客户端；订阅与服务器配置需要另行导入。
首次配置：查看订阅导入与连接教程 →按平台选择
客户端安装包
不确定架构时，先查看系统“关于”或设备信息，再下载对应文件。
Windows 安装包
Windows 系统要求与准备
| 检查项 | 选择与准备 |
|---|---|
| 系统与架构 | 本页提供 Windows x64 包。在“设置 → 系统 → 关于”查看系统类型，不将 x64 包当作其他架构的原生包。 |
| 运行环境 | 具体系统版本与运行库要求以当前安装器提示为准；出现运行库缺失提示时，先记录组件名称和架构再处理。 |
| 目录与权限 | 使用当前账户可写的解压目录，预留安装与配置空间。普通系统代理测试不必一开始就启用 TUN。 |
桌面版与 WPF 版主要区别在于界面技术和操作布局，不代表订阅会自动变成两套不同的服务器。首次安装建议先选一种，完成订阅导入与浏览器访问测试后再决定是否更换。比较两个版本时先退出当前实例，避免本地监听端口冲突，也避免误把另一个实例的托盘状态当成当前设置。
已有配置的用户应先备份订阅分组、路由和 DNS 设置，再进行升级或切换界面版本。安装程序完成后，检查启动路径和实际读取的配置位置；不要只复制一个程序文件覆盖旧目录。若启动时报错，保留错误原文，区分运行环境缺失、目录权限和端口占用，再按照对应原因排查。
macOS 安装包
v2rayN
桌面客户端7.24.1
打开 DMG 后按安装窗口提示放置应用。完成安装后，从应用目录启动，避免一直从磁盘映像中运行。
macOS 系统要求与准备
| 检查项 | 选择与准备 |
|---|---|
| 芯片类型 | 在系统菜单中打开“关于本机”，按芯片或处理器字段选择 Apple Silicon 或 Intel 包。 |
| 系统版本 | 应用对系统版本的具体要求以当前发行包提示为准；架构正确不等于系统版本一定满足要求。 |
| 网络权限 | 首次设置代理或启用虚拟网络接口时，阅读系统授权说明，仅允许当前操作所需的权限。 |
先确认芯片，再打开对应的磁盘映像。安装完成后退出磁盘映像，从应用目录重新启动客户端，确认配置能够正常保存。若系统提示应用无法打开，应先阅读提示中的具体原因，分清来源确认、系统版本和应用架构问题，不要把所有提示都当成同一种故障，更不要直接关闭全局安全保护。
首次连接可从系统代理开始，先验证遵循系统代理的浏览器，再测试其他应用。命令行程序不一定读取系统代理，浏览器正常而终端请求失败时，不能据此认定客户端安装错误。需要覆盖更多应用时，再阅读 TUN 模式说明，确认权限、DNS 与路由设置后逐项启用。
Android 安装包
v2rayNG
首推 · Xray 内核2.2.6
适合 Android 上的订阅导入、服务器选择与路由设置。启用连接时需确认系统 VPN 授权。
v2flyNG
备选 · V2Fly 内核1.10.31
将 v2flyNG 作为有明确内核需求时的备选；首次使用可先按 v2rayNG 的流程完成配置。
Android 系统要求与准备
| 检查项 | 选择与准备 |
|---|---|
| 应用架构 | 优先核实设备支持的应用架构。处理器支持 64 位，不一定意味着当前系统提供完整的 64 位应用环境。 |
| 系统兼容性 | 以 APK 安装器给出的系统要求为准。通用包解决的是架构覆盖问题，不会降低应用的系统要求。 |
| 安装与连接授权 | 仅为实际打开 APK 的浏览器或文件管理器授予所需安装权限；首次连接时确认系统 VPN 授权。 |
| 后台运行 | 若锁屏后断开，检查电池优化与后台限制，同时确认系统中是否有其他 VPN 应用占用连接。 |
下载 APK 后，从下载记录或文件管理器打开安装。出现安装失败时先看错误内容：架构不匹配、系统版本过低、存储不足和签名冲突是不同问题。不要在没有备份的情况下直接卸载旧客户端；已有订阅和自定义规则时，先使用导出功能保存，再决定是否重新安装。
v2rayNG 与 v2flyNG 都是图形客户端，但内核支持的具体配置项可能不同。订阅能够导入，只说明客户端识别了相应格式，不代表其中每一种连接参数都能运行。若服务提供方给出了客户端或内核要求，应优先核对该要求；切换客户端前记录原来的传输、安全和路由设置，避免把配置差异误判为网络故障。
连接按钮开启后，系统通常通过 VPN 接口接管符合配置的流量。此接口是本地流量处理机制，是否访问代理出站仍由路由规则决定。首次排查建议只开启一个代理客户端，先测试普通网页，再检查需要特殊分流的应用；不要同时修改应用分流、DNS 和后台策略，否则难以确认是哪一项改变了结果。
Linux 安装包
v2rayN
图形客户端7.24.1
先确定软件包体系，再确定处理器架构。deb 与 rpm 不是界面版本差异，不建议通过简单改扩展名或强行转换来安装。
Linux 系统要求与准备
| 检查项 | 选择与准备 |
|---|---|
| 桌面环境 | 本页提供图形客户端，需具备可用的图形桌面会话；仅有终端的环境不属于这份安装流程。 |
| 软件包体系 | 按发行版使用的包管理器选择 deb 或 rpm，扩展名对应只是第一步，仍需满足系统库依赖。 |
| 架构名称 | amd64、x86_64 通常对应 x64；arm64、aarch64 对应 ARM 64 位。下载前核对系统实际架构。 |
| 权限与网络模式 | 安装软件包与启用虚拟网络接口可能需要不同授权。先以普通用户启动界面，再按功能提示处理权限。 |
从系统设置查看发行版与处理器信息，选择合适的软件包后，使用系统的软件安装器打开。若包管理器报告依赖不满足，先查看缺失的库和版本要求，不要跳过依赖强制安装。扩展名相同不代表不同发行版之间必然兼容，架构正确也不能代替对系统库版本的检查。
启动后先导入一组订阅，再在支持代理设置的应用中验证连接。Linux 桌面环境对系统代理的实现可能不同，一些命令行程序还需要独立的代理环境设置。TUN 涉及路由、接口权限和 DNS，建议在基本连接正常后再开启；测试结束后确认系统路由恢复，避免遗留设置影响后续判断。
下载之后
安装与首次连接
先完成最小可用配置，再逐项加入路由、DNS 与 TUN 设置。
先安装，再导入订阅
安装成功后，准备有效的订阅地址或分享链接。订阅地址通常包含访问权限信息，应保存在受控位置，不要将完整链接放入公开截图、讨论区或故障日志。添加订阅分组后执行更新，确认服务器列表出现内容，再选择其中一项进行连接测试。
如果列表为空，先检查订阅是否过期、分组是否启用以及更新日志的具体提示。反复重装客户端通常不能解决订阅地址失效的问题。手动导入分享链接时，也应确认复制内容完整，避免混入空格、说明文字或不完整的参数。
查看订阅导入步骤 →先测试，再调整网络模式
桌面端可先用系统代理测试浏览器，Android 则先确认 VPN 接口授权。网页能够打开后，再验证预期的路由结果。系统代理只影响遵循该设置的应用，不能根据一个程序的结果推断所有程序都采用同一条连接路径。
路由规则、DNS 和 TUN 会影响不同环节。修改前记录原值，每次只调整一个因素，并用相同目标重复测试。如果出现问题，先恢复最近修改的选项，再检查日志中的出站和解析结果，这比同时切换多个功能更容易定位原因。
查看路由规则说明 →安装包与更新
下载常见问题
Windows 首次安装选桌面版还是经典 WPF 版？
首次使用可先选桌面版 Desktop，它采用新一代跨平台界面；已有经典界面使用习惯或需要沿用相应操作流程时，可选经典稳定的 WPF 版。两者都是 v2rayN 客户端，安装前备份已有配置，测试时只运行一个实例。
Android 应该选 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但仍应以设备支持的应用架构为准。无法确认架构或 arm64 包提示不兼容时，可尝试通用版。通用版并不代表支持所有系统版本，也不能解决签名冲突。
v2rayNG 与 v2flyNG 应该怎样选择？
Android 首选使用 Xray 内核的 v2rayNG；需要 V2Fly 内核行为或已有相应配置时，可选 v2flyNG。先确认服务提供方要求的协议、传输和安全参数，再选择客户端，不要仅凭订阅链接的外观判断兼容性。
下载后提示无法安装，应该先检查什么？
先检查系统、处理器架构和软件包格式是否对应，再查看系统给出的具体错误。Windows 压缩包应先完整解压；Android 检查安装来源授权与签名冲突；Linux 检查包管理器依赖；macOS 检查芯片类型与系统安全提示，不要直接关闭全局安全保护。
安装客户端后是否已经可以连接？
安装只完成客户端准备，还需要有效的订阅地址、分享链接或配置。先导入订阅并更新服务器列表，再选择服务器，按需要启用系统代理或 VPN 接口，最后验证目标应用是否经过预期出站。
升级前需要保留哪些配置？
先使用客户端提供的备份或导出功能，保存订阅分组、路由规则、DNS 设置及自定义出站，并记录原有网络模式。备份可能包含订阅地址和访问凭据，应存放在受控位置。升级后先确认配置可读取，再逐项测试连接与分流。