客户端安装包
按平台、界面版本与处理器架构选择。桌面使用 v2rayN，安卓优先使用 v2rayNG。
先下载适配设备的安装包，再导入已有订阅。首次配置可对照入门指南 →
安装包选择
安装后的配置顺序
流程示意 · 安装包与连接配置分开准备
平台与架构
按钮标注安装包类型。系统要求表列出选择依据；实际安装还应以系统提示和当前软件包依赖为准。
同一客户端的两种界面。以下入口均面向 x64 系统。
新一代跨平台 UI。首次安装、希望在不同桌面系统间保持相近操作习惯时，可先选这一版。
下载桌面版 · x64ZIP 安装归档 · 下载后先解压
Windows 经典稳定版。适合熟悉原有 WPF 窗口与设置布局、希望延续现有使用习惯的用户。
下载经典 WPF 版 · x64ZIP 安装归档 · 与桌面版分开选择
两版差异主要体现在界面框架与交互布局，不代表某一版适合所有设备。已有配置的用户切换版本前，先导出设置并退出正在运行的客户端，避免两个实例同时接管系统代理。
打开“设置 → 系统 → 系统信息”，检查“系统类型”，确认操作系统与处理器架构。这里的安装入口是 x64 包，不应只凭电脑使用了 Windows 就判断适配。受组织管理的设备，还需要确认安装程序是否受应用控制策略限制。
| 检查项目 | 选择依据 | 安装前操作 |
|---|---|---|
| 系统架构 | 以下两包均为 x64 | 在系统信息中确认系统类型 |
| 系统环境 | 建议使用仍受系统厂商支持的 Windows | 检查系统更新及安装程序的运行库提示 |
| 安装文件 | ZIP 中包含安装内容 | 完整解压后再运行安装程序 |
| 代理入口 | 系统代理与本地监听端口 | 退出其他正在接管相同入口的客户端 |
不要在压缩文件预览窗口中直接运行程序。先将归档解压到可写入的位置，再打开安装程序。若提示缺少运行环境，记录完整提示并按系统引导处理，不要反复切换安装包来掩盖环境问题。安装完成后，先导入配置并选择服务器，再启用“自动配置系统代理”；应用是否遵循系统代理，仍取决于应用自身设置。
先查看“关于本机”，按芯片类型选择 DMG。
“关于本机”显示 Apple 芯片时选择 arm64，例如 M 系列芯片。按实际芯片判断，不按屏幕尺寸判断。
下载 Apple Silicon · arm64DMG 磁盘映像
“关于本机”显示 Intel 处理器时选择 x64。芯片架构与安装包应对应，不把转译运行作为默认选择。
下载 Intel · x64DMG 磁盘映像
打开 DMG 后，按映像内的引导安装应用。首次运行出现系统拦截时，先核对提示中的应用名称与来源信息，再到“系统设置 → 隐私与安全性”查看相关说明，不要为安装单个应用关闭整套系统防护。
点击系统菜单中的“关于本机”，查看“芯片”或“处理器”一栏。Apple Silicon 对应 arm64，Intel 对应 x64。即使两台设备使用相同的产品系列名称，处理器也可能不同；下载前以设备当前显示的信息为准。
| 检查项目 | 选择依据 | 安装前操作 |
|---|---|---|
| 处理器 | Apple Silicon 或 Intel | 在“关于本机”查看芯片或处理器 |
| 系统版本 | 须满足当前应用的运行要求 | 记录 macOS 版本，留意启动时兼容性提示 |
| 软件包格式 | DMG | 打开映像并按引导安装应用 |
| 网络权限 | 系统代理及按需启用的网络功能 | 阅读权限说明，确认用途后授权 |
安装与第一次启动是两个独立步骤。若应用没有正常打开，先看系统是否报告架构不匹配、系统版本过低或应用权限受限，再判断是否需要重新下载。应用可以打开但网页无法访问时，问题已经进入连接配置阶段，应检查订阅、服务器选择和系统代理，而不是重复安装。
先选客户端，再选架构。2015 年后的主流手机通常选择 arm64。
主流 64 位安卓手机优先选用。确认设备支持 arm64-v8a 后下载，安装包更有针对性。
下载 v2rayNG · arm64APK · 面向 arm64-v8a
不能确认设备架构时可考虑通用版。它兼顾多种架构，但仍需满足应用的系统版本要求。
下载 v2rayNG · 通用版APK · 多架构安装包
首次启动连接时，Android 会显示 VPN 连接授权。确认应用名称后授权；设备若已有其他 VPN 连接，应先处理占用关系。系统显示 VPN 标识，只能说明本地服务已建立，不能单独证明远端连接可用。
适合已确认使用 arm64 架构、需要 V2Fly 内核生态的设备。安装后仍需单独导入连接配置。
下载 v2flyNG · arm64APK · 面向 arm64-v8a
架构尚未确认时的备选包。不要把通用版理解为可以绕过系统版本、签名或设备策略限制。
下载 v2flyNG · 通用版APK · 多架构安装包
v2flyNG 与 v2rayNG 的内核家族不同。导入前确认分享链接所用的协议、传输方式与安全选项受到当前版本支持，不要将自定义 JSON 或某个内核专有字段直接视为通用配置。
设备年代只能帮助初步判断，不能代替架构信息。2015 年后的主流手机通常选择 arm64，但部分设备仍可能运行不同位数的系统。可以查看设备说明或系统信息，确认后再下载。若 arm64 包提示无法安装，先读具体错误，不要立刻认定是客户端故障。
| 检查项目 | 选择依据 | 安装前操作 |
|---|---|---|
| CPU 架构 | arm64 或通用版 | 查看设备说明及系统信息 |
| 系统兼容性 | 以当前 APK 的安装要求为准 | 检查 Android 版本和系统安装提示 |
| 安装来源权限 | 仅授权打开 APK 的应用 | 在系统询问时按需允许，完成后可收回 |
| 连接权限 | Android VPN 服务授权 | 确认应用名称，检查其他 VPN 的占用 |
如果系统提示应用未安装，区分架构不匹配、存储不足、安装来源受限以及现有应用签名不一致等情况。保留当前配置后再处理迁移，不要直接卸载仍有重要配置的旧应用。升级后若后台连接容易中断，再检查电池优化和后台活动权限；这些权限与 APK 能否安装不是同一层问题。
先匹配发行版的软件包格式，再匹配处理器架构。
Debian、Ubuntu 一类采用 deb 包管理体系的发行版通常从这里选择，安装时检查系统依赖。
下载 deb · x64amd64 软件包
arm64 设备：下载 deb →Fedora、RHEL 一类采用 rpm 包管理体系的发行版通常从这里选择，仍需确认发行版兼容性。
下载 rpm · x64x86_64 软件包
arm64 设备：下载 rpm →该入口用于图形桌面环境。包管理器可以帮助检查依赖与安装状态；遇到依赖不满足时，保留错误信息并核对系统环境，不要通过忽略依赖来强行安装。
deb、rpm 表示软件包格式，x64、arm64 表示处理器架构，两组条件必须同时对应。相同的包格式也不意味着跨发行版、跨版本都能直接运行：基础运行库、桌面环境和依赖版本同样会影响安装结果。下载前先在系统详情中记录发行版名称、版本与架构。
| 检查项目 | 选择依据 | 安装前操作 |
|---|---|---|
| 包管理体系 | deb 或 rpm | 按发行版的软件管理方式选择 |
| 处理器架构 | x64 或 arm64 | 查看系统详情中的架构信息 |
| 运行环境 | 图形桌面与相应运行库 | 使用包管理器检查软件包依赖 |
| 代理接入 | 桌面代理设置或应用独立设置 | 确认目标应用使用对应本地端口 |
安装完成后，从桌面应用菜单启动客户端。桌面系统代理、浏览器代理和其他应用的独立代理设置可能并不一致，因此不能只看客户端处于运行状态。先确认本地监听端口，再让目标应用使用这个入口；如果只有某一个应用连接失败，优先核对该应用的代理设置和环境，而不是立即更换软件包。
从安装到连接
安装成功只完成了第一步。按顺序确认配置输入、流量入口与访问结果，便于把问题定位到具体设置。
客户端安装包不附带服务器。需要准备有权使用的订阅地址、分享链接或配置文件，再选择相应导入方式。订阅地址通常用于获取一组可更新的配置，单条分享链接一般用于导入某个服务器；不要把两者不加区分地粘贴到同一个字段。
导入后先检查服务器名称、协议、地址和端口是否完整。订阅更新成功，只能说明订阅内容已获取，不等于其中每个服务器当前都能连接。如果导入后列表为空，先检查输入内容和订阅响应，再考虑网络设置。
v2rayN 的系统代理负责让遵循该设置的应用使用本地代理入口；路由规则决定请求进入内核后选择哪个出站。两层设置需要分开理解。“绕过大陆”属于路由策略，不是系统代理开关，也不表示所有应用都会自动接入客户端。
安卓客户端通过 VPN 服务接收流量，分应用代理还会改变参与接管的应用范围。先使用清楚、可解释的基本配置，确认连接后再调整分流或分应用规则。一次只改一类设置，并记录改动，便于恢复和复现。
版本与配置
客户端程序、内核能力与个人配置是不同层次。更新程序后仍应确认自定义设置是否保留。
升级前优先使用当前客户端提供的导出或备份功能。除了服务器列表，还要保留订阅分组、自定义路由、DNS、本地端口以及分应用选择。仅保存订阅地址，通常不足以恢复所有手动调整；订阅重新拉取后，也可能覆盖订阅所属的部分配置。
备份文件可能包含认证信息，应放在受控目录中，不要附到公开问题反馈里。若准备换用另一款客户端，先确认对方支持的导入格式。分享链接、订阅内容、客户端数据库与内核 JSON 各有用途，不能因为都描述连接设置就直接互换。
更新时先停止连接并退出旧实例，再处理程序文件。更新完成后检查服务器选择、系统代理状态、本地监听端口以及路由预设。安卓设备还应确认 VPN 授权和后台活动设置。只有配置与实际访问结果都符合预期，才算完成升级后的复查。
卡片中的版本信息与具体安装文件名应分别阅读。下载入口可能随清单更新，安装时以实际软件包及安装界面显示的信息为准。不要仅凭文件名长短判断是否为通用包，也不要把版本号更高理解为所有协议配置都能直接兼容。
下载常见问题
从系统架构、客户端差异到配置保留，先处理下载阶段最常见的疑问。
首次安装可先选 v2rayN 桌面版，它使用新一代跨平台 UI。经典 WPF 版是经典稳定版，适合熟悉原有 Windows 界面的用户。两版入口均为 x64 安装归档，下载后先解压，再运行其中的安装程序；切换界面版本前先备份配置。
Windows 在设置的系统、系统信息中查看系统类型；macOS 在关于本机中查看芯片或处理器；Android 可在设备说明或系统信息中确认架构，2015 年后的主流手机通常选择 arm64；Linux 可查看发行版的系统详情。不要只按设备外观或品牌判断。
安卓优先选择使用 Xray 内核的 v2rayNG。v2flyNG 使用 V2Fly 内核，作为需要对应内核生态时的备选。两者都提供 arm64 与通用版，协议及传输支持取决于所用客户端与内核版本，不能把一个客户端支持的字段直接套到另一个客户端。
安装包提供客户端程序，不附带可用的服务器配置。需要准备有权使用的订阅地址、分享链接或配置文件，完成导入并选择服务器，再设置系统代理或确认安卓 VPN 授权。订阅地址和分享链接可能包含访问凭据，不要公开发送。
先使用当前客户端提供的导出或备份功能，保存服务器配置、订阅分组、自定义路由及 DNS 设置，并记录本地端口和代理模式。备份包含敏感内容，应保存在受控位置。升级后逐项确认配置，不能仅凭订阅列表仍存在就判断迁移完成。
deb 与 rpm 是面向不同发行版包管理体系的格式；Debian、Ubuntu 一类通常选择 deb，Fedora、RHEL 一类通常选择 rpm。x64 与 arm64 则对应处理器架构。格式和架构都要匹配，具体能否安装还取决于发行版版本、运行库与软件包依赖。