v2rayN
Desktop 采用新一代跨平台 UI，适合首次安装，也便于在不同桌面系统之间保持相近的使用习惯。WPF 是经典稳定版，保留熟悉的 Windows 界面与操作布局。两者不是两个不同的代理服务，选择主要取决于界面习惯和当前系统的运行条件。
两个入口均为 ZIP 压缩包。下载后先完整解压，再运行其中的安装程序；不要在压缩包预览窗口内直接启动。准备切换界面版本时，先备份订阅分组与自定义设置，并退出原来的客户端，避免本地端口和系统代理设置互相覆盖。
客户端安装包 / 平台与架构
V2Ray 客户端下载
桌面选 v2rayN，安卓优先选 v2rayNG。先确认系统，再选择处理器架构与安装格式。
客户端永久免费、代码开源。安装完成后，仍需导入有效配置并验证代理是否生效。
按平台选择安装包
下载入口集中在客户端卡片内。切换平台可查看对应说明；架构不明确时，先查看下方系统要求，不必连续尝试多个包。
Windows 客户端
系统要求与首次运行
| 项目 | 选择依据 |
|---|---|
| 系统架构 | 本页两个包均为 x64，先在系统“关于”中查看系统类型。 |
| 运行环境 | 以所选版本的启动提示为准；缺少运行组件时按具体提示补齐。 |
| 安装目录 | 解压位置应可写，保留同目录文件，避免只移动主程序。 |
| 权限 | 普通系统代理与 Tun 的权限需求不同，先用系统代理验证。 |
如果双击后没有窗口，先检查任务栏通知区域，确认客户端是否已经运行。若提示端口被占用，退出其他代理程序后再试。不要将窗口未出现、运行环境缺失和节点超时混为同一种问题。
继续查看首次配置步骤 →macOS 客户端
v2rayN
打开苹果菜单中的“关于本机”，先看“芯片”或“处理器”一栏。显示 Apple M 系列芯片时选择 Apple Silicon；显示 Intel 时选择 x64。不要用机身外观或屏幕尺寸判断架构，同一产品系列可能跨越不同处理器平台。
打开 DMG 后，将应用复制到“应用程序”目录，再从该目录启动。首次运行若出现安全提示，先确认下载来源与系统提示内容，再通过系统提供的“隐私与安全性”入口处理。无需为运行客户端而整体关闭系统安全机制。
系统要求与安装位置
| 项目 | 选择依据 |
|---|---|
| Apple Silicon | M 系列芯片选择 arm64 DMG。 |
| Intel | Intel 处理器选择 x64 DMG。 |
| 系统兼容 | 最低系统版本以当前安装包的要求与系统提示为准。 |
| 运行位置 | 复制到“应用程序”后启动，不长期从挂载的磁盘映像运行。 |
应用成功打开只代表安装阶段完成。导入配置后还要确认系统代理是否启用；部分应用不读取系统代理，需要单独设置。遇到连接异常时，先检查代理范围，再考虑是否需要 Tun，避免同时改变多个变量。
查看权限与代理排查 →Android 客户端
v2rayNG
安卓首次使用优先选择 v2rayNG。2015 年后的主流手机通常可选 arm64，但少数设备的系统架构与处理器能力并不完全相同，最终以设备实际支持情况为准。无法确认架构时可选择通用版，它包含多种架构所需内容，包体通常更大。
安装 APK 后，导入已有配置并选择服务器。首次连接会出现系统 VPN 连接请求，确认授权后客户端才能建立本机流量接管通道。若希望只让部分应用走代理，应检查分应用代理名单，而不是用反复切换安装包解决流量范围问题。
v2flyNG
v2flyNG 适合作为有 V2Fly 内核配置需求时的备选。它与 v2rayNG 的名称接近，但内核能力和配置支持范围不能直接等同。使用前应确认订阅中的协议及传输参数是否适配，不要把客户端之间的配置差异理解成安装失败。
架构选择原则与上方相同：设备支持时选 arm64，不明确时选通用版。两款客户端可以分别保留配置，但连接测试时只启用其中一款的 VPN 服务。切换前先断开原来的连接，再启动另一款，便于判断实际由哪个客户端接管流量。
系统要求与授权检查
| 项目 | 选择依据 |
|---|---|
| 处理器架构 | arm64 适合支持 64 位应用的设备；通用包供架构不明确时选择。 |
| 系统版本 | 以当前 APK 的最低系统要求和安装器提示为准。 |
| 安装权限 | 为实际打开 APK 的浏览器或文件管理器授予“安装未知应用”权限。 |
| 连接权限 | 首次连接确认 VPN 请求；断连时检查后台电池限制与其他 VPN 应用。 |
卡片版本文本与文件名分别来自清单中的版本字段和下载字段，两者可能不同，应分别理解，不要据此自行改写下载地址。覆盖安装受到签名和版本升降级规则约束；若系统拒绝覆盖，先保留配置，再阅读具体错误提示。
Linux 客户端
v2rayN
先确定发行版的软件包体系，再确定处理器架构。Debian、Ubuntu 等系统通常使用 deb；采用 RPM 包管理体系的发行版选择 rpm。包格式相同不代表所有系统版本都满足依赖，仍需留意软件安装器给出的库版本要求。
普通 Intel 或 AMD 64 位电脑选择 x64；ARM 64 位设备选择下方 arm64 入口。文件名中的 amd64 与 x86_64 都属于此处的 x64 类别，aarch64 对应 arm64。安装时优先使用系统图形软件安装器，让依赖缺失和冲突提示集中显示。
系统要求与包格式
| 项目 | 选择依据 |
|---|---|
| 桌面环境 | 本页提供图形客户端，需要可用的图形桌面会话。 |
| deb | 适用于使用 Debian 软件包体系且满足当前包依赖的系统。 |
| rpm | 适用于 RPM 软件包体系，需核对发行版与依赖版本。 |
| 架构与权限 | 包架构应与系统一致；安装与 Tun 功能可能分别需要授权。 |
如果安装器报告依赖不满足，不要通过忽略依赖强行安装来绕过。先核对发行版版本与包格式。安装成功后，不同桌面环境对系统代理的读取方式可能不同，浏览器能访问也不能代表所有终端程序都已使用代理。
查看本地代理生效检查 →安装后的连接检查
下载、运行和连接是三个不同阶段。先完成当前阶段的检查，再调整后续设置，排查时更容易保留有效线索。
导入已有配置
客户端本身不附带可用服务器。桌面端通过订阅分组添加地址，再更新对应分组；安卓端通过订阅设置或分享链接入口导入。订阅地址与单条分享链接不是同一种内容，放错入口可能导致列表为空。
更新后先确认服务器列表确实出现条目，再选定一个配置。若订阅更新失败，应查看请求提示与返回内容，不要先修改路由或 DNS。订阅地址可能包含访问凭据，截图和提问时应遮盖完整地址。
选择代理范围
桌面端先确认系统代理模式，再检查需要访问网络的应用是否读取系统代理。Tun 会改变流量接管范围，并涉及额外权限和路由配置，不是安装后必须立刻打开的选项。先用较少变量完成一次连接验证。
安卓端确认 VPN 请求后，检查分应用代理是否包含目标应用。如果只在锁屏后断连，再检查电池优化和后台运行限制。连接期间保留单一 VPN 服务，避免其他应用接管后造成判断混乱。
验证实际访问
先对选定服务器进行真连接测速，再用目标应用验证访问。TCPing 主要反映端口连通情况，不能替代完整代理链路测试。测试失败时记录日志中的错误类型，区分本地监听失败、远端超时与名称解析异常。
浏览器访问正常而其他应用失败时，优先检查应用代理设置；全部应用失败时，再检查当前节点与网络。每次只调整一项，并记录调整前后的结果，比同时更换多个配置更容易定位原因。
下载与安装常见问题
先核对包类型和系统提示。安装问题通常发生在本地，不宜直接按服务器连接故障处理。
Windows 首次安装选 Desktop 还是 WPF？
首次使用可先选 Desktop，它采用新一代跨平台界面。WPF 是经典稳定版，适合已有操作习惯或需要经典界面的用户。两者都是 v2rayN，界面入口可能不同；切换前先备份配置，不要同时启用两份客户端的系统代理。
如何判断该下载 arm64 还是 x64？
先查看系统记录的处理器架构，不要只凭设备购买年份判断。macOS 在“关于本机”查看芯片，Apple Silicon 选 arm64，Intel 选 x64；Linux 根据系统架构选择 amd64、x86_64 或 arm64、aarch64 对应包。安卓主流手机通常选 arm64，无法确认兼容性时可选通用版。
下载后的 ZIP 为什么不能直接当作安装程序运行？
ZIP 是压缩容器。先完整解压到可写目录，再查看解压后的内容并运行其中的安装程序。不要只从压缩包预览窗口打开一个程序，否则同目录依赖文件可能无法正常读取。升级前先退出正在运行的客户端。
Android 提示无法安装或应用未安装怎么办？
先确认安装包适合设备架构，存储空间足够，并给当前浏览器或文件管理器授予“安装未知应用”权限。已有安装可能因签名不同或版本降级而无法覆盖；先备份配置，再根据系统提示处理，不要反复卸载尝试。
装好客户端以后为什么还不能连接？
安装只提供客户端，不会自动生成可用的服务器配置。需要导入已有的有效订阅或分享链接，更新分组并选择服务器，再启用合适的代理模式。桌面端检查系统代理，安卓端确认 VPN 授权，最后通过真连接测速与应用访问验证。
更新客户端前需要保留哪些内容？
先记录订阅分组、自定义路由、本地监听端口和代理模式，并使用客户端提供的备份或导出功能。配置中可能包含订阅地址和认证参数，备份应保存在受控位置。更新后先确认配置已读取，再测试连接，不要直接覆盖唯一一份备份。