客户端安装包
V2Ray 下载
V2Ray 下载
按系统选择客户端
桌面系统选 v2rayN，Android 优先选 v2rayNG。先确认处理器架构，再下载对应安装包。
已有订阅？安装完成后，继续查看订阅导入步骤。首次使用时，先完成普通代理连接，再配置路由与 TUN。
Windows：v2rayN
同一客户端，两种界面。以下安装包均面向 x64 系统。
Windows 安装要求
| 检查项 | 要求与操作 |
|---|---|
| 处理器架构 | 本页两种安装包均为 x64。在系统设置的“系统信息”中查看系统类型，不要把文件名中的 x64 当成通用架构。 |
| 系统与运行环境 | 使用受当前客户端支持的 Windows；具体最低版本及运行环境以安装程序提示为准，缺少依赖时按提示补齐。 |
| 文件与权限 | 将压缩包完整解压到可写目录。普通系统代理配置通常不必始终以管理员身份运行；TUN 可能需要提升权限。 |
安装后先检查系统代理
启动 v2rayN 后，先导入订阅、更新服务器列表，并设定活动服务器，再选择“自动配置系统代理”。这一设置主要影响遵循系统代理的应用，并不等于接管所有网络流量。浏览器能连接而其他应用不能连接时，先核对应用自己的代理设置，不要急着更换安装包。
升级时退出旧客户端，再执行安装。桌面版与 WPF 版不宜同时作为日常运行实例，否则系统代理设置可能被相互覆盖。若安装后出现启动错误，先保留报错文字，检查运行环境与解压目录，再判断是否需要重新安装。仅靠反复覆盖程序文件，通常无法解决配置或权限引起的问题。
macOS：v2rayN
打开“关于本机”，按芯片信息选择 DMG 安装包。
v2rayN
桌面客户端macOS 安装要求
| 检查项 | 要求与操作 |
|---|---|
| 芯片类型 | Apple M 系列选 arm64；Intel 处理器选 x64。通过系统菜单的“关于本机”确认。 |
| 系统版本 | 使用当前客户端支持的 macOS。若启动提示系统版本不满足要求，先核对提示，不将架构切换当作系统升级的替代办法。 |
| 安装与授权 | 完成应用复制后再启动。系统代理、网络扩展或 TUN 相关操作可能请求授权，只授予当前使用功能所需的权限。 |
区分安装拦截与连接故障
系统提示与应用兼容性、来源或授权有关时，先阅读完整提示，再在系统设置中检查对应项目。不要将关闭系统防护作为通用安装步骤，也不要执行来历不明的终端命令。若应用已经能够打开，但网络连接失败，就应转向订阅、服务器与代理配置排查，而不是重复拖动安装文件。
启用系统代理前，确认没有其他客户端同时修改网络代理设置。退出 v2rayN 前可先清除系统代理，尤其是在准备卸载或迁移配置时。若退出后浏览器仍然连接异常，检查系统网络设置中的代理项目是否残留，再恢复正常连接。这样能把安装、授权与实际通信问题分开处理。
Android：优先选择 v2rayNG
先安装主选客户端；只有存在明确内核需求时，再考虑备选。
v2rayNG
首推 Xray 内核v2flyNG
备选 V2Fly 内核Android 安装要求
| 检查项 | 要求与操作 |
|---|---|
| 应用架构 | 优先确认 arm64 支持情况；不确定时选通用版。通用包仍受系统版本与客户端兼容范围限制。 |
| 安装权限 | 系统可能要求允许当前浏览器或文件管理器安装应用；完成安装后可按需要收回该来源的安装权限。 |
| 连接权限 | 首次启动代理连接时阅读并确认系统 VPN 授权。其他 VPN 应用可能占用相同入口，测试前先断开。 |
保留配置，再处理安装冲突
出现“应用未安装”时，先检查剩余存储空间、系统版本与应用架构，再看是否存在同名但签名不同的安装版本。不要一遇到错误就卸载原应用；卸载可能同时删除订阅分组和本地规则。确需更换安装来源时，应先导出必要配置，并把含有订阅凭据的文件妥善保存。
页面上的版本文字与安装包文件名分别来自清单字段，可能存在更新节奏差异。不要仅根据文件名推算页面标签，也不要把差异当成安装失败。安装后进入客户端“关于”页面查看实际构建版本；连接验证则应使用真连接测试，并检查需要代理的应用是否纳入客户端的应用分流范围。
Linux：v2rayN
先看发行版的包管理体系，再核对处理器架构。
v2rayN
图形桌面客户端Linux 安装要求
| 检查项 | 要求与操作 |
|---|---|
| 桌面环境 | 本页提供图形客户端。需要可用的图形桌面及相应运行依赖，不将这些软件包当作后台服务部署说明。 |
| 包格式与依赖 | 按发行版选择 deb 或 rpm，使用软件安装器检查依赖。缺少依赖或目标环境不符时，先解决兼容性问题。 |
| 处理器架构 | 普通 x64 电脑选择主按钮；arm64 设备使用卡片中的小字入口。架构必须与系统用户空间匹配。 |
| 网络权限 | 系统代理是否被应用遵循，取决于桌面环境与应用行为。TUN 可能需要额外权限，先验证普通代理连接。 |
先完成桌面代理验证
安装完成后，从应用菜单启动 v2rayN，再导入订阅并选择活动服务器。Linux 桌面中的浏览器、命令行程序和其他应用不一定共享同一套代理设置，因此“客户端已运行”不能直接证明所有应用都已通过代理。先在一个明确遵循系统代理的应用中验证，再逐个检查其他应用的网络行为。
若软件安装器报告依赖无法满足，保留具体包名与版本要求，不要强制忽略依赖。升级前记录程序使用的配置位置，并保留自定义路由与 DNS 设置。遇到权限问题时，优先按功能所需授予权限，而不是将日常图形会话整体改为高权限运行。
安装与升级先处理配置，再验证连接
安装包只解决程序部署。订阅、活动服务器与代理模式，需要在客户端中继续设置。
首次安装：按顺序完成配置
先确认下载文件的架构与设备一致，再完成解压或安装。启动客户端后添加订阅分组，填写有权使用的订阅地址并保存，接着执行更新订阅。看到服务器列表后，选择一个配置完整的服务器并设为活动项，最后启用对应的系统代理或 VPN 连接。
更新订阅只负责获取服务器配置，不会替代活动服务器选择。首次测试时使用默认或基础路由，暂缓调整复杂 DNS 与 TUN 参数。先建立一条可用连接，后续每次只改动一个设置，才能判断问题来自哪一步。
继续阅读订阅导入 →覆盖升级：先备份并退出
备份订阅分组、自定义路由、DNS 设置与手动添加的服务器信息。备份可能包含访问凭据，避免上传到公开空间或直接放进求助截图。退出正在运行的客户端，再处理安装；不要在程序仍写入配置时复制整个配置目录。
升级后检查订阅是否保留、活动服务器是否正确、代理模式是否符合预期。确认浏览器和常用应用均能正常连接后，再清理旧目录。跨界面或跨客户端迁移时，不直接覆盖不明格式的配置文件，优先使用客户端支持的导入方式。
查看完整维护流程 →安装包选择与下载常见问题
先确认架构与包格式，再处理安装和连接问题。
Windows 桌面版与 WPF 版应该选哪个？
首次使用可先选采用新一代跨平台界面的桌面版 Desktop；习惯经典界面可选经典稳定 WPF 版。两者都是 v2rayN，切换前先备份配置，不要让两个客户端同时修改系统代理。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常优先选 arm64，但仍应确认系统支持的应用架构。无法确认架构或 arm64 包无法安装时，可尝试通用版。通用版不是功能增强版，仍需满足客户端的系统要求。
下载客户端后是否已经包含订阅？
安装包提供客户端程序，不包含可直接使用的订阅。需要自行准备有权使用的订阅地址或服务器配置，导入后更新订阅，再选择活动服务器并设置代理模式。
更新安装包前需要备份哪些内容？
先退出客户端，备份订阅分组、自定义路由、DNS 与其他手动修改的配置。备份中可能包含订阅凭据，应保存在受控位置。保留原配置副本，确认新版正常连接后再清理旧文件。
Android 版本文字与安装包文件名为什么可能不同？
清单中的版本标签与安装包路径是独立字段，可能存在更新节奏差异。页面保留清单给出的标签与下载路径，不根据文件名推算版本；安装后可在客户端关于页面查看实际构建版本。
安装成功后为什么还不能连接？
先检查订阅是否更新成功、是否选中活动服务器，再确认系统代理或 Android VPN 授权是否启用。随后检查日志中的连接错误，按服务器配置、系统时间、DNS 与路由顺序排查，不要同时改动多个设置。