安装包 / 系统与架构
V2Ray 客户端下载
桌面端选 v2rayN，安卓端选 v2rayNG。先确认操作系统，再选择处理器架构与安装包格式。
- Desktop / WPF
- x64 / arm64
- DMG / APK / deb / rpm
客户端负责管理配置与连接；可用服务器配置需要另行导入。首次安装可对照配置教程继续操作。
Windows 安装包
同一客户端的两种界面。以下入口均为 x64，下载前先在系统信息中确认系统类型。
系统要求与安装准备
| 检查项 | 选择依据 |
|---|---|
| 操作系统 | Windows 桌面系统；具体最低系统版本以当前安装程序提示为准。 |
| 处理器架构 | 这两个入口均为 x64。到“设置 → 系统 → 系统信息”查看系统类型。 |
| 安装文件 | 先解压 ZIP，保留解压后的完整目录，再运行其中的安装程序。 |
| 运行环境 | 若安装器报告缺少运行环境，按提示确认所需组件及架构，不要随机替换程序文件。 |
不要直接在压缩包预览窗口里启动程序。先把文件解压到可写入的普通目录，确认安装器能读取同目录内容，再开始安装。旧版客户端仍在运行时，先清除其系统代理并退出，避免新旧实例争用本地监听端口。
Desktop 与 WPF 的主要区别在界面技术与操作布局，不代表任意配置在两版之间都能直接复制。切换时优先使用客户端提供的配置导出与导入功能；自定义路由、订阅分组和本地端口需要逐项核对。不要把旧目录里的全部文件直接覆盖到新目录。
安装结束后，先导入配置并选中一个服务器，再确认内核能够启动。系统代理会影响读取系统代理设置的应用；它不等于所有应用的流量都已改变。连接验证与路由选择可继续查看首次配置教程。
macOS 安装包
先查看“关于本机”的芯片或处理器信息，再选择对应的 DMG。
v2rayN
7.24.1系统要求与芯片识别
| 检查项 | 选择依据 |
|---|---|
| 操作系统 | macOS；最低系统版本以当前应用包的要求与系统提示为准。 |
| Apple Silicon | “关于本机”显示 Apple M 系列芯片，选择 arm64 DMG。 |
| Intel 处理器 | “关于本机”显示 Intel，选择 x64 DMG。 |
| 安装方式 | 打开 DMG，将应用移入“应用程序”，再从该目录启动。 |
“关于本机”中的芯片名称比机型年份更可靠。相近外观的设备可能使用不同架构，旧款设备也可能在较晚时间购入。下载错误架构的包后，即使磁盘映像可以打开，应用也未必能够正常运行，因此应在安装前完成确认。
打开磁盘映像后，不要把映像内的临时位置当作长期运行目录。将应用复制到“应用程序”，完成复制后再启动；更新时先退出旧实例，确认菜单栏中的客户端也已关闭。系统若阻止启动，应先阅读“隐私与安全性”中的具体提示，不要为了启动某个应用而整体关闭系统保护。
首次启动后先检查导入结果，再设置系统代理。若浏览器能连接而其他应用不能连接，应确认该应用是否读取系统代理，不能仅凭浏览器结果判断所有流量。涉及协议、安全层与内核支持范围时，可查看协议与内核手册，再核对导入配置。
Android 安装包
优先选择 v2rayNG。2015 年后的主流手机通常选 arm64；架构不明时可查看通用版。
v2rayNG
首推 2.2.6v2flyNG
备选 1.10.31系统要求与安装授权
| 检查项 | 选择依据 |
|---|---|
| 操作系统 | Android；最低系统版本由当前 APK 声明，安装器会检查兼容性。 |
| 处理器架构 | arm64 对应支持 64 位应用的系统；通用版覆盖多种应用架构。 |
| 安装授权 | 只为实际打开 APK 的浏览器或文件管理器开启所需的安装权限。 |
| 连接授权 | 首次连接会请求系统 VPN 授权，确认应用名称后再允许。 |
手机的处理器支持 64 位，不一定代表系统允许安装 64 位应用。部分旧设备使用不同的系统构建方式，因此年份只能作为初步参考。若 arm64 包无法安装，先查看安装器给出的原因；通用版可以处理部分架构差异，但无法绕过系统版本要求。
覆盖更新时，包名、签名与已安装应用必须满足 Android 的更新条件。来自不同发布渠道的安装包可能无法直接覆盖，遇到签名冲突时先保留现有应用并导出配置。直接卸载通常会删除应用私有数据，订阅分组与自定义规则也可能随之丢失。
v2rayNG 与 v2flyNG 是不同客户端，不应按名称相似就认定协议能力完全相同。配置包含特定安全层或传输组合时，应先查内核支持范围。建立连接后如果频繁在锁屏时中断，再检查电池优化和后台权限；分应用代理的勾选范围也会影响哪些应用实际走代理。
Linux 安装包
先确定发行版使用 deb 还是 rpm，再核对 x64 与 arm64。这里提供图形桌面客户端。
v2rayN
7.24.1系统要求与包格式
| 检查项 | 选择依据 |
|---|---|
| 桌面环境 | 需要可运行图形应用的 Linux 桌面会话；纯终端环境不属于本页安装指引范围。 |
| 包格式 | 依据发行版选择 deb 或 rpm；同一后缀也不代表所有发行版版本都兼容。 |
| 架构名称 | amd64、x86_64 对应 x64；arm64、aarch64 对应 ARM 64 位。 |
| 系统依赖 | 由系统软件安装器检查依赖库；缺少依赖时先核对发行版版本与软件源。 |
包格式与处理器架构是两个独立条件。比如使用 deb 的桌面系统也可能运行在 ARM 设备上，不能看到熟悉的后缀就直接下载 x64。可在系统的“关于”或硬件信息界面查看处理器和系统架构，再回到对应入口选择文件。
下载后用发行版的软件安装器打开软件包，阅读依赖检查结果。如果提示某个系统库版本不满足要求，应先确认该软件包是否适用于当前发行版，而不是强制忽略依赖。不要把 rpm 改成 deb 后缀，也不要把架构不符的包强行安装。
安装完成后从应用菜单启动，先在普通用户会话中导入配置。不同桌面环境对系统代理设置的读取方式并不一致，浏览器也可能保留自己的代理选项。若客户端已启动而浏览器未按预期连接，应同时检查桌面代理设置、浏览器配置与本地监听端口，按层定位问题。
安装之后
配置导入与更新准备
下载完成只是第一步。保留配置、确认导入结果，再让客户端接管需要代理的应用。
首次安装
打开客户端后，服务器列表为空属于尚未导入配置的状态。先准备有权使用的订阅地址、分享链接或配置文件，再使用客户端对应的导入入口。订阅地址是用来获取配置的地址，不是本地监听地址，也不应填写到系统代理的服务器栏。
订阅导入后，需要执行更新订阅并检查服务器列表。列表出现条目并不代表条目一定可连接；还需选择服务器、启动连接，并根据日志与应用访问结果确认配置有效。配置中的协议、传输方式与安全层必须相互对应。
查看导入与连接教程 →更新与迁移
更新前先导出配置，把备份放在应用目录之外。除订阅分组外，还应记录自定义路由、本地监听端口、分应用代理选择与系统代理模式。仅保留订阅地址通常不能恢复全部个性化设置。
退出旧实例后再安装新包，更新完成先检查能否正常启动，再恢复配置。若准备切换界面版本或内核家族，优先小范围验证已有配置，不要同时更改协议、路由和代理模式，否则出现问题时难以判断是哪项变化造成的。
查看协议与内核兼容说明 →下载、安装、连接分开排查
下载失败时先检查浏览器下载记录，确认是否被网络中断、磁盘空间不足或系统下载策略拦截。文件仍处于临时下载状态时不要改名后安装。重新下载前可先清理未完成的同名文件，避免把旧文件误认为新下载结果。
安装失败时记录安装器原文，区分架构不匹配、系统版本不满足、依赖缺失和已有安装冲突。安装成功但连接失败则应转向配置、内核启动与系统代理状态，不必反复重装客户端。浏览器连接结果、客户端日志与所选路由需要放在一起判断。
页面中的版本文字反映更新清单的标记，安装包链接由下载清单分别维护。不同客户端的发布节奏不同；选择时以系统、架构和兼容需求为先，不要仅根据版本数字大小判断适用性。更多常见现象可到疑难解答按问题查找。
下载相关问题
安装包选择 FAQ
Windows 桌面版与经典 WPF 版应该选哪个？
首次使用可先选桌面版 Desktop，它采用新一代跨平台界面。习惯传统 Windows 操作布局时，可选经典稳定的 WPF 版。两者都属于 v2rayN，切换前先备份配置，不要让两个实例同时接管系统代理。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常先选 arm64，但仍需确认系统能够运行 64 位应用。如果设备架构不明，或 arm64 安装包提示不兼容，可尝试通用版。通用版并不能解决系统版本过旧或安装包签名不同的问题。
下载客户端后是否已经有可用配置？
客户端安装包与服务器配置是两部分。安装完成后，需要导入有权使用的分享链接、订阅地址或配置文件，再选择服务器并启动连接。订阅地址可能包含访问凭据，不要放入公开截图或日志。
更新安装前需要保留哪些内容？
先通过客户端的导出或备份功能保存配置，并记录订阅分组、路由规则与本地监听端口。退出旧客户端后再更新。移动端覆盖安装通常需要相同包名和签名；若安装器提示冲突，不要直接卸载，先确认备份能够恢复。
下载完成但无法安装，先检查什么？
先确认文件已经下载完成，再核对操作系统、处理器架构与包格式。Windows 的 ZIP 文件需要解压，Android 使用 APK，macOS 使用 DMG，Linux 按发行版选择 deb 或 rpm。保留安装器的具体错误信息，再到疑难解答页按提示排查。