v2rayN / Windows
7.24.1Desktop 采用新一代跨平台 UI，适合首次安装。WPF 保留经典界面，是沿用原有操作习惯的经典稳定版。以下两个入口均为 x64 安装包，选择其中一个即可。
下载得到 ZIP 文件。先完整解压，再运行其中的安装程序，不要直接从压缩包预览窗口启动。
CLIENT PACKAGES / 客户端安装
V2Ray 客户端下载
先选操作系统，再核对处理器架构。桌面使用 v2rayN；Android 首选 v2rayNG，也可按配置需求选择 v2flyNG。
永久免费
代码开源
图形界面
首次安装后还需导入订阅或分享链接。操作步骤见使用指南 →
按平台选择安装包
Windows 安装与系统要求
打开系统设置中的“系统 → 系统信息”，检查系统类型是否为 x64。安装包架构应与系统匹配；只知道处理器品牌，还不足以判断应下载哪种程序。页面列出的 Windows 入口对应 x64，不应根据文件名自行修改下载地址。
| 检查项目 | 要求与操作 |
|---|---|
| 操作系统 | 使用仍获得安全更新的 Windows；具体最低版本以当前安装程序的提示为准。 |
| 处理器架构 | x64 系统，先在系统信息中确认。 |
| 运行环境 | 按所选版本的启动提示安装对应运行环境，不混用不同架构组件。 |
| 权限与目录 | 安装路径应可读写；启用 TUN 时可能需要管理员权限。 |
将文件解压到固定目录，避免放在临时下载缓存中。安装后先以普通权限启动，确认主窗口与设置页可以打开。如果出现运行环境缺失提示，记录提示中的组件名称和架构，再完成安装；重复下载同一个包通常不能解决依赖缺失。
首次启动时先核对本地监听端口，再导入订阅。若准备从 WPF 切换到 Desktop，先导出已有配置，并保留可恢复的备份。不同界面的菜单位置可能不同，恢复后逐项检查订阅分组、路由和快捷操作，不要同时运行两个实例争用本地端口。
v2rayN / macOS
7.24.1Apple Silicon 设备选择 arm64；Intel 处理器设备选择 x64。点击系统菜单中的“关于本机”，查看“芯片”或“处理器”字段后再下载。
两个入口均为 DMG 安装镜像。按芯片选择，不以设备外观或购买年份代替系统信息。
macOS 安装与系统要求
下载完成后打开 DMG，将应用复制到“应用程序”目录，再从该目录启动。直接在挂载镜像中运行，会让更新位置和应用权限的排查变得混乱。完成复制后可以推出安装镜像，后续使用已经安装的应用。
| 检查项目 | 要求与操作 |
|---|---|
| 操作系统 | 使用仍获得安全更新的 macOS；最低系统版本以应用的兼容性提示为准。 |
| 芯片类型 | Apple Silicon 对应 arm64，Intel 对应 x64。 |
| 安装位置 | 复制到“应用程序”目录，确认目标位置具有写入权限。 |
| 网络权限 | 修改系统代理或启用 TUN 时，按系统提示核对并授予必要权限。 |
如果系统阻止首次打开，先确认文件来源与所选架构，再查看系统设置中的“隐私与安全性”提示，并按系统提供的操作处理。不要为了启动一个应用而关闭整套系统安全机制。设备受到组织管理时，应先确认管理策略是否允许更改网络设置。
启动后先进行最小配置：导入一组订阅、选择一个服务器、启用系统代理，再用遵循系统代理的浏览器验证连接。暂时保留默认本地端口，便于与教程逐项对照。只有明确需要接管其他应用流量时，再配置 TUN，避免把安装问题与路由问题混在一起。
v2rayNG / Android
2.2.6采用 Xray 内核。2015 年后的主流手机通常优先选择 arm64；设备架构不明确，或系统提示不兼容时，再考虑通用版。实际支持情况以设备系统为准。
卡片版本信息与当前包名可能存在发布同步差异。安装前查看系统安装器显示的版本，安装后在应用信息中确认实际版本。
v2flyNG / Android
1.10.31采用 v2fly 内核，适合已有配置明确面向该内核的使用场景。选择前确认订阅所需协议和传输设置，不能仅凭客户端名称相似就假定功能完全一致。
Android 安装与系统要求
两个客户端分别管理自己的配置。首次使用通常选择 v2rayNG 即可；只有明确需要 v2fly 内核时再选择 v2flyNG。通用版用于覆盖多种架构，并不代表连接能力更强，也不会直接改变服务器带宽。
| 检查项目 | 要求与操作 |
|---|---|
| 系统兼容性 | 由 Android 安装器检查当前应用所需的最低系统版本。 |
| 应用架构 | 主流设备先选 arm64；不确定时核对设备信息或选择通用版。 |
| 安装授权 | 仅向实际用于打开 APK 的浏览器或文件管理器授予安装权限。 |
| 连接权限 | 首次连接需确认系统 VPN 请求；同一时间通常只能运行一个 VPN 服务。 |
从浏览器下载记录或文件管理器打开 APK，核对应用名后继续安装。若提示应用未安装，先检查存储空间、架构与系统版本，再检查是否存在签名不同的旧应用。不要立即卸载旧版：先导出配置，否则本地保存的订阅与规则可能随卸载一起删除。
安装完成后导入订阅，选择服务器，再点击连接并确认系统权限。若切换到其他应用后连接频繁中断，检查电池优化和后台活动限制。应用本身能启动而连接失败，通常应转向配置、服务器和网络排查，不必反复更换安装包。
v2rayN / Linux
7.24.1按发行版的软件包体系选择 deb 或 rpm，主入口为 x64。Debian、Ubuntu 系通常选择 deb；采用 RPM 包管理体系的发行版选择 rpm，并确认系统依赖能够满足当前包的要求。
arm64 设备请使用对应架构：
Linux 安装与系统要求
先在系统“关于”或硬件信息页确认处理器架构，再查看发行版采用的包管理方式。x64 有时显示为 amd64 或 x86_64；arm64 有时显示为 aarch64。这些名称用于区分处理器指令集，不是不同的客户端功能版本。
| 检查项目 | 要求与操作 |
|---|---|
| 桌面环境 | 需要可运行图形应用的 Linux 桌面会话。 |
| 软件包格式 | 选择发行版支持的 deb 或 rpm，不能只修改扩展名转换格式。 |
| 处理器架构 | x64 与 arm64 分别使用对应安装包。 |
| 依赖与权限 | 由图形软件包管理器检查依赖；安装和 TUN 权限按系统提示处理。 |
使用系统的图形软件包安装器打开文件，先阅读依赖与兼容性提示。包管理器报告依赖无法满足时，应确认发行版版本和软件源状态，不要强制忽略依赖。安装包格式相同也不保证所有发行版均可直接运行，尤其要留意系统运行库要求。
完成安装后从应用菜单启动。先导入配置并测试本地代理，再检查桌面环境是否采纳系统代理设置。不同桌面和应用对系统代理的支持并不一致；某个应用没有使用代理，不等同于客户端安装失败。需要 TUN 时再核对权限与路由，避免同时改动多个网络入口。
INSTALLATION NOTES
安装前后检查顺序
将安装、配置与连接分开验证。先确认程序可以启动，再检查订阅和代理设置，能减少重复安装。
安装前：保存当前配置
升级已有客户端时，先使用程序提供的备份或导出功能保存配置。重点包括订阅分组、手动添加的服务器、自定义路由、本地监听端口和应用分流设置。导出文件可能含有访问凭据，应放在受控位置，不要发送到公开讨论区或共享文件夹。
接着停止连接并退出客户端。桌面应用关闭主窗口后可能仍在托盘运行，应确认后台实例已经退出再执行更新。保留原有配置和安装信息，可以在升级后逐项对照；不要在尚未确认新版本工作正常前清理旧备份。
安装后：先完成最小连接
打开客户端后，先检查订阅地址或分享链接的来源与有效性，再执行导入和更新。选择一个服务器作为当前活动项，确认本地监听端口未被其他程序占用。订阅更新成功只说明获取并解析了配置，不代表其中每个服务器都能连接。
桌面端先启用系统代理，用遵循系统代理设置的浏览器进行验证。Android 则在启动连接时确认系统 VPN 授权。此时先保持路由设置简单，确认基本连接可用后再添加自定义规则；不要把多个代理客户端同时启用，以免产生端口或路由冲突。
连接异常：记录具体错误
区分“程序无法启动”“订阅无法更新”“服务器连接失败”和“只有部分应用无法访问”四类现象。程序无法启动时检查依赖和权限；订阅问题检查地址与有效期；连接失败检查服务器参数和网络；部分应用异常再检查系统代理、DNS 与路由规则。
查看客户端日志时，优先记录错误类型、发生时间和对应操作。分享日志前去除订阅地址、服务器凭据等敏感内容。更换客户端之前先核对配置需要的协议与传输设置；客户端界面相近，不代表不同内核对所有配置都具有相同支持。
下载客户端后，是否已经具备连接配置？
安装包提供客户端程序，不包含可直接使用的服务器配置。首次启动后，需要导入自行管理或经授权获得的订阅地址、分享链接，再选择服务器并设置代理模式。订阅地址可能含有访问凭据，不要公开发送。
Windows 的 Desktop 和 WPF 应该选哪个？
首次安装可先选 Desktop，它采用新一代跨平台界面。WPF 是经典稳定版，适合沿用经典界面与操作习惯的用户。两者是不同界面版本，不需要同时安装。切换前应备份订阅分组、路由规则和自定义设置。
Android 的 arm64 与通用版如何选择？
2015 年后的主流手机通常先选 arm64，但仍需以设备实际支持的应用架构为准。若系统提示架构不兼容，可选择通用版；通用版包含多种架构支持，文件通常更大。安装失败时还应检查存储空间、系统兼容性和已有应用的签名。
更新客户端前需要保留哪些内容？
先使用客户端提供的备份或导出功能保存订阅分组、自定义路由、服务器配置与本地端口设置，再停止连接并退出程序。覆盖安装前核对目标客户端、架构与安装位置。更新后检查订阅、活动服务器、系统代理和 TUN 状态。
下载按钮无响应或文件中途停止怎么办？
先查看浏览器下载记录，确认是否已开始下载或等待保存位置确认，再检查磁盘空间与网络连接。中断后可重新点击原下载入口。若页面显示与文件名中的版本不同，应分别核对卡片信息和实际文件，不要仅凭文件名判断已安装版本。
安装完成后，为什么浏览器仍未使用代理？
先确认已导入配置并选择可用服务器，再检查系统代理是否启用，以及浏览器是否遵循系统代理设置。系统代理只影响采用该设置的应用。需要覆盖更多应用时，再按使用指南配置 TUN，并检查权限和路由，避免同时启用多个代理工具。