v2rayN
首推7.24.1
两种界面，同属 v2rayN。Desktop 是新一代跨平台 UI；WPF 是经典稳定版，延续 Windows 用户熟悉的操作布局。
客户端安装包
V2Ray 客户端下载
先选操作系统，再选架构。桌面使用 v2rayN，Android 首选 v2rayNG，也可按配置需求选择 v2flyNG。
按平台选择安装包
客户端永久免费；订阅与节点配置需另行准备。
Windows 下载
系统与安装条件
| 检查项 | 选择依据 |
|---|---|
| 处理器架构 | 此处两项均为 x64 安装包，适用于匹配的 64 位 Windows 环境。 |
| 系统兼容性 | 建议使用仍获系统更新的 Windows；最低支持版本以所选发行包要求为准。 |
| 运行环境 | 运行库依赖可能随发行形态变化；若出现缺少组件的提示，记录组件名称后处理。 |
| 权限条件 | 普通代理配置与 TUN 的权限需求不同，首次安装不必先启用 TUN。 |
从解压到首次启动
下载完成后，将 ZIP 内容完整解压到可写入的目录，再运行其中的安装程序。不要直接在压缩文件预览窗口中启动程序，否则依赖文件可能没有正确展开。安装结束后从开始菜单或安装位置打开客户端，先确认主窗口能够正常显示，再进行订阅导入。
Desktop 与 WPF 不需要同时安装。已有客户端的用户，应先保留订阅分组、路由和 DNS 设置；切换界面形态时，不要假定所有配置都会自动迁移。若希望比较两者，先停止正在运行的客户端，避免本地监听端口被重复占用。遇到端口冲突时，先检查托盘中是否还有另一份进程。
导入配置后先选择一个节点，再设置系统代理。系统代理主要影响遵循系统代理设置的应用，并不代表所有程序都会自动接管。完成网页访问测试后，再根据需要调整路由。更完整的图形界面操作见Windows 安装与版本选择教程。
macOS 下载
v2rayN
7.24.1先在“关于本机”查看芯片信息。Apple M 系列选择 Apple Silicon；显示 Intel 处理器时选择 Intel 包。
系统与安装条件
| 检查项 | 选择依据 |
|---|---|
| 芯片类型 | Apple M 系列对应 arm64；Intel 对应 x64。 |
| 系统版本 | 请使用满足当前发行包要求的 macOS，具体最低版本以程序安装提示为准。 |
| 安装格式 | DMG 磁盘映像，打开后按窗口提示复制应用。 |
| 系统权限 | 首次打开及修改网络设置时，可能需要在系统设置中确认授权。 |
DMG 安装与授权
打开下载的 DMG，将客户端放入“应用程序”目录，再从该目录启动。不要长期从挂载的磁盘映像中运行程序，以免后续更新、路径引用或系统权限记录出现混淆。应用复制完成后，可以推出磁盘映像；安装文件与已复制的应用是两个不同对象。
如果系统拦截首次启动，先核对应用名称和下载来源，再查看“系统设置”中的“隐私与安全性”提示。只对明确准备安装的应用进行确认，不应为一次安装关闭整个系统的安全机制。若提示系统版本不兼容，应先核对当前系统版本，而不是反复尝试不同芯片的安装包。
打开客户端后，先导入订阅、更新列表并选中节点。系统代理与 TUN 属于不同接管方式；首次测试建议固定一种方式，确认浏览器访问正常后再扩展设置。若此前使用过其他网络工具，应先停止其连接，检查系统代理是否仍指向旧的本地地址，再判断当前客户端是否存在问题。
Android 下载
v2rayNG
首推Xray 内核2.2.6
Android 首选客户端。2015 年后的主流手机通常选择 arm64；最终仍以设备系统支持的 ABI 为准。
v2flyNG
备选 · V2Fly 内核1.10.31
适用于需要 V2Fly 内核的配置场景。请先确认节点使用的协议和传输组合是否受支持，不能仅凭节点名称判断兼容性。
系统与安装条件
| 检查项 | 选择依据 |
|---|---|
| 系统架构 | arm64 包要求系统支持 arm64-v8a；处理器为 64 位不一定代表系统也是 64 位。 |
| 系统版本 | 需满足所选 APK 的最低 Android 版本要求，以系统安装器提示为准。 |
| 安装授权 | 只为用于打开 APK 的浏览器或文件管理器授予安装来源权限。 |
| 连接授权 | 首次启动连接时需确认系统 VPN 授权，同一时间应避免运行其他 VPN 连接。 |
APK 安装与首次连接
下载完成后，从系统下载列表或文件管理器打开 APK。如果系统要求授权安装来源，确认当前打开文件的应用后再授予权限。安装完成后可以撤回这一权限。若出现“应用未安装”，先阅读具体错误；常见原因包括系统版本不足、架构不符，以及现有应用与新包的签名不同。
不要在未备份配置时直接卸载旧客户端。遇到签名冲突，应先导出可恢复的配置，确认订阅地址仍可取得，再决定是否重新安装。arm64 与通用版不是两种代理模式，而是不同的打包范围；换包并不会自动解决订阅失效、服务端不可达或协议参数不匹配的问题。
首次连接前，导入订阅并执行更新，选中一个节点，再点击连接按钮。系统弹出 VPN 连接请求时确认授权。连接后若切到后台就断开，可检查电池优化、后台活动权限和设备厂商的省电设置。v2rayNG 与 v2flyNG 不宜同时连接；切换客户端前先停止原来的连接，避免误判网络接管状态。
Linux 下载
v2rayN
7.24.1先确认发行版的软件包体系，再确认 CPU 架构。deb 与 rpm 不是性能档位，不能只根据文件扩展名尝试安装。
arm64 架构入口
系统与安装条件
| 检查项 | 选择依据 |
|---|---|
| 桌面环境 | 此处为图形客户端，需可运行该应用的 Linux 桌面会话。 |
| 包管理体系 | Debian、Ubuntu 系通常选 deb；RPM 系选 rpm，并核对发行版依赖兼容性。 |
| 架构名称 | amd64、x86_64 对应 x64；arm64、aarch64 对应 ARM 64 位。 |
| 权限与依赖 | 安装需要软件包管理权限；TUN 另需相应网络权限，依赖由包管理器检查。 |
图形安装与依赖检查
在系统设置的设备信息中确认架构，再用发行版的软件安装器打开下载文件。安装器会列出依赖、冲突或不支持的包格式；应先处理这些提示，不要忽略错误强行安装。某些较旧发行版的系统组件可能不满足当前包的要求，换成另一种包格式并不一定能够解决。
安装成功后，从应用菜单启动 v2rayN。若窗口没有出现，先查看桌面环境给出的错误信息，并检查是否已经有客户端实例在运行。系统托盘的显示方式随桌面环境而异，找不到托盘入口并不一定表示程序没有启动。应结合应用窗口和系统进程状态判断。
Linux 桌面的系统代理设置并不会被所有应用采用。导入订阅后，先使用明确支持系统代理的应用验证连接，再判断是否需要应用内代理或 TUN。修改网络接管方式前记录原设置；如果同时启用多个代理工具，应先停用其他工具，避免本地端口和路由规则互相影响。
- 导入订阅并更新。在订阅分组中保存有效地址，再执行更新。添加分组与拉取节点是两个步骤，保存地址后列表仍为空时，先检查更新结果。也可导入单个节点分享链接，但它通常不会随订阅自动更新。
- 选节点，再选代理模式。桌面先确认系统代理状态；Android 确认 VPN 授权。路由分流决定流量走向，不能代替连接本身。初次配置可使用客户端已有的路由方案，先不要增加自定义规则。
- 用实际访问验证。检查目标应用是否采用代理，再测试网页或所需服务。仅看到连接图标不能说明全部应用已被接管；仅看延迟测试也不能证明目标服务一定可用。
更新与配置保留
客户端更新、订阅更新与节点切换是三个不同操作。客户端更新改变程序及其随附组件；订阅更新重新获取服务方提供的节点配置；节点切换只是选择当前使用的出站。连接失败时先分清问题属于哪一层，不必一开始就重新安装。若只有一个节点不可用，可以先比较同一订阅中的其他节点，再查看日志中的具体错误。
升级前记录当前可工作的配置，保存订阅地址、自定义路由和 DNS 设置。导出的配置可能包含认证信息，应放在个人可控的位置，不要上传到公开讨论区。排查时分享日志也应先遮盖订阅地址、用户标识和服务端凭据，只保留必要的错误上下文。
升级时先停止连接并退出程序，完成安装后核对订阅分组与默认模式是否保留。先沿用原节点测试，确认正常后再尝试新增功能。若同时升级客户端、切换节点、修改 DNS 和打开 TUN，出现故障时很难判断是哪一步造成变化。逐项修改并保留回退依据，比反复重装更便于定位。
不确定三款客户端如何选择，可先阅读客户端对比；已能连接但想调整分流、TUN 或 DNS，可继续查看使用手册。下载页侧重安装包选择，不需要在首次安装时完成所有进阶设置。
下载与安装常见问题
Windows 桌面版与 WPF 版应该选哪个？
首次安装可先选 Desktop 桌面版，它使用新一代跨平台界面。WPF 是经典稳定版，适合熟悉原有操作布局的 Windows 用户。两种入口均为 x64 包，选择其中一种安装即可；切换前先备份订阅与自定义设置。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常可先选 arm64，但最终应以系统支持的 ABI 为准。若设备系统为 32 位或无法确认架构，可尝试通用版。安装失败时还应检查系统版本、下载是否完成以及是否存在签名不同的旧安装。
macOS 如何区分 Apple Silicon 与 Intel？
打开系统菜单中的“关于本机”，芯片显示 Apple M 系列时选择 Apple Silicon；处理器显示 Intel 时选择 Intel 包。打开 DMG 后按窗口提示将客户端放入“应用程序”目录，再从该目录启动。
安装完成后为什么没有可用节点？
客户端负责管理配置与建立连接，安装包不附带订阅服务。需要自行准备有效的订阅地址或节点分享链接，在客户端内导入并更新，再选择节点和代理模式。订阅地址包含访问凭据，不应公开分享。
更新客户端之前要保留哪些内容？
先导出或备份订阅分组、自定义路由、DNS 设置与其他个人配置，记录当前代理模式，再停止连接并退出客户端。升级后核对设置是否保留，先用原有节点和模式测试，避免同时更改多个变量。
安装包无法打开时怎样排查？
先确认下载已经结束，文件类型与当前系统一致，处理器架构匹配。Windows 的 ZIP 应先完整解压；macOS 应检查系统“隐私与安全性”中的提示；Android 应检查安装来源权限与旧应用签名；Linux 应查看包管理器报告的依赖冲突，不要直接忽略错误强行安装。
还有连接或配置问题？查看帮助中心。