客户端安装包 / 四平台
V2Ray 客户端下载
桌面选择 v2rayN。Android 首选 v2rayNG，按 V2Fly 内核需求选择 v2flyNG。
先选系统，再选芯片架构。三款客户端均为免费开源软件；订阅地址与节点配置需要另行准备。安装包名称、客户端版本与内核版本属于不同信息，选包时以平台、架构和格式为准。
Windows 安装包
同一款 v2rayN，两种界面。首次安装可从 Desktop 开始。
系统与安装条件
| 检查项 | 选择依据 |
|---|---|
| 系统架构 | 本页 Windows 安装包为 x64；在“设置 → 系统 → 系统信息”查看“系统类型”。 |
| 系统版本 | 建议使用仍获系统更新的 Windows 10 / 11；旧系统需先确认当前客户端及运行时的兼容要求。 |
| 安装权限 | 普通系统代理不等同于 TUN；启用虚拟网卡相关功能时可能需要管理员授权。 |
下载得到 ZIP 后，先解压到普通文件夹，再运行其中的安装程序。不要在压缩包预览窗口中直接启动。安装路径应便于读写；若已有旧版，先退出托盘中的 v2rayN，避免两份程序同时争用本地监听端口。
首次启动后，在顶部“订阅分组”菜单进入“订阅分组设置”，添加分组名称和订阅地址，再更新订阅。服务器列表出现节点后，选择一个节点设为活动服务器。最后通过托盘菜单设置系统代理。只有启动客户端、没有指定活动节点或接管应用流量，浏览器仍可能保持原有连接方式。
Desktop 与 WPF 的菜单布局可能不同，配置迁移也不宜只靠复制程序文件。先记录订阅分组、路由选择和本地端口，再使用当前版本提供的备份或导出功能保留设置。运行时提示缺少组件时，应按安装程序提示确认依赖，而不是反复安装另一种界面版本。
macOS 安装包
在“关于本机”确认芯片，再选择对应 DMG。
v2rayN
系统与安装条件
| 检查项 | 选择依据 |
|---|---|
| 芯片架构 | Apple 菜单 → 关于本机，查看“芯片”或“处理器”字段。 |
| 系统版本 | 使用当前客户端支持的 macOS 版本；旧版系统需留意启动时的最低系统版本提示。 |
| 网络权限 | 系统代理与 TUN 是不同接管方式；涉及网络扩展或提权时，应先核对系统授权提示。 |
打开 DMG 后，将应用复制到“应用程序”文件夹，再从该位置启动。不要长期从挂载的磁盘映像运行，否则升级、权限记录和启动位置容易混淆。若系统阻止打开，先核对下载来源与系统提示，再到“系统设置 → 隐私与安全性”查看对应记录；不要为一次安装关闭整个系统的安全机制。
导入订阅后先选活动节点，再设置代理。在“系统设置 → 网络”中选择当前网络服务，进入“详细信息 → 代理”，可以检查系统代理是否与客户端显示的本地地址、端口一致。应用自带的独立代理设置可能覆盖系统行为，浏览器能连接并不意味着所有程序都会经过代理。
升级时先退出菜单栏中的客户端，再替换“应用程序”中的旧应用。若新版本启动后配置为空，先确认打开的是原来的应用位置与同一用户账户。遇到权限请求反复出现，应检查是否仍从 DMG 或旧副本启动，避免同时保留多个难以区分的运行副本。
Android 安装包
先选客户端，再选 arm64 或通用版。两款应用分别管理配置。
v2rayNG
首推常规安卓使用优先选择。支持订阅管理与节点导入，通过系统 VPN 接口接管流量；具体协议能力取决于应用所含内核。
2015 年后的主流手机通常选 arm64；架构不确定时选通用版。以设备系统实际支持的 ABI 为准。
v2flyNG
备选适合已有 V2Fly 配置需求的用户。与 v2rayNG 是独立应用；更换客户端前，应确认节点协议及传输设置能够被目标内核识别。
arm64 对应 64 位 ARM 系统；通用版覆盖更多架构，但安装包通常更大。
系统与安装条件
| 检查项 | 选择依据 |
|---|---|
| 系统兼容 | 以 Android 安装器对当前 APK 的兼容提示为准；处理器支持 64 位不代表系统一定提供 64 位运行环境。 |
| 安装授权 | 为实际打开 APK 的浏览器或文件管理器授予“安装未知应用”权限，安装完成后可收回。 |
| VPN 接口 | 首次连接需确认系统 VPN 授权；通常不能与另一款使用同类 VPN 接口的应用同时接管流量。 |
下载 APK 后，从下载记录或文件管理器打开。不同手机的设置名称略有区别，可在“设置”中搜索“安装未知应用”，只对本次打开文件的应用授权。安装器提示“应用未安装”时，先检查剩余存储、系统版本、CPU 架构及旧版签名，不要直接删除旧应用。
v2rayNG 中可从侧边菜单进入“订阅分组设置”添加地址，再在主界面的菜单中更新订阅。已有节点分享链接时，也可使用添加菜单中的剪贴板导入入口。节点出现后点击选中，再点击连接按钮，并确认系统弹出的 VPN 连接请求。订阅更新完成与服务已经连接是两件事，需要分别确认。
后台断连时，到系统“应用信息”中检查电池与后台活动限制。部分设备会在锁屏后收紧网络活动，应该先观察前台能否稳定连接，再调整相关权限。切换到 v2flyNG 时，使用订阅地址或兼容的分享链接重新导入；应用私有数据不会自动在两款客户端之间同步。
Linux 安装包
按发行版选择 deb / rpm，再确认 x64 或 arm64。
v2rayN
deb 软件包
Debian、Ubuntu 等采用 deb 包管理的发行版。默认入口为常见 Intel / AMD 64 位桌面架构。
下载v2rayN · x64 deb ARM 设备：下载 arm64 deb →系统与安装条件
| 检查项 | 选择依据 |
|---|---|
| 包管理格式 | 在系统软件中心或发行版说明中确认使用 deb 还是 rpm，不靠桌面外观判断。 |
| 处理器架构 | x64 对应 amd64 / x86_64；arm64 对应 aarch64。在系统“关于”或硬件信息中查看。 |
| 桌面与依赖 | 需要图形桌面环境及安装器要求的系统库；以软件管理器显示的依赖检查结果为准。 |
使用系统软件安装器打开下载的软件包，先阅读依赖与兼容提示，再确认安装。若安装器报告依赖无法满足，优先检查发行版版本是否与软件包要求一致。不要强行忽略依赖，也不要仅因同为 RPM 格式就认为可以跨发行版直接安装。
启动 v2rayN 后，先完成订阅导入和活动节点选择。Linux 桌面的系统代理通常由桌面环境维护，不同应用对它的遵循程度不一致。在 GNOME 中可到“设置 → 网络 → 网络代理”检查，在其他桌面中查找对应网络代理设置。终端程序或自带网络栈的应用可能仍需要单独配置。
TUN 涉及虚拟网络设备和权限，不应与系统代理混为一谈。首次测试先使用一种接管方式，确认本地端口、节点和路由正常，再增加其他功能。升级前关闭旧进程并备份配置；切换 deb / rpm 或改用另一架构不能替代正常迁移，也不能解决节点服务本身的连接问题。
安装后的三项检查
安装完成只是准备阶段。按订阅、节点、流量接管的顺序确认，排查时更容易定位。
订阅已导入
确认订阅地址完整，更新后列表出现预期节点。订阅更新失败时先看更新日志，区分地址失效、网络请求失败与格式无法解析。不要反复导入同一分组来掩盖错误。
查看订阅导入步骤 →节点已选中
订阅分组不是活动节点。选定服务器后再启动连接，并查看日志是否有监听端口占用、协议字段缺失或握手异常。列表中的名称只是备注，不代表服务一定可用。
查看连接与验证步骤 →应用已接管
系统代理依赖应用遵循设置，TUN 则通过虚拟网卡处理流量。先确认实际启用的方式，再检查路由规则。某个网站直连可能是分流结果，不应只凭页面能否打开判断。
查看全平台配置指南 →客户端界面版本、内核协议能力与服务器设置共同决定可用性。Project V、V2Fly 与 Xray 属于相关技术生态，但不是可以任意互换的配置标签。已有特殊传输或安全设置时，先确认目标客户端内核是否支持，再迁移节点。需要比较三款客户端时，可阅读客户端对比。
下载与安装常见问题
围绕选包、升级与首次连接整理。其他网络问题见常见问题。
下载客户端后，是否已经包含可用节点？
客户端负责管理配置与转发流量，安装包不等于节点服务。先准备有权使用的订阅地址或节点分享链接，再在客户端导入。订阅地址可能包含访问凭据，不要公开粘贴或放进截图。
Windows 的 Desktop 与 WPF 应该选哪个？
首次安装优先选 Desktop，它采用新一代跨平台界面。WPF 是经典稳定版，适合沿用原有 Windows 操作习惯的用户。两者都属于 v2rayN，本页提供的安装包均为 x64。更换界面版本前先备份配置，不要同时启动两份客户端。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但最终要以系统支持的 ABI 为准，不能只按处理器名称判断。无法确认架构时选择通用版。出现解析失败时还需检查系统版本、下载是否完成以及同名应用的签名是否一致。
升级前需要卸载旧版吗？
先备份配置，再退出旧客户端。同一应用且签名、架构和安装方式一致时，通常可覆盖升级。Android 出现签名冲突时不要直接卸载，以免丢失应用数据；先确认安装来源并导出配置。桌面更换安装目录或界面版本时，也应先保留原配置。
安装成功但网页打不开，应该重新下载吗？
先检查节点、订阅和代理接管方式，不必立即重新下载。在 v2rayN 服务器列表确认活动节点，查看底部日志，再检查系统代理；在 Android 确认已允许 VPN 连接并启动服务。端口冲突、订阅过期、系统时间或 TLS 参数异常，都不能通过重复安装解决。