v2rayN 首推
7.24.1两个入口均为 x64 压缩包。桌面版是新一代跨平台 UI；经典 WPF 版是 Windows 专属的经典稳定版。首次使用可先选桌面版，已有使用习惯时再决定是否切换。
客户端安装包 · 平台与架构选择
V2Ray 客户端下载
桌面端选择 v2rayN，安卓端优先选择 v2rayNG。先确认操作系统，再按处理器架构选择安装包。
免费开源客户端；连接前需要另行导入有使用权限的订阅或节点配置。
安装包选择
按操作系统下载
平台选项会同步到地址栏，便于保存和分享。版本信息位于各客户端卡片内，下载前同时核对包格式与架构。
Windows：v2rayN 安装包
系统与安装前检查
| 检查项目 | 本页安装包适用条件 | 查看位置 |
|---|---|---|
| 系统与架构 | Windows x64；具体系统版本支持范围以所选发行包要求为准 | 设置 → 系统 → 系统信息，查看系统类型 |
| 运行依赖 | 依发行包而定；缺少运行库时按启动提示补齐对应架构组件 | 首次启动提示与应用程序错误信息 |
| 目录权限 | 程序与配置目录需要可写；压缩包需先完整解压 | 解压目标目录的属性与访问权限 |
解压、首次运行与版本切换
先在系统信息中确认“系统类型”为基于 x64 的处理器。系统显示为 ARM 时，不要只凭“64 位”三个字选择此处的 x64 包；应先确认设备的应用兼容条件。本页两个入口用于 x64 环境，不按处理器名称猜测其他架构的安装包。
下载完成后，将压缩包完整解压到固定、可写的目录，再运行其中的安装或启动程序。不要在压缩软件的预览窗口里直接运行，也不要只取出单个可执行文件。程序可能需要读取同目录组件，临时解压路径还容易导致后续配置位置不明确。
首次启动先保持默认监听设置，导入订阅并选中服务器，再按教程设置系统代理。桌面版与 WPF 版不要同时启动，否则可能争用本地监听端口。切换版本前先退出旧进程，保存配置；也不要在同一个目录里混合覆盖两套程序文件。
若启动提示缺少运行组件，记录提示里的组件名称、版本与架构，再进行安装。不要把所有启动失败都当成运行库问题：目录不可写、文件未解压完整、旧进程占用端口也会造成异常。详细顺序见安装与首次运行教程；两种界面的选择见桌面版与 WPF 版区别。
macOS：按芯片选择 v2rayN
v2rayN
7.24.1使用跨平台桌面界面，提供两种 DMG 安装包。在苹果菜单的“关于本机”中查看芯片或处理器信息，再选择对应入口。
系统与安装前检查
| 检查项目 | 本页安装包适用条件 | 查看位置 |
|---|---|---|
| 处理器 | Apple Silicon 对应 arm64；Intel 对应 x64 | 苹果菜单 → 关于本机 |
| 系统版本 | 需满足当前发行包的最低系统要求；旧系统先确认兼容性 | 关于本机中的 macOS 版本 |
| 安装权限 | 需要向应用程序目录写入的权限；额外网络功能按提示授权 | 系统设置中的隐私与安全性、网络相关设置 |
DMG 安装与网络设置
打开 DMG 后，按安装窗口提示将应用放入应用程序目录，再从应用程序目录启动。不要长期从磁盘映像内运行，以免卸载映像后找不到程序。安装完成并退出安装窗口后，可以推出对应磁盘映像，下载的 DMG 则按自己的备份习惯保存。
如果系统弹出安全提示，先确认提示所指向的文件确实是刚下载的客户端，查看完整原因，再按系统提供的应用级处理入口操作。不要为启动单个应用而全局关闭安全机制。系统版本不满足要求时，应先处理兼容问题，而不是反复授予权限。
首次运行后，先导入订阅、选中服务器并检查连接日志，再启用需要的代理方式。系统代理主要影响遵循系统代理设置的应用，不代表所有进程都会走同一条连接路径。浏览器能访问而其他应用失败时，要分别查看应用自身的网络设置。
从 Intel 设备迁移到 Apple Silicon 设备时，程序包应重新按新设备芯片选择；配置也应通过客户端支持的导出与导入方式迁移。完成后重新核对本地端口、路由与 DNS，不把旧设备上的网络权限当成已经迁移。基本连接顺序见订阅导入教程。
Android：v2rayNG 与 v2flyNG
v2rayNG 首推
2.2.6使用 Xray 内核。首次安装优先考虑此客户端，导入订阅后选择配置，再通过主界面连接按钮建立连接。
v2flyNG 备选
1.10.31使用 V2Fly 内核。适合明确需要此内核环境的用户；切换前先确认订阅所用协议、传输与参数的兼容性。
系统与安装前检查
| 检查项目 | 本页安装包适用条件 | 处理方式 |
|---|---|---|
| 系统兼容 | Android 系统版本需满足所选 APK 要求 | 设置 → 关于手机，核对系统版本 |
| 应用架构 | arm64 包要求系统支持相应 ABI；通用版含多架构组件 | 查看设备规格；不明确时尝试通用版 |
| 安装授权 | 安装 APK 时可能需要对当前浏览器或文件管理器授权 | 仅对实际用于安装的应用开放权限 |
| 连接权限 | 首次连接需要确认系统 VPN 请求；其他 VPN 应用可能冲突 | 阅读系统提示，停止其他正在运行的连接 |
APK 安装与首次连接
从下载记录或文件管理器打开 APK。系统要求安装授权时，只为当前使用的浏览器或文件管理器开启对应权限，完成安装后可按需要收回。若提示解析失败，先确认下载是否已完成，再核对 Android 版本与架构，不要通过修改文件扩展名绕过提示。
arm64 描述的是应用架构，不是系统版本。部分设备的处理器虽然支持 64 位，但所安装的系统只支持部分应用架构，因此不能仅凭购买年份判断。通用版便于覆盖不同设备，但不会增加协议功能，也不能解决系统版本过旧的问题。
安装后先添加订阅或导入分享链接，再更新配置并选中需要连接的服务器。首次点连接时，系统会请求建立 VPN 连接，这是客户端接管流量所需的系统授权。若另一款 VPN 应用正在工作，先停止它，再启动当前客户端，避免互相替换连接。
连接后频繁在锁屏时断开，应检查电池优化、后台运行和网络切换设置。只调整与当前客户端有关的选项，不必把所有应用都加入后台白名单。v2rayNG 与 v2flyNG 的路由、DNS 和高级参数应分别检查，不能因为订阅能导入就认为运行行为完全相同。
Linux：v2rayN 软件包
v2rayN
7.24.1面向图形桌面环境。先确认发行版的软件包格式，再区分 x64 与 arm64；包格式一致不代表所有发行版版本都能直接安装。
arm64 设备备选入口：先确认系统架构为 arm64 / aarch64，再按发行版选择。
系统与安装前检查
| 检查项目 | 本页安装包适用条件 | 查看位置 |
|---|---|---|
| 桌面环境 | 需要可运行图形应用的桌面会话与相应依赖 | 系统设置中的发行版与桌面信息 |
| 包管理体系 | deb 与 rpm 分别用于对应体系，具体依赖由包管理器检查 | 发行版软件安装器与软件包信息 |
| 处理器架构 | amd64 / x86_64 选择 x64；arm64 / aarch64 选择 arm64 | 系统详情中的硬件或架构信息 |
| 网络权限 | 普通代理与 TUN 的权限需求不同，先完成基础连接 | 客户端日志与系统权限提示 |
包格式、依赖与桌面启动
下载后通过发行版的软件安装器打开对应软件包，并阅读依赖检查结果。deb 与 rpm 是两套不同的打包体系，不应靠改后缀互换。遇到缺少依赖或版本冲突时，先确认发行版及其版本是否满足包的要求，不要强制忽略依赖继续安装。
同为 rpm 体系的发行版也可能存在系统库版本差异。文件名中的构建标记不能当成对所有 rpm 系统的兼容承诺。若软件安装器拒绝安装，保留完整提示，区分是架构不匹配、依赖版本不足还是包管理状态异常，再决定后续处理方式。
安装完成后，从桌面应用菜单启动 v2rayN。先导入配置、选择服务器并确认普通代理连接，再逐步调整路由与其他功能。桌面环境对系统代理的读取方式不同，部分应用仍需在自身设置中指定代理；系统代理开关不是所有程序都必须遵循的全局规则。
TUN 可能涉及额外权限与网络路由变更，不建议将它作为首次启动的前置条件。基础连接尚未验证时，同时开启复杂分流和 TUN 会增加排查难度。升级前保存当前配置与自定义规则，安装完成后检查桌面启动入口、监听端口和实际使用的配置目录。
下载后的配置顺序
安装完成只是第一步。按“导入、选择、连接、验证”的顺序操作，比一开始同时修改多个网络选项更容易定位问题。
客户端更新与配置保留
更新前先停止连接，退出客户端并确认旧进程已经结束。使用当前版本提供的导出或备份入口保存配置；如果需要复制配置目录，应先确认实际路径。程序目录、配置目录与系统安装目录不一定相同，只保存安装包不能代替配置备份。
订阅分组、自定义路由、DNS、监听端口和应用代理方式都可能影响升级后的连接行为。保存时不要只记住服务器备注，也要保留规则与参数。备份文件可能含订阅地址和节点凭据，应放在受控位置，不作为普通排错附件公开分享。
升级后先检查原有订阅是否存在、活动服务器是否正确，再验证端口和路由。确认日常使用正常后再清理旧文件。若需要回退，优先使用升级前保存的备份；不要默认新版本写出的所有配置都能被旧版本直接读取。
v2rayN、v2rayNG 与 v2flyNG 属于图形客户端，围绕 Project V、V2Fly 与 Xray 生态提供日常操作入口。选择时先看设备和配置兼容性，不以版本数字大小比较不同项目。需要进一步理解协议、路由与 TUN 的关系，可继续阅读从零到精通完整手册。
客户端下载常见问题
Windows 首次安装选桌面版还是经典 WPF 版？
新安装可先选 v2rayN 桌面版，使用新一代跨平台界面。经典 WPF 版是 Windows 专属的经典稳定版，适合沿用原有界面和操作习惯。两者不要同时启动；切换前先备份配置，并确认运行库要求。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但仍需确认系统支持 64 位应用。处理器架构不明确，或 arm64 包提示不兼容时，可尝试通用版。通用版包含多种架构组件，文件通常更大，不代表功能更多。
安装客户端以后为什么还不能连接？
客户端是配置与连接工具，安装包不附带可用服务器。需要自行准备有使用权限的订阅地址或节点配置，导入后选择服务器，再设置系统代理或连接模式。出现错误时先查看客户端日志，再判断是配置、网络还是权限问题。
更新客户端前怎样保留订阅和路由配置？
先停止连接并退出客户端，再使用当前版本提供的导出或备份功能保存配置。桌面端还应确认实际配置目录，避免只复制程序文件。升级后逐项检查订阅分组、活动服务器、监听端口与路由规则，暂时保留旧备份。
下载后提示无法安装或应用不兼容怎么办？
先核对平台、处理器架构和包格式。Windows 压缩包需要完整解压；macOS 要区分 Apple Silicon 与 Intel；Android 要检查系统架构和安装授权；Linux 要按发行版选择 deb 或 rpm。仍失败时记录完整报错，不要直接关闭系统安全保护。
v2rayNG 与 v2flyNG 可以直接互换配置吗？
两款客户端使用的内核不同，配置兼容性取决于协议、传输与具体参数。常见分享链接可以分别尝试导入，但不能据此认定全部高级设置都能互换。切换前保留原始订阅，在新客户端重新导入，并单独检查路由与 DNS 设置。