v2rayN
保留其中一套作为日常客户端即可。不要让两个实例同时占用相同的本地监听端口。
Windows：v2rayN
同一客户端的两套界面。以下均为 x64 安装包，下载后先解压，再运行包内安装程序。
系统准备与安装顺序
先在“设置 → 系统 → 系统信息”中查看系统类型，确认设备运行的是 x64 系统。这里的两个包均不是为其他架构单独提供的原生构建；若设备架构不同，应先确认系统的兼容运行能力。将 ZIP 保存到可写目录，完整解压后运行安装程序，不要直接在压缩包预览窗口内启动。
Desktop 与 WPF 的主要区别是界面技术和操作布局，不代表订阅内容可以省略，也不代表同一规则在不同内核中必然产生相同结果。首次使用建议保留默认参数，先导入配置并验证连接。已有用户切换界面前，先备份订阅分组、自定义路由和个人设置，不要把另一套程序直接覆盖到正在运行的目录。
如果程序启动时提示缺少运行组件，应按提示安装匹配架构的 .NET 桌面运行库；不同发布包是否自带运行环境可能不同，不必预先重复安装全部运行库。打开即退出时，还应检查安全软件的隔离记录和安装目录写入权限。日常使用系统代理通常不需要持续以管理员身份运行，只有相关网络功能明确要求提升权限时再处理。
| 项目 | 本页包类型 | 检查位置与要求 |
|---|---|---|
| 系统与架构 | Windows x64 | 在系统信息中确认系统类型；具体最低系统版本以对应发布包要求为准。 |
| 安装格式 | ZIP 内含安装程序 | 完整解压，关闭旧实例，再运行安装程序。 |
| 运行环境 | 按启动提示处理 | 提示缺少 .NET 时安装所需桌面运行库，注意架构匹配。 |
| 存储与权限 | 可写目录 | 保留解压、安装和配置写入空间，确认安全软件未隔离组件。 |
macOS：v2rayN
根据“关于本机”中的芯片或处理器名称选择。DMG 是安装映像，不是日常运行目录。
v2rayN
将应用拖入“应用程序”后再启动，更新前先退出已有 v2rayN 实例。
芯片识别与首次启动
打开屏幕左上角苹果菜单，进入“关于本机”。显示“芯片 Apple M…”的设备使用 arm64 包；显示“处理器 Intel…”的设备使用 x64 包。若曾经通过兼容层运行旧应用，也应优先选与硬件匹配的当前构建，而不是继续沿用旧安装包的架构。文件扩展名相同不代表内部程序适用于同一处理器。
双击下载的 DMG，按照映像窗口中的提示将 v2rayN 拖入“应用程序”。复制完成后，从“应用程序”目录打开客户端，再推出安装映像。这样可避免程序一直从临时挂载位置运行，也便于后续替换升级。系统给出安全提示时，应先阅读提示内容并确认应用来源，不要为一次安装关闭系统整体的安全检查。
首次启动后先导入配置，选择一个可用条目，再设置系统代理。系统代理只影响遵循该代理设置的应用，不能据此推断所有程序都已使用同一出口。TUN 属于另一种网络接管方式，可能涉及额外权限和路由调整；如果当前只需要浏览器使用代理，先完成系统代理的验证，再按配置参考决定是否启用 TUN。
| 项目 | 选择依据 | 安装要求 |
|---|---|---|
| Apple Silicon | Apple M 系列芯片 | 选择 arm64 DMG，并确认系统版本满足当前包要求。 |
| Intel | Intel 处理器 | 选择 x64 DMG，不与 arm64 包混用。 |
| 运行位置 | 应用程序目录 | 完成复制后启动，保留应用与配置写入所需空间。 |
| 网络权限 | 按功能授权 | 先验证基本连接；TUN 权限与普通系统代理分别处理。 |
Android：v2rayNG 与 v2flyNG
先展示采用 Xray 内核的 v2rayNG，再提供采用 V2Fly 内核的 v2flyNG 作为备选。两者分别维护配置。
v2rayNG
应用级版本文字与平台包文件名可能不同步；安装后可在“关于”页面确认实际版本。
v2flyNG
客户端外观相近不等于内核能力相同。不要直接套用其他内核专属的配置字段。
APK 安装、权限与后台运行
优先查看手机设置中的设备信息，或使用系统提供的应用兼容信息确认架构。处理器支持 64 位并不总能证明系统允许安装所有 64 位应用，因此遇到“应用未安装”时，应同时检查系统版本、存储空间和现有应用来源。通用版可以减少架构选择的不确定性，但不能解决签名冲突或系统版本过低的问题。
通过浏览器或文件管理器打开 APK 时，系统可能要求允许该来源安装应用。只为当前使用的来源授权，安装完成后可按需恢复。升级时通常应保留原应用和数据；如果系统提示与已安装应用冲突，不要立即卸载。先导出或记录订阅分组与自定义设置，再确认新旧包是否来自相同签名渠道，避免卸载后丢失本地配置。
首次启用连接时，Android 会显示 VPN 连接授权提示。这是客户端建立本地流量接管入口所需的系统授权，不是已经连接成功的证明。授权后还需要有效配置和可用服务端。若锁屏后连接经常中断，可在系统电池设置中查看后台限制，并确认其他 VPN 类应用没有同时占用连接；不同厂商的设置名称会有所不同。
| 项目 | 建议选择 | 需要确认 |
|---|---|---|
| 应用架构 | 主流设备先选 arm64 | 核对系统支持的应用架构；不确定时选择通用包。 |
| 系统版本 | 满足 APK 最低要求 | 最低要求随客户端发布变化，不以设备购买年份替代判断。 |
| 安装授权 | 当前浏览器或文件管理器 | 允许当前来源安装应用，并保留足够安装空间。 |
| 连接权限 | 系统 VPN 授权 | 首次连接确认授权；排除其他 VPN 类应用占用。 |
Linux：v2rayN
先按发行版选择 deb 或 rpm，再按处理器架构选择 x64 或 arm64。以下是图形桌面客户端。
v2rayN
rpm 文件名带有构建目标信息，不表示所有采用 rpm 的发行版都满足同一依赖条件。
发行版、架构与桌面环境
在系统“关于”或“系统信息”中确认发行版和架构。x86_64、amd64 通常对应这里的 x64 包；aarch64 对应 arm64。deb 与 rpm 的区别首先是包管理格式，而不是处理器型号，因此必须同时检查两项。不要通过修改扩展名把一种包当成另一种包使用，也不要在依赖报错时强行跳过包管理器的检查。
下载完成后，可从文件管理器打开安装包，交给系统的软件安装工具处理。安装器会读取包内依赖并请求必要权限；若提示依赖无法满足，先查看发行版版本、软件源状态和包的构建目标，而不是反复安装同一个文件。这里提供的是图形客户端，只有远程终端而没有桌面会话的环境，不适合照搬这套安装流程。
安装后从应用菜单启动 v2rayN，先导入配置，再查看本地监听端口。不同桌面环境的系统代理入口并不统一，客户端设置也不一定被所有应用读取。可先用一个明确支持 HTTP 或 SOCKS 代理的应用验证连接，确认基本配置正确后，再处理桌面系统代理或 TUN。涉及 TUN 时，应单独核对权限、路由和 DNS，避免同时修改过多网络选项。
| 项目 | 匹配方式 | 运行要求 |
|---|---|---|
| 包格式 | deb 或 rpm | 与发行版的软件包管理体系匹配，并满足包内依赖。 |
| 处理器 | x64 或 arm64 | 在系统信息中确认，不以发行版名称推断架构。 |
| 使用环境 | 图形桌面会话 | 需要能够运行图形应用的桌面环境及相关依赖。 |
| 网络功能 | 按功能设置权限 | 系统代理与 TUN 分别验证，避免多个客户端同时接管路由。 |
安装后的配置顺序
下载完成只是程序准备。连接结果还取决于订阅、所选配置、代理方式和应用自身设置。
导入配置
订阅链接与分享链接
在 v2rayN 中进入订阅分组设置，添加分组名称和订阅地址，保存后执行更新。v2rayNG 可从菜单中的订阅相关入口添加地址，再更新对应分组。单条分享链接与完整订阅并不相同：分享链接通常只描述一个配置，订阅地址则用于拉取一组条目。先辨认手中的内容，再选择导入方式。
查看订阅导入步骤 →选择代理方式
系统代理与路由分流
导入后先选择一个配置，再设置代理方式。系统代理决定哪些遵循系统设置的应用把请求交给客户端，路由规则则决定客户端收到请求后使用哪个出站。两者不是同一个开关。首次验证时应保持规则简单，连接成功后再添加域名、地址或应用级分流，并记录每次修改的结果。
查看 routing 配置 →确认兼容范围
协议与内核能力
VMess、VLESS、Trojan 是协议层面的选择，TLS、REALITY 及传输设置还需要与服务端逐项匹配。不能只看名称相同就认为参数完整。v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核；遇到 VLESS 等配置的兼容问题，应检查实际内核和版本支持，再核对传输、安全设置及服务端要求。
查看内核与字段范围 →扩大接管范围
TUN 模式与 DNS
需要接管不读取系统代理的应用时，再考虑 TUN。先保存原有配置，确认普通代理已经可用，然后按客户端提示授权。开启后同时测试域名解析和连接，避免把 DNS 失败误判为服务端不可达。TUN 的实现随客户端和调用的内核变化，不是给所有配置文件加入一个相同字段就能启用。
查看 TUN 配置范围 →更新前保留哪些设置
先记录现状，再替换程序。出错时可以区分安装变化与配置变化。
更新前保存订阅分组名称、更新方式、本地监听端口、自定义路由和 DNS 设置。订阅条目通常可以重新拉取，但手工添加的配置、应用分流和自定义规则未必能从订阅恢复。备份内容应存放在个人可控的位置，不要将含访问凭据的链接、配置二维码或日志原文公开发布。
升级时先完全退出旧客户端，尤其要检查托盘或后台是否仍有实例运行。完成安装后，先确认配置列表仍在，再逐项恢复需要的网络功能。不要同时更换客户端、内核、订阅和路由规则；一次只调整一个因素，才能判断连接变化来自哪里。若安装器明确提示不支持当前系统，应先核对系统要求，不要用重复下载代替兼容性检查。
v2rayN、v2rayNG、v2flyNG 都属于 Project V 相关开源生态中的图形客户端。客户端负责配置入口、订阅和系统集成，内核负责处理连接与路由。程序能够正常启动，不等于服务端参数已经匹配；订阅能够更新，也不等于其中每个条目都可用。验证时应分别观察导入结果、所选配置和实际应用访问，逐层确认。
下载与安装常见问题
先处理包类型与系统兼容，再进入订阅和连接排查。
Windows 应该选桌面版还是经典 WPF 版？
首次安装可先选 Desktop 桌面版，它采用新一代跨平台界面。习惯原有 Windows 操作布局时，可选经典稳定的 WPF 版。两个入口均为 x64 包，切换前先备份订阅分组与自定义设置，首次启动后核对本地监听端口。
Android 的 arm64 和通用版如何选择？
2015 年后的主流手机通常先选 arm64，但仍应以设备实际支持的应用架构为准。架构不明时可选通用版；通用包包含多种架构，通常体积更大。若安装失败，还需检查系统版本、可用空间和已有应用签名，不能只凭报错判断为架构问题。
macOS 如何区分 Apple Silicon 与 Intel？
打开苹果菜单中的“关于本机”。芯片一栏显示 Apple M 系列时选 Apple Silicon；处理器一栏显示 Intel 时选 Intel。下载 DMG 后打开磁盘映像，将应用拖入应用程序目录，再从该目录启动。
安装客户端后是否已经包含订阅或连接参数？
安装包提供客户端程序，不附带可直接使用的订阅或服务端连接参数。需要导入自行取得且有权使用的订阅链接或分享链接，再选择配置、设置代理方式并验证连接。订阅地址可能包含访问凭据，不应公开粘贴到截图或求助内容中。
卡片版本文字与下载文件名不同，应如何处理？
卡片版本文字读取应用级清单信息，具体文件名对应平台包条目，两者可能在发布期间不同步。先核对所选客户端、系统和架构；安装前记录文件名，安装后在客户端的关于页面确认实际版本。不要仅凭卡片版本文字推断文件名，也不要手动改写下载地址中的版本数字。