Windows · x64
v2rayN
7.24.1桌面版采用新一代跨平台 UI；经典 WPF 版保留熟悉的 Windows 操作界面。首次安装可从桌面版开始。
文件为 ZIP 压缩包。下载完成后先解压，再运行包内安装程序。
安装包 · 按平台选择
V2Ray 下载
V2Ray 下载
客户端安装包
先选系统，再确认处理器架构。
Windows 安装要求与检查位置
| 检查项 | 要求与处理方式 |
|---|---|
| 系统与架构 | 本页提供 x64 包。具体最低系统版本以对应发行说明及安装程序检测为准。 |
| 安装文件 | 完整解压 ZIP；不要在压缩包预览窗口内直接启动安装程序。 |
| 运行环境 | 若安装程序提示缺少运行组件，按提示补齐对应环境，不凭名称安装不相关组件。 |
| 权限与网络 | 普通代理与 Tun 模式的权限需求不同；启用 Tun 前检查权限、虚拟网卡及其他 VPN 是否冲突。 |
安装前关闭正在运行的旧客户端。两个版本不宜同时启动，否则可能争用相同的本地监听端口，也可能交替修改系统代理。需要换版时，先备份现有配置，再在新界面核对订阅分组、监听端口与路由模式；确认连接正常后，再清理旧目录。不要把卸载旧版当作故障排查的第一步。
macOS · 按芯片选择
v2rayN
7.24.1在苹果菜单的“关于本机”查看芯片。显示 Apple 芯片选 Apple Silicon；显示 Intel 处理器选 Intel。
打开 DMG，按磁盘映像内的提示将应用放入“应用程序”，再从应用程序目录启动。
macOS 安装要求与检查位置
| 检查项 | 要求与处理方式 |
|---|---|
| 芯片架构 | Apple Silicon 对应 arm64；Intel 对应 x64。以“关于本机”显示的信息为准。 |
| 系统版本 | 在“关于本机”查看版本；是否满足要求，以当前安装包提示与对应发行说明为准。 |
| 安装位置 | 将应用复制到“应用程序”，完成复制后再退出磁盘映像，避免一直从临时挂载位置运行。 |
| 网络权限 | 按所选代理模式确认系统授权；切换模式前先停止连接，避免与其他网络工具重复接管。 |
如果系统阻止启动，不要连续重复打开。先区分架构不匹配、开发者验证限制和文件损坏等不同提示。确认来源后，开发者验证相关选项可在“系统设置 → 隐私与安全性”中查看；遇到明确的风险提示应停止运行并重新确认来源。升级前记录原有代理设置，退出客户端后再替换应用，避免旧进程继续占用文件或端口。
Android · Xray 内核
v2rayNG
2.2.62015 年后的主流手机优先选 arm64；设备架构不确定时可选通用版。仍需以系统实际支持的应用架构为准。
APK 安装包。首次连接使用 VPN 模式时，需要确认系统的 VPN 连接授权。
Android · v2fly 内核
v2flyNG
1.10.31适合已有配置明确面向 v2fly 内核的使用场景。导入前检查协议及传输参数，不要假定不同内核支持的功能完全相同。
与 v2rayNG 是不同客户端。迁移时重新导入配置，并分别确认路由和分应用设置。
Android 安装要求与检查位置
| 检查项 | 要求与处理方式 |
|---|---|
| 处理器架构 | arm64 适合支持该应用架构的设备；通用版覆盖多种架构，包体通常更大。 |
| 系统版本 | 在“设置 → 关于手机”查看；具体兼容范围以当前 APK 的安装检测与发行说明为准。 |
| 安装授权 | 仅为正在使用的浏览器或文件管理器授予所需的安装权限，安装完成后可按需收回。 |
| VPN 与后台 | 首次连接确认 VPN 授权；持续使用时检查电池优化、后台活动和系统自启动限制。 |
打开 APK 后如果提示无法安装，先看具体原因：架构不兼容、系统版本不满足、已有应用签名不同，处理路径各不相同。通用版只解决架构选择问题，不能绕过系统版本或签名限制。设备年份只能作为初步判断，少数设备即使处理器支持 64 位，系统仍可能限制可运行的应用架构。
进入客户端后，先导入配置，再发起连接。VPN 授权用于让客户端通过系统提供的网络接口接管流量，不等同于远程服务器已经可用。若锁屏后断连，先看电池优化与后台限制；若只有某些应用无法访问，再检查“分应用代理”究竟采用绕行还是仅代理所选应用。修改名单后重新连接，确认新规则已经应用。
查看 VPN 授权与省电设置笔记 →Linux · deb / rpm
v2rayN
7.24.1先确认发行版的包格式，再确认处理器架构。Debian、Ubuntu 系通常选 deb；Fedora、RHEL 系通常使用 rpm，但仍需核对依赖兼容性。
使用发行版的软件安装器打开文件。若依赖不满足，先阅读安装器提示，不强制跳过依赖检查。
Linux 安装要求与检查位置
| 检查项 | 要求与处理方式 |
|---|---|
| 包格式 | 按发行版包管理体系选择 deb 或 rpm，不通过改扩展名转换包格式。 |
| 硬件架构 | x64 使用 amd64 / x86_64 包；arm64 使用 arm64 / aarch64 包。 |
| 桌面环境 | 需要可运行图形应用的桌面环境；具体系统库与运行组件要求以安装器提示为准。 |
| 代理接管 | 桌面环境与应用读取系统代理的方式可能不同；先验证单个应用，再检查 Tun 所需权限。 |
完成安装后，从应用菜单启动客户端，先观察是否能够正常显示主界面。安装器报告依赖缺失与客户端启动后连接失败属于两个阶段，不应混在一起处理。前者检查系统库和包兼容性，后者检查配置、监听地址与代理模式。不要为解决普通启动问题长期以高权限运行整个桌面会话，也不要在尚未验证普通代理时一次开启多种流量接管方式。
安装后：配置与连接检查
程序能打开、配置能导入、流量已接管，是三个不同的检查点。
导入配置，再选择模式
客户端本身不提供服务器。先准备有权使用的订阅地址或配置，在订阅分组中添加并更新，确认列表出现可用配置后，再选择要使用的服务器。订阅地址可能包含访问凭据，不要发送到公开评论区或连同日志一起分享。
桌面端先使用适合当前应用的系统代理设置；安卓端先确认 VPN 模式及系统授权。Tun 模式、分应用代理和自定义 DNS 都可以稍后逐项配置，不必在第一次连接前同时开启。
按步骤完成首次连接 →系统代理
自动配置系统代理供读取系统代理的应用使用
Tun 模式需要时再配置权限
界面仅示意设置关系，不是可操作控件。各客户端及不同版本的菜单位置可能变化，以实际界面为准。
先保留基线，再逐项调整
安装或更新前，备份订阅分组、手动添加的配置及自定义路由。备份文件同样可能含有敏感信息，应存放在自己可控的位置。更新后先用原有模式连接，确认日志没有持续报错，再逐项恢复高级设置。这样即使出现问题，也能明确是哪一次变更引起，而不是在多个开关之间反复试错。
连接后，用实际需要访问的应用验证结果。系统代理开关显示开启，只说明系统设置已被修改，并不保证所有应用都读取该设置；安卓通知栏显示 VPN 图标，也不保证当前服务器能够完成连接。验证失败时，记录客户端名称、系统信息、具体错误与复现步骤，分享日志前先遮去订阅地址和认证参数。
安装包常见问题
先确认包选得对，再处理安装权限与连接设置。
Windows 桌面版和经典 WPF 版应该选哪个？
首次安装优先选桌面版 Desktop，它采用新一代跨平台界面。经典 WPF 版是 Windows 上的经典稳定版，适合习惯原有界面的用户。两版都需要导入有效配置；切换前先备份，避免同时运行并争用本地监听端口。
Android 的 arm64 和通用版有什么区别？
2015 年后的主流手机通常优先选 arm64，但仍需确认系统支持的应用架构。通用版包含多种架构，适合不确定设备类型时使用。出现架构不兼容提示时，先查看设备信息，不要反复安装同一文件。
下载并安装客户端后，能直接连接吗？
客户端不附带可用服务器配置。需要自行准备有权使用的订阅地址或配置，导入后选择服务器，再设置系统代理或 VPN 模式并连接。客户端安装成功，只说明程序已经就绪，不代表网络连接已建立。
更新客户端前，需要卸载旧版吗？
先备份配置和路由设置，再关闭旧客户端并按安装程序提示更新。Android 使用相同包名与签名且版本允许升级时，通常可以覆盖安装；提示签名不一致时不要直接卸载，应先导出配置。跨客户端迁移不能视为普通覆盖更新。
macOS 提示应用无法打开时怎么处理？
先在“关于本机”确认芯片，排除安装包架构选错，再核对系统给出的具体提示。若提示开发者验证相关限制，可在确认来源后查看“系统设置 → 隐私与安全性”选项；若提示文件损坏或恶意软件风险，应停止运行并重新确认来源，不要关闭系统整体安全保护。
安装成功但无法上网，下一步检查什么？
先退出其他代理或 VPN，确认原有网络能够直连，再查看客户端日志与配置是否有效。桌面端检查“自动配置系统代理”及本地监听端口，安卓端检查 VPN 授权与后台限制。只有部分应用失效时，再检查应用自身代理与路由规则，避免同时改动多个设置。