客户端安装包
桌面端选择 v2rayN，安卓优先选择 v2rayNG。先确认操作系统，再核对芯片架构；安装包格式与配置中的协议类型是两件不同的事。
01选择系统
02确认架构
03安装并导入配置
新一代跨平台 UI，适合首次安装，也适合希望在不同桌面系统间保持相近操作习惯的用户。下载 ZIP 后先完整解压，再运行其中的安装程序，不要在压缩包预览窗口内直接启动。
经典稳定版，沿用 Windows WPF 界面，适合熟悉原有菜单与操作路径的用户。与 Desktop 的区别主要在界面实现和交互布局，并不是两种代理协议；不必仅为使用某种节点类型而更换界面。
| 检查项 | 选择依据 | 操作提示 |
|---|---|---|
| 系统架构 | 当前入口为 x64 安装包 | 在设置 → 系统 → 系统信息中查看系统类型。 |
| 系统与运行环境 | 须满足所选发行包的系统及运行库要求 | 若安装器提示缺少运行组件，按提示补齐；旧系统先确认兼容性。 |
| 安装目录 | 使用当前账户可正常访问的位置 | 解压应保留目录结构，不要只移动单个可执行文件。 |
| 配置入口 | 订阅分组或分享链接导入 | 导入后选中服务器，再检查系统代理及路由设置。 |
首次启动后，先查看设置里的本地监听端口，再决定是否启用系统代理。浏览器通常可读取系统代理，但有些应用使用自己的网络设置，需要单独指定代理入口。不要把“程序已启动”当作“所有应用都已接入”的判断依据。
更新现有安装时，应先从托盘菜单退出旧进程。关闭主窗口有时只是将客户端收至托盘，旧进程仍可能占用端口。遇到新程序无法监听的提示，先排除重复运行，再调整端口，不必同时改动订阅和路由。
适用于 Apple M 系列芯片的 Mac，安装包采用 arm64 架构。在苹果菜单 → 关于本机中查看“芯片”字段；显示 M 系列时，优先选择对应原生架构，不需要为了保持与其他电脑相同而选 Intel 包。
适用于 Intel 处理器的 Mac，安装包采用 x64 架构。设备外观和购买年份只能提供线索，实际应以“关于本机”中的处理器信息为准。架构正确后，还需确认系统版本符合当前应用要求。
| 检查项 | 选择依据 | 操作提示 |
|---|---|---|
| 芯片 | Apple M 系列选 arm64；Intel 选 x64 | 苹果菜单 → 关于本机，查看芯片或处理器。 |
| 系统版本 | 满足当前发行包声明的最低要求 | 芯片匹配不代表旧系统一定可运行当前发行版。 |
| 安装格式 | DMG 磁盘映像 | 按提示复制应用，避免长期从挂载映像运行。 |
| 网络设置 | 按使用模式授权必要的网络变更 | 首次设置系统代理后，可在系统网络设置中确认结果。 |
若系统阻止首次打开，应先核实下载来源及应用名称，再查看系统设置 → 隐私与安全性中的具体提示。不要为运行单个客户端而全局关闭系统安全机制，也不要直接套用来源不明的终端命令。系统过旧、架构不匹配与打开权限属于不同问题，应分开处理。
安装后先导入订阅并选择服务器，再开启所需代理模式。更换网络或退出客户端后，如果浏览器无法连接，应检查系统网络设置是否仍保留指向本地端口的代理项。只清除已失效的代理设置即可，不必先删除全部客户端配置。
2015 年后的主流手机通常优先选择，前提是系统支持 arm64-v8a 应用。采用 Xray 内核，适合需要相应协议能力的配置。是否能导入并连接，还取决于客户端版本与服务端参数是否匹配。
包含多种架构，适合设备架构不明确或需要其他受支持架构的情况。通用版不代表系统要求更低，也不能解决所有安装错误；系统版本、剩余空间与已有应用签名仍需分别检查。
面向支持 arm64 应用的设备，作为已有 V2Fly 配置与操作习惯的备选。v2fly 与 Xray 的功能并非完全相同，不能仅凭分享链接外观相似，就认定全部安全层和传输参数都能直接复用。
用于架构不明确或其他受支持设备环境。选择客户端时，先核对配置所需的内核能力，再选择安装包架构。需要 Xray 特有能力的配置，应使用匹配的客户端，而不是反复更换同一应用的安装包。
| 检查项 | 选择依据 | 操作提示 |
|---|---|---|
| 应用架构 | arm64 或通用 APK | 以系统支持的 ABI 为准，不只看处理器型号。 |
| 系统兼容性 | 满足当前 APK 的最低系统要求 | 解析失败时检查系统版本、下载状态及存储空间。 |
| 安装权限 | 按系统提示允许当前来源安装应用 | 仅对实际使用的浏览器或文件管理器授予所需权限。 |
| 连接权限 | 首次连接需要确认 VPN 请求 | 同一时间的其他 VPN 应用可能与连接发生冲突。 |
安装完成后，先导入分享链接或订阅地址，更新并选择一条配置，再点击连接。系统弹出的 VPN 授权用于建立本地流量入口，不等于已经验证远端服务器。连接图标出现后，还应通过实际访问确认路由、DNS 和出站配置是否正常。
如果应用在锁屏后经常断开，可查看系统的电池优化与后台运行设置，按实际需要允许后台活动。不要一开始就同时放开所有权限；先确认问题是否与后台限制有关，再逐项调整。迁移到另一款客户端前，保存订阅地址和必要的自定义配置。
适用于以 deb 为原生软件包格式且满足依赖要求的发行版，例如兼容的 Debian、Ubuntu 环境。文件名中的 amd64 指常见 x64 架构，同样适用于匹配的 Intel 64 位电脑，不是仅供 AMD 处理器使用。
适用于采用 RPM 包管理且满足此包依赖的发行版。当前文件名含 el10 构建标识，安装前应核对目标发行版及运行库要求；不能仅凭文件扩展名相同，就认定适用于所有 RPM 系统。
| 检查项 | 选择依据 | 操作提示 |
|---|---|---|
| 软件包格式 | 发行版原生支持的 deb 或 rpm | 优先使用系统的软件安装器处理依赖。 |
| 处理器架构 | x64 对应 amd64 / x86_64；arm64 对应 aarch64 | 在系统信息中确认架构，不要混装不同架构包。 |
| 桌面环境 | 可运行图形应用的桌面会话 | 托盘和系统代理集成表现可能随桌面环境不同而变化。 |
| 发行版依赖 | 满足安装包要求的运行库版本 | 出现依赖错误时先看具体缺失项，不要强制忽略依赖安装。 |
在文件管理器中打开安装包，交由发行版的软件安装器完成安装。若软件安装器提示依赖无法满足，先确认当前发行版版本是否符合包的构建目标。更换包格式通常不能解决基础运行库过旧的问题，也不建议为了单个客户端混用其他发行版的软件源。
安装后的系统代理设置是否被应用读取，取决于桌面环境和应用自身实现。可以先在浏览器中验证，再检查不走系统代理的程序是否需要独立配置。退出客户端前清除不再使用的代理设置，避免本地监听关闭后，应用仍向旧端口发送请求。
安装后配置
先确认系统与架构，完成下载后使用系统安装流程打开。桌面端应先退出旧客户端，安卓更新则注意已有应用的签名与来源。新安装和覆盖更新的提示可能不同，遇到错误时先记录原文，不要立即删除配置。
在客户端的订阅分组管理中填写自行取得且有权使用的地址，保存后执行更新。分组名称仅用于区分来源，地址才是实际请求目标。订阅可能包含访问凭据，截图或求助时应遮盖完整链接，不要公开粘贴。
选中有效服务器，再设置桌面的系统代理或确认安卓连接授权。通过实际访问验证结果，必要时依次检查本地端口、路由、DNS 与系统时间。延迟测试只是单项参考，不能替代完整的应用访问测试。
v2rayN 用于 Windows、macOS 和 Linux 桌面环境，提供订阅、服务器选择和路由等图形设置。v2rayNG 与 v2flyNG 用于安卓，两者的界面习惯有相似之处，但内核能力不应混为一谈。选择时先看设备系统，再看现有配置需要的功能，最后确认架构和安装格式。
桌面端从一种界面迁移至另一种界面时，不建议直接覆盖不熟悉的数据目录。先使用客户端提供的导出功能保存配置，记录自定义路由和本地端口，再在新安装中逐项恢复。订阅可以重新获取的配置，与手动添加的条目，也应分别保留。
Project V 生态中的 V2Fly 与 Xray 有共同的技术背景，也各自演进出不同功能。VMess、VLESS 等名称只是配置的一部分，传输方式、安全层和扩展参数同样影响兼容性。分享链接可以被识别，并不必然表示其中每个字段都已被当前内核支持。
遇到配置导入成功但连接失败，应先对照服务端要求和客户端日志，而不是连续更换所有安装包。需要了解 REALITY、传输方式及内核差异时，可阅读协议手册；不熟悉入站、出站和路由等名词时，可先查阅术语表。
安装常见问题
初次安装可先选 Desktop 桌面版，它使用新一代跨平台界面；已经熟悉经典界面或需要延续原有操作习惯时，可选择经典稳定的 WPF 版。两种入口都是 v2rayN，当前提供的安装包均为 x64。切换前先导出配置并保存订阅信息，不要让两份客户端同时接管系统代理。
打开苹果菜单中的关于本机。如果芯片一栏显示 Apple M 系列，选择 Apple Silicon 安装包；如果处理器一栏显示 Intel，选择 Intel 安装包。芯片架构与系统版本是两项独立条件，安装前还需确认当前系统满足该发行包要求。
arm64 包面向支持 64 位 ARM 应用的设备，2015 年后的主流手机通常可优先选择；通用版包含多种架构，用于设备架构不明确或需要其他架构的情况。手机处理器支持 64 位不代表系统一定提供对应应用环境，若提示架构不兼容，应先确认系统支持的 ABI。
客户端是配置与连接工具，安装包不附带可用服务器或订阅。需要导入自行取得且有权使用的配置，更新订阅并选中有效条目，然后检查桌面的系统代理或安卓的 VPN 连接授权。客户端启动成功只能说明程序已运行，不能说明出站配置已经可用。
通常不需要为了更新主动删除配置，但不同发行版、安装位置和签名之间的迁移行为可能不同。更新前应导出配置并记录订阅分组、路由及本地端口，再完全退出客户端。安卓若提示签名不一致，不要直接卸载；先确认安装来源和备份是否完整，再决定迁移方式。
使用 Debian、Ubuntu 等以 deb 为原生包格式的发行版时选择 deb；使用以 RPM 为原生包格式的发行版时选择 rpm，并继续核对发行版版本及依赖。x64 适用于常见 Intel 或 AMD 64 位电脑，arm64 适用于对应 ARM 64 位环境。包格式相同并不保证所有发行版版本都兼容。