桌面端选 v2rayN，安卓端选 v2rayNG。
先确认操作系统，再选择界面、芯片和安装包格式。
两套界面，一个客户端。以下入口均为 x64 架构。
订阅分组、系统代理、路由规则与 TUN 模式集中管理。新安装可从桌面版开始；沿用经典操作习惯，可选择 WPF 版。
新一代跨平台 UI，适合希望在不同桌面系统间保持相近操作习惯的用户。
下载桌面版 · x64v2rayN-Desktop-Setup-x64-7.24.1.zip
面向 Windows 的经典稳定版。熟悉原有窗口布局与菜单操作时可继续选择。
下载经典 WPF 版 · x64v2rayN-Setup-x64-7.24.1.zip
这里提供的是 ZIP 文件。下载完成后先完整解压，再打开解压目录中的安装程序，按向导操作。不要直接在压缩包预览窗口中运行，也不要只拖出其中一个文件。应用启动后，先确认主窗口能正常显示，再导入配置；这样更容易区分安装问题与连接问题。
两个版本的差异主要在界面实现，不代表选择某一版就能获得更快的网络。实际连接仍取决于服务器配置、路由与本地网络。准备从旧界面迁移时，先备份配置和订阅分组，关闭旧实例，避免同时运行的程序争用本地监听端口或反复覆盖系统代理。
| 检查项目 | 要求与处理方式 |
|---|---|
| 系统架构 | 这两个入口均为 x64。打开“设置 → 系统 → 系统信息”，查看系统类型，勿按设备外观判断架构。 |
| 运行依赖 | 以安装向导和启动提示为准；出现缺少运行时的提示时，先核对提示的运行时名称与架构，再继续安装。 |
| 写入权限 | 配置目录需要可写。一般使用先以普通权限启动；启用 TUN 时再按客户端提示处理管理员权限。 |
| 已有代理 | 先退出其他接管系统代理或虚拟网卡的程序，确认一种接管方式可用后再逐项增加设置。 |
打开“关于本机”，根据芯片或处理器一栏选择安装包。
macOS 使用跨平台桌面界面。Apple Silicon 与 Intel 分别提供 DMG 安装入口，优先使用与本机芯片一致的构建。
“关于本机”显示 Apple M 系列芯片时，选择 arm64 安装包。
下载 Apple Silicon 版v2rayN-macos-arm64.dmg
“关于本机”显示 Intel 处理器时，选择 x64 安装包。
下载 Intel 版v2rayN-macos-64.dmg
双击打开 DMG，将应用复制到“应用程序”文件夹，再从该文件夹启动。不要长期从挂载的磁盘映像中运行，否则更新、权限和路径管理容易混淆。完成复制后可推出磁盘映像；先测试窗口能否启动，再处理订阅和代理设置。
首次打开可能触发系统安全提示。先确认文件来源及所选芯片架构，再查看“系统设置 → 隐私与安全性”中的相关说明。不要直接执行网上不明来源的解除限制命令。若应用能启动而浏览器没有走代理，应检查系统代理状态，而不是反复更换芯片安装包。
更新前退出正在运行的旧版本。保留配置备份，复制替换应用后再打开，确认订阅分组、路由选择及监听端口是否仍符合原来的用途。TUN 涉及额外权限与网络接管，建议在普通代理连接可用后再单独配置。
| 检查项目 | 要求与处理方式 |
|---|---|
| 处理器 | Apple Silicon 对应 arm64；Intel 对应 x64。以“关于本机”显示的信息为准。 |
| 系统兼容 | 系统版本须满足当前应用构建要求；若启动提示系统过旧，应先处理兼容性，而非改动代理配置。 |
| 安装位置 | 复制至“应用程序”，并确保当前账户可正常打开应用、写入用户配置目录。 |
| 网络权限 | 依据系统弹窗授予必要权限；需要 TUN 时单独检查相关授权，不必在首次启动时同时启用所有功能。 |
优先选择 v2rayNG；需要 V2Fly 内核生态时再考虑 v2flyNG。
Android 图形客户端，使用 Xray 内核，提供分享链接导入、订阅管理与分应用代理。2015 年后的主流手机通常优先选择 arm64。
面向支持 arm64-v8a 应用的系统。判断依据是系统支持的架构，不只是处理器型号。
下载 v2rayNG · arm64v2rayNG_2.3.11_arm64-v8a.apk
不确定设备支持哪种架构时可选。包含多种架构内容，文件通常比单架构包更大。
下载 v2rayNG · 通用版v2rayNG_2.3.11_universal.apk
下载 APK 后，从浏览器下载列表或文件管理器打开。若系统要求允许安装此来源的应用，仅为当前使用的浏览器或文件管理器授予权限，完成后可撤销。出现“应用未安装”时，先记录具体提示，再检查剩余空间、架构和已有应用签名，不要把所有安装失败都归因于网络。
导入配置后，首次连接会出现系统 VPN 连接授权，这是客户端通过 VpnService 接管流量所需的系统确认。允许后仍应检查当前配置是否选中。若锁屏后连接中断，再到系统电池设置中为客户端调整后台限制；不要一开始就修改所有省电选项。
采用 V2Fly 内核的 Android 备选客户端。已有配置依赖该内核的具体行为时，可先确认协议、传输与相关参数是否适配，再决定使用。
支持 arm64 应用的手机优先使用此包，安装前保留原有订阅与配置备份。
下载 v2flyNG · arm64v2flyNG_1.10.31-fdroid_arm64-v8a.apk
设备架构不明确时使用。通用包不代表可以忽略系统版本与配置兼容条件。
下载 v2flyNG · 通用版v2flyNG_1.10.31-fdroid_universal.apk
v2rayNG 与 v2flyNG 并不是靠改名区分的同一安装包。内核生态不同，具体配置项的支持情况也可能不同。不要默认所有分享链接都能在两者间完全等价迁移；先核对配置所要求的协议和传输能力。测试时每次只启动一个 VPN 连接，避免系统接管状态互相替换而造成误判。
| 检查项目 | 要求与处理方式 |
|---|---|
| 应用架构 | arm64 适用于支持相应 ABI 的系统；无法确认时选择通用版，仍需满足安装器提示的系统要求。 |
| 安装权限 | 按系统提示允许当前来源安装 APK。更新时检查应用标识与签名兼容性。 |
| VPN 授权 | 首次连接接受系统 VPN 请求。已有其他 VPN 工作时，先明确需要保留哪一个连接。 |
| 后台运行 | 出现锁屏断连后再检查电池优化、自启动与后台活动权限，具体路径随设备系统而异。 |
先看发行版的软件包体系，再确认 x64 或 arm64 架构。
Linux 图形桌面使用跨平台界面。下方主入口为 x64，arm64 设备使用各包格式下的对应入口。
用于 Debian、Ubuntu 及兼容发行版，通过系统软件安装器处理依赖。
下载 deb · x64v2rayn_7.24.1_amd64.deb
arm64 设备：下载 deb用于 Fedora、RHEL 系及兼容发行版，安装前确认当前发行版满足依赖条件。
下载 rpm · x64v2rayN-7.24.1-1.el10.x86_64.rpm
arm64 设备：下载 rpm在桌面环境中打开下载的软件包，先阅读安装器显示的包名、架构与依赖，再确认安装。deb 与 rpm 不能仅靠修改扩展名互换；即使扩展名一致，发行版版本和系统库也可能不满足要求。遇到依赖错误时，保留完整错误信息，优先处理系统兼容性，不要强行跳过依赖。
安装完成后从应用菜单启动 v2rayN。先导入一条可用配置并检查普通代理方式，再考虑 TUN。Linux 上桌面环境的系统代理设置、应用自身的代理设置与虚拟网卡接管并不是同一层；有些应用不读取桌面系统代理，需要单独配置，因此浏览器能连接并不代表所有程序都已接管。
更新前退出正在运行的客户端，备份用户配置。不要在不同权限账户下交替启动同一套配置，否则可能产生目录归属问题。需要高权限功能时，按客户端和系统的提示处理，不要把整套桌面程序长期以高权限运行当作通用解决方式。
| 检查项目 | 要求与处理方式 |
|---|---|
| 桌面环境 | 本页提供图形客户端。系统需要可用的桌面会话，以及当前构建要求的图形运行依赖。 |
| 软件包格式 | 按发行版选择 deb 或 rpm，不通过改扩展名或忽略依赖来跨体系安装。 |
| 处理器架构 | amd64、x86_64 对应 x64；arm64、aarch64 对应 ARM 64 位体系，按系统实际架构选择。 |
| 权限与接管 | 普通代理与 TUN 分开测试；TUN 需要额外权限和网络设置，先检查现有虚拟网卡及其他代理程序。 |
安装包负责程序，订阅负责配置，代理模式负责流量接管。分开检查，问题更容易定位。
客户端安装完成后不会自动生成可用服务器。桌面端可在“订阅分组”中添加地址后更新；单条分享链接可通过“服务器”菜单从剪贴板导入。安卓端可从添加菜单导入，再按实际情况更新订阅。确认地址完整，避免把订阅网页地址误当作订阅内容入口。
桌面端先检查“系统代理 → 自动配置系统代理”，再选择适合当前用途的路由。需要接管不读取系统代理的应用时，再研究 TUN。安卓端先完成 VPN 授权；使用分应用代理前确认列表代表代理还是绕行，避免把目标应用排除在接管范围之外。
先访问一个预期应走代理的目标，再检查预期直连的目标。出现问题时记录客户端日志中的错误类型，不要同时更改服务器、DNS、路由和 TUN。一次只改一个设置，复测结果后再继续。延迟测试有结果也不等于所有应用均能正常访问。
先确认包选对，再处理运行权限与配置。以下问答可直接展开。
新装可先选 Desktop 桌面版，它采用新一代跨平台界面；已经习惯经典界面的用户可选 WPF 稳定版。两者都用于管理代理配置。切换界面前备份配置，分别使用独立目录，不要让两个实例同时接管系统代理。
2015 年后的主流手机通常优先选择 arm64，但最终以系统支持的应用架构为准。无法确认架构时可选通用版。arm64 提示不兼容时，不要反复安装同一文件，先检查系统架构、剩余空间和已安装应用的签名是否一致。
安装包提供客户端程序，不附带订阅地址或服务器配置。需要准备自己有权使用的订阅或分享链接，再通过订阅分组更新或从剪贴板导入。订阅地址可能含访问凭据，不要放进公开截图、日志或留言。
先备份配置，再退出旧客户端并确认后台进程已结束。桌面端按安装向导处理；Android 通常可直接覆盖安装，但应用标识和签名必须兼容。遇到签名冲突时先确认安装来源，不要为了继续安装而直接删除尚未备份的数据。
先确认安装包与 Apple Silicon 或 Intel 芯片匹配，并已将应用复制到应用程序文件夹。若系统拦截首次打开，核对应用来源后查看系统设置中的隐私与安全性提示。保留系统安全机制，不使用来历不明的解除限制命令。
Debian、Ubuntu 及兼容发行版通常选 deb；Fedora、RHEL 系及兼容发行版通常选 rpm。还要分别确认处理器是 x64 还是 arm64。包格式相同不代表依赖一定满足，安装前仍需查看软件安装器给出的依赖与发行版兼容提示。