v2rayN
Desktop 桌面版 / 经典 WPF 版
Desktop 桌面版采用新一代跨平台 UI，适合首次使用或希望在不同桌面系统间保持相近操作习惯的用户。WPF 版是经典稳定版，保留熟悉的桌面布局；已有相应配置与操作习惯时，可以继续选择这一版。
下载得到的是 ZIP 压缩包。先在文件管理器中完整解压，再运行其中的安装程序，按向导完成安装。不要在压缩包预览窗口里直接启动。两版安装入口分开，不需要为了使用同一个订阅而同时运行两版。
安装后导入订阅 →客户端 / 安装包 / 架构选择
V2Ray 客户端下载
桌面选 v2rayN，安卓先选 v2rayNG。按系统与处理器架构定位安装包，再完成订阅导入和代理设置。
- 免费开源客户端
- 按架构选择
- 更新前备份配置
Windows 安装包
两个界面版本，同一桌面客户端；先按使用习惯选一版。
首推
安装完成后的检查顺序
首次打开后，先进入“订阅分组”添加已有订阅，再执行更新。服务器列表出现内容后，选择一个服务器进行真连接测试，最后设置系统代理。安装完成只代表程序能够启动，并不代表浏览器流量已经进入代理。
如果安装程序提示缺少运行环境，按提示确认需要的运行时类型与架构，不要把不同界面版本的依赖混为一谈。启动后若日志显示监听端口占用，先退出另一个正在运行的代理客户端，再检查本地端口设置。重复安装通常不能解决端口冲突。
macOS 安装包
先看“关于本机”中的芯片信息，再选择对应 DMG。
v2rayN
Apple Silicon / Intel
打开苹果菜单中的“关于本机”。如果显示 Apple 芯片名称，选择 Apple Silicon 的 arm64 包；如果显示 Intel 处理器，选择 x64 包。架构匹配比文件大小更重要，不需要为了文件名中的“64”而改选 Intel 版。
下载后打开 DMG，将应用拖到“应用程序”文件夹，再从该文件夹启动。不要长期从挂载的磁盘映像运行，以免卸载映像后找不到程序，或更新时写入了错误位置。
查看桌面端配置步骤 →启动提示与代理权限
遇到系统安全提示时，先确认下载来源与文件架构，再查看“系统设置 → 隐私与安全性”中的相关说明。核实来源后，可按住 Control 点按应用并选择“打开”。不要为了启动一个应用而整体停用系统安全机制，也不要对不明文件套用绕过步骤。
导入配置后，先使用系统代理完成基本连接验证，再考虑 TUN。两种方式接管流量的范围不同，授权要求也不同。已有其他网络工具时，先退出其中一个再测试，避免重复修改系统代理与路由。退出客户端后如果浏览器仍无法访问网络，检查系统网络设置中是否残留手动代理。
Android 安装包
先选 v2rayNG；需要 V2Fly 内核兼容性时，再考虑 v2flyNG。
v2rayNG
Android · Xray 内核
2015 年后的主流手机通常选择 arm64。仍需注意：处理器具备 64 位能力，不等于系统一定允许安装 64 位应用。设备架构不明，或明确提示 arm64 包不兼容时，可以改试通用版。
v2rayNG 使用 Xray 内核，适合在手机上进行订阅导入、服务器选择与分应用代理。安装后第一次连接会出现系统 VPN 授权对话框，核对应用名称后再允许；这个授权本身不会提供订阅或服务器。
查看 v2rayNG 订阅导入 →v2flyNG
Android · V2Fly 内核
需要使用 V2Fly 内核，且已有配置与该内核兼容时，可选择 v2flyNG。它与 v2rayNG 属于不同应用，界面名称相近并不表示支持的协议、传输选项与配置行为完全相同。
从另一款应用迁移时，重新导入原始订阅或配置，再核对路由、DNS 与分应用代理设置。不要直接复制应用私有数据目录。两款应用可分别保留配置，但测试连接时应只让其中一款建立 VPN 连接。
安装失败与后台连接
如果系统提示应用未安装，先查看剩余空间与系统兼容提示，再检查手机里是否已经装有同名应用。来自不同分发渠道的应用可能使用不同签名，不能直接覆盖更新。不要直接卸载重装；先确认配置能够导出，并保存订阅来源和自定义设置。
连接建立后，若锁屏一段时间就断开，可以查看系统的电池优化与后台运行限制。是否允许长期后台运行，应结合连接需求与电量消耗决定。只希望少数应用经过代理时，可使用分应用代理缩小接管范围，再逐个确认目标应用是否已纳入规则。
Linux 安装包
先确认发行版的软件包格式，再核对 x64 或 arm64。
v2rayN
Linux 图形桌面客户端
Debian、Ubuntu 及相应衍生系统通常使用 deb；Fedora、RHEL 系及相应衍生系统通常使用 rpm。软件包格式匹配只是第一步，发行版版本、桌面环境与系统依赖也会影响安装结果。
双击安装包后，使用系统图形软件安装器查看依赖与兼容性提示。若系统提示依赖无法满足，应先确认发行版版本，而不是强制忽略依赖安装。这里提供的是图形桌面客户端，需要可用的桌面会话。
了解 TUN 模式配置 →桌面代理与应用代理的区别
客户端启动后，系统代理是否能影响目标应用，取决于桌面环境以及应用是否读取系统代理设置。浏览器能够连接，不代表所有软件都已经接管。先使用一个明确支持代理设置的应用完成验证，再根据需求选择应用内代理或 TUN。
需要启用 TUN 时，先阅读权限与路由说明，确认当前系统中没有其他工具重复接管网络。不要把整个图形桌面会话长期以高权限运行。更新后若系统代理未恢复，先查看客户端状态与桌面网络设置，再检查应用自己的代理配置。
从安装包到可用连接
下载前后，分别检查
安装包解决程序安装问题；订阅、路由与代理模式决定实际连接行为。分开检查，定位问题更直接。
下载前：确认设备与配置来源
先确认操作系统、处理器架构与软件包格式。电脑或手机的商品名称不能代替架构信息，同一系列设备也可能使用不同处理器。页面列出的条件是选包依据，不是对所有旧系统的兼容保证，最终还需阅读安装器的提示。
首次使用还需要准备有权使用的订阅或服务器配置。客户端与订阅服务是两件事：下载软件不等于取得网络服务，更新客户端也不会自动延长订阅有效期。服务是否可用，应向相应配置提供方确认。
更新前：保存现有设置
记录订阅分组、路由预设、DNS、本地监听端口与分应用代理规则。优先使用客户端提供的导出或备份入口；如果采用目录备份，应先退出客户端，避免复制到仍在写入的数据。
备份中可能含有服务器凭据和订阅访问参数，应保存在个人可控位置。更新时先退出旧程序，完成后核对服务器列表与路由状态，再恢复系统代理或 TUN。不要同时启动新旧版本测试同一个监听端口。
Windows 桌面版和 WPF 版应该选哪个？
首次安装可先选择 Desktop 桌面版，它使用新一代跨平台界面；习惯经典窗口布局的用户可以选择 WPF 经典稳定版。两者都用于管理代理配置，不必同时安装。切换界面版本前，先备份订阅分组、路由与自定义设置，再按新版本支持的方式导入。
Android 的 arm64 与通用版有什么区别？
2015 年后的主流手机通常选择 arm64，但仍应以设备实际支持的应用架构为准。通用版包含多种架构，适合架构不明或 arm64 安装失败时尝试，文件通常更大。出现安装失败时，也要检查系统版本、剩余空间及已有应用的签名兼容性。
下载并安装客户端后，为什么还没有服务器？
客户端负责读取配置与转发流量，安装包本身不附带可用服务器。需要准备有权使用的订阅地址或服务器配置，在订阅分组中添加并更新，或从剪贴板导入。订阅链接可能含有访问凭据，不要公开分享完整链接或带凭据的截图。
macOS 提示无法打开应用时怎么处理？
先确认安装包与芯片类型匹配，并已将应用拖入应用程序文件夹。核实下载来源后，可以在访达中按住 Control 点按应用并选择“打开”，或查看“系统设置”中的“隐私与安全性”提示。不要为运行单个应用而整体关闭系统安全机制；持续报错时记录完整提示再排查。
更新客户端之前需要备份什么？
记录订阅分组、当前服务器、路由预设、DNS、自定义规则与本地监听端口；优先使用当前客户端提供的导出或备份功能。备份文件可能包含敏感配置，应保存在个人可控位置。退出旧客户端后再更新，完成后复查系统代理、TUN 与路由状态。
安装包版本文字和文件名不一致，以哪个为准？
页面版本文字与下载文件名可能在发布更新期间暂时不同步。文件名用于识别具体安装包，安装后的实际版本以客户端“关于”或“检查更新”页面为准。不要仅凭页面版本文字判断是否完成升级；如需保留旧配置，先备份，再检查新版本的迁移说明。