v2rayN
首推 7.24.1Windows 提供两种界面版本，均为 x64 安装包。首次使用可以从桌面版开始；已有经典界面使用习惯，也可以选择 WPF 版。
这两个入口不是不同的节点服务。安装界面的选择不会自动生成订阅，也不会替换你已经购买或自行维护的节点配置。
V2Ray 客户端下载
先选操作系统，再选安装包架构。
桌面使用 v2rayN，Android 首选 v2rayNG，v2flyNG 作为已有 V2Fly 配置的备选。安装完成后，再继续订阅导入与路由设置。
首次安装？查看配置教程 →安装准备
- 操作系统决定安装包格式
- 处理器架构决定 x64 或 arm64
- 已有配置确认订阅与协议兼容性
按平台选择安装包
下面的入口按客户端和包类型区分。版本文字只显示在卡片明细中；下载安装包不需要提前填写订阅地址。下载前确认当前设备的系统与架构，避免反复尝试不同包。
Windows 系统要求与安装准备
| 检查项 | 本页包要求 | 查看位置或处理方式 |
|---|---|---|
| 处理器架构 | x64；不能当作原生 ARM64 包使用 | 设置 → 系统 → 关于 → 系统类型 |
| 系统环境 | 64 位 Windows；具体最低版本以当前发布要求为准 | 记录系统版本和内部版本号，遇到兼容错误时对照查看 |
| 安装准备 | ZIP 完整解压，目录可写，磁盘空间充足 | 不要在压缩包预览窗口内直接启动安装程序 |
| 运行依赖 | 不同界面版本的依赖可能不同 | 若提示缺少运行环境，按实际提示处理，不混装不明组件 |
确认架构后，选择一个界面版本即可，不需要同时安装两版。首次打开时先导入配置，再选中一个节点，最后开启系统代理。系统代理只影响遵循系统代理设置的应用，不能用某个应用仍然直连来判断整个客户端安装失败。
如果安装顺利但程序无法启动，先退出旧版进程，检查是否有两个实例占用同一监听端口。安全软件提示、运行环境缺失与配置解析错误是不同问题，应记录完整报错，不要仅凭窗口闪退就反复换包。具体步骤见故障排查。
v2rayN
7.24.1先在系统菜单中打开“关于本机”。显示 Apple 芯片名称时选 Apple Silicon；显示 Intel 处理器时选 Intel。两种 DMG 对应不同架构，不要只按设备购买年份判断。
打开 DMG 后按安装窗口提示将应用放入应用程序目录，再从该目录启动。不要长期从挂载的磁盘映像中运行。
macOS 系统要求与安装准备
| 检查项 | 本页包要求 | 查看位置或处理方式 |
|---|---|---|
| 处理器 | Apple Silicon 对应 arm64；Intel 对应 x64 | 系统菜单 → 关于本机 |
| 系统版本 | 须满足当前客户端发布的最低系统要求 | 在关于本机中记录 macOS 版本；旧系统先确认兼容性 |
| 包格式 | DMG 磁盘映像 | 挂载后完成应用安装，再推出映像 |
| 网络权限 | 按实际使用模式授权 | 系统代理与 TUN 的权限需求不同，不要混为一步 |
应用首次启动出现系统安全提示时，先核对提示的应用名称和来源，再使用系统设置提供的正常授权路径处理。不要为启动一个应用而关闭整套系统安全机制。如果系统明确提示版本过旧或架构不兼容，应解决对应条件，而不是重复拖拽安装。
安装后先用常规系统代理完成一次连接验证，再按需要研究 TUN。网络扩展授权、管理员权限和节点可用性属于不同层面：节点连不上时，增加权限不会修复错误的地址或端口。更新前退出旧进程，避免旧实例继续保留代理设置，影响新版本测试。
v2rayNG
首推 2.2.6使用 Xray 内核的 Android 客户端。2015 年后的主流手机通常先选 arm64；不能确定设备的应用架构，或 arm64 明确提示不兼容时，再选通用版。
卡片版本文字与文件名分别取自发布清单字段，可能在发布切换期间不同。安装后可在应用的关于页面确认实际版本。
v2flyNG
备选 1.10.31使用 V2Fly 内核的 Android 备选客户端。适合已有配置与该内核兼容的使用场景；不要假定另一个客户端支持的所有协议参数都能直接迁移。
测试两个客户端时，先停止正在运行的 VPN，再启动另一款。Android 通常只能让一个 VPN 服务处于活动状态。
Android 系统要求与安装准备
| 检查项 | 要求或选择原则 | 处理方式 |
|---|---|---|
| 应用架构 | 支持 arm64-v8a 时优先 arm64；否则检查通用版适配 | 查看设备信息或系统提供的架构信息 |
| 系统版本 | 须满足所选 APK 的最低 Android 版本 | 设置 → 关于手机；以安装器的兼容提示为准 |
| 安装权限 | 执行安装的浏览器或文件管理器需获得相应权限 | 仅为本次使用的应用开启安装来源权限 |
| 连接权限 | 启动时确认系统 VPN 授权 | 先停止其他 VPN，避免服务冲突 |
APK 下载完成后，从下载记录或文件管理器打开。安装器提示“应用未安装”时，先排除架构、存储空间、系统版本和已有安装的签名冲突。不要一开始就卸载旧应用；若最终确实需要卸载，先导出配置，并确认仍能取得原订阅。
启动后需要导入订阅或单节点配置，再选择活动节点。若锁屏后频繁断开，检查系统电池优化和后台运行限制；这与 APK 是否选了通用版没有直接关系。遇到配置支持差异时，应比较协议参数和内核能力，而不是仅凭应用名称决定互换。
v2rayN
7.24.1先选发行版使用的包格式，再选处理器架构。Debian、Ubuntu 系通常使用 deb；使用 RPM 包管理体系的发行版选择 rpm。包格式正确仍不代表所有发行版版本都兼容。
ARM64 设备另选对应包
系统显示 aarch64 或 arm64 时查看这一组；x86_64 对应上方 x64 入口。不要用更改文件后缀的方式转换安装包。
Linux 系统要求与安装准备
| 检查项 | 本页包要求 | 处理方式 |
|---|---|---|
| 处理器架构 | x86_64 对应 x64；aarch64 对应 ARM64 | 在系统信息中查看，不按发行版名称猜测 |
| 安装包格式 | deb 或 rpm，与当前包管理体系匹配 | 使用发行版的图形软件安装器打开对应包 |
| 桌面环境 | 图形会话和当前版本要求的运行依赖 | 本页面向图形客户端，不作为服务器服务安装说明 |
| 兼容条件 | 系统库与包依赖满足安装器要求 | 阅读依赖错误；老发行版可能无法运行当前包 |
建议使用系统的图形软件安装器完成安装，让包管理器负责登记文件和检查依赖。若包能够下载但安装器拒绝继续，保留依赖名称和系统版本；直接改后缀、忽略依赖或复制其他系统的库文件，通常会把问题变得更难定位。
安装后从应用菜单启动，先验证订阅与节点，再设置代理。不同桌面环境对系统代理的使用方式并不完全一致，部分应用需要单独设置。如果配置要求 TUN，还要确认路由与权限条件；应用能打开只说明界面启动成功，不能代替出站连接验证。
安装之后：订阅、代理与更新
下载解决的是程序安装问题，连接则需要有效的节点配置。首次使用先准备已有订阅，打开客户端中的订阅管理，添加地址并更新。更新成功后检查是否生成节点列表，再选中一个节点启动连接。不要同时修改订阅、DNS 和路由，否则出现异常时很难判断是哪一步引入了问题。
桌面端可先使用系统代理完成基本测试，Android 则按系统提示授权 VPN。验证时区分“节点连接失败”和“应用未使用代理”：前者需要检查节点地址、端口和协议参数；后者需要检查代理模式及应用设置。连接成功后，再逐步加入境内直连、私有地址直连或广告拦截规则。
更新客户端前，保存订阅分组、路由规则、自定义 DNS 和其他手动配置。订阅能重新获取的节点信息，与本地修改的规则不是同一份数据，不能认为有订阅地址就等于所有设置都能恢复。退出旧进程后再安装，更新完成后检查当前节点、监听端口和代理模式是否与原先一致。
三款客户端都属于开源代理生态，但支持能力会随内核和版本变化。v2rayNG 使用 Xray，v2flyNG 使用 V2Fly；不能把名称相近理解为配置完全互通。遇到不支持的配置项，先查看概念速查，再根据协议和传输需求选择客户端。
下载与安装常见问题
先判断问题发生在下载、安装、启动还是连接阶段。下面的问题聚焦安装包选择；节点超时和 DNS 异常请继续查看故障排查。
Windows 应该选桌面版还是经典 WPF 版？
首次安装可先选桌面版 Desktop，它使用新一代跨平台界面；熟悉经典界面与操作路径的用户可选 WPF 版。两者都是 v2rayN，本页提供的包均为 x64。切换前先备份配置，不要让两个版本同时接管系统代理。
Android 的 arm64 与通用版怎么选？
2015 年后的主流手机通常可以先选 arm64，但处理器支持 64 位并不代表系统一定启用了对应应用架构。若安装时提示不兼容，检查设备架构后再选通用版。通用版包含更多架构，文件通常更大，并不代表连接性能更高。
下载后提示无法安装，应该先检查什么？
先检查包格式、处理器架构、系统版本和剩余空间。Windows 的 ZIP 要先完整解压；macOS 需选对应芯片的 DMG；Android 要给执行安装的应用授予相应权限；Linux 要使用与发行版匹配的包管理器。保留具体报错，再到故障排查页按症状处理。
装好客户端就能直接连接吗？
安装包提供客户端程序，不包含可直接使用的订阅或节点。需要导入已有的有效配置，选择节点，再设置系统代理或移动端 VPN。订阅链接可能包含访问凭据，不要公开发送完整地址。首次配置可以按教程逐步操作。
更新前是否需要删除旧客户端？
不必一开始就删除旧配置。先使用客户端提供的备份或导出功能保存设置，记录订阅分组、路由和自定义 DNS，再退出正在运行的程序。能否覆盖安装取决于包类型和安装方式；更新后先确认节点与规则仍在，再恢复连接。
版本文字与下载文件名不同，以哪个为准？
卡片版本文字与安装包路径来自发布清单的不同字段，发布切换期间可能不一致。不要手动改写下载地址中的版本号。安装后在客户端的关于页面查看实际版本；若涉及功能兼容，再结合该版本支持的配置项判断。