客户端安装包 / 平台与架构
桌面端选择 v2rayN，Android 优先选择 v2rayNG。先选操作系统，再确认芯片架构；安装完成后还需导入有效订阅或服务器配置。
选择操作系统
包名中的架构比文件体积更值得先确认。
Windows 桌面客户端 · x64
两版先选一个即可，不必同时安装。Desktop 使用新一代跨平台界面，适合希望在不同桌面系统间保持操作习惯的用户；WPF 是 Windows 上的经典界面分支，适合已经熟悉原有菜单和配置流程的用户。两版提供的配置入口、界面布局与运行环境要求可能不同，不能只凭压缩包大小判断哪版更合适。
下载后先把整个压缩包解压到有写入权限的固定目录，再从解压后的目录启动程序。不要在压缩软件的预览窗口内直接运行，也不要只拖出一个可执行文件。若系统提示缺少运行环境，应按提示核对组件名称、位数和对应版本，补齐后再启动；反复下载相同压缩包通常不能解决运行环境缺失。
准备从 WPF 切换到 Desktop 时，先在旧客户端导出配置，并单独保存自定义路由。新程序放进另一个目录，完成导入与连接测试后再处理旧目录。迁移时重点检查本地监听端口、订阅分组和路由模式，不要假定所有界面选项都能逐项对应。
| 检查项 | 选择与处理 |
|---|---|
| 系统与架构 | 本页提供 Windows x64 包；在“设置 → 系统 → 系统信息”确认系统类型。其他架构设备需先确认兼容运行条件。 |
| 运行环境 | 系统最低要求与所需运行库随发行版变化，以安装包随附说明及启动提示为准；Desktop 与 WPF 不应混用运行环境判断。 |
| 目录与权限 | 完整解压到可写目录。常规导入与系统代理通常不必长期以管理员身份运行；TUN 等功能另按权限提示处理。 |
启动后先导入订阅，选择一个服务器，再设置系统代理并用浏览器验证。能够打开主窗口只说明程序已启动，不代表所有应用都已使用代理。浏览器与终端的代理路径不同，命令行程序可能还需要独立设置环境变量。具体操作见快速上手教程。
macOS 桌面客户端 · DMG
先看芯片名称，再下载对应包。打开系统的“关于本机”，若显示 Apple M 系列芯片，选择 arm64；若显示 Intel 处理器，选择 x64。不要仅根据购买年份推断架构，同一年份可能存在不同芯片机型。选用原生架构可以减少额外的兼容环节，不能把两个 DMG 当作可随意互换的同一文件。
打开 DMG 后，按窗口内提示将应用移入“应用程序”，再从应用目录启动。避免长期直接从挂载的磁盘映像中运行，以免卸载映像后找不到程序。遇到系统安全提示时，先阅读提示内容，确认应用来源与文件类型，再通过系统提供的安全设置流程处理，不建议为一次安装全局关闭系统保护。
首次使用先验证常规系统代理，再按需要配置 TUN。两种接管方式涉及的权限和网络路径不同，浏览器连接正常后再增加接管范围，更容易定位问题。安装了其他网络代理或网络过滤工具时，先确认是否同时改写系统代理，避免退出一个程序后另一个程序留下旧的代理端口。
| 检查项 | 选择与处理 |
|---|---|
| 芯片架构 | Apple M 系列选 arm64，Intel 处理器选 x64；芯片信息以“关于本机”为准。 |
| 系统兼容性 | 最低系统要求以当前发行包说明为准。旧系统无法启动时，先核对系统兼容范围，而不是更换为另一芯片架构。 |
| 安装与权限 | 应用复制到“应用程序”后启动；涉及系统代理或网络接管时，按实际出现的系统权限提示操作。 |
从其他桌面系统迁移配置时，应优先使用客户端提供的导入与导出功能。配置中如果含有本地文件路径、外部规则位置或自定义脚本，需要重新确认对应文件是否存在。订阅能成功导入，不代表这些系统相关路径也已同步迁移。
Android 客户端 · Xray 内核
首次安装 Android 客户端可先选择 v2rayNG。它使用 Xray 内核，具体协议、传输方式及参数支持范围取决于所用客户端和内核版本。订阅包含 REALITY 或特定 flow 字段时，应先确认客户端能够识别对应参数；安装成功与配置兼容是两件事，不能只看订阅是否出现在列表里。
下载 APK 后，从浏览器下载记录或文件管理器打开。若系统要求允许当前来源安装应用，只为正在使用的浏览器或文件管理器授予相应权限，完成安装后可再收回。首次连接通常会出现系统 VPN 授权对话框，确认应用名称后授权；同一时间运行其他 VPN 类应用可能发生接管冲突。
Android 备选客户端 · v2fly 内核
v2flyNG 适合需要 v2fly 内核配置的用户，不能视为 v2rayNG 的完全等价替换。两者的界面操作有相近之处，但内核功能范围不同。迁移前先核对节点使用的协议、传输和安全参数；如果原配置依赖另一内核的特有功能，换客户端不会自动转换这些字段。
测试备选客户端时，先停止原客户端的连接，再在新客户端导入配置。这样可以区分节点本身的问题与 VPN 接管冲突。订阅链接应通过可信渠道传递，不要将完整链接、二维码或导出的连接参数发到公开讨论区。
| 检查项 | 选择与处理 |
|---|---|
| 处理器与系统 | 主流设备通常选 arm64；部分设备使用 32 位系统，即使芯片为 64 位也应确认应用架构支持。架构不明确时可尝试通用版。 |
| 安装条件 | 保留足够存储空间，按系统提示授予当前来源安装权限；最低 Android 版本以当前应用发行说明和安装器提示为准。 |
| 连接与后台 | 连接需系统 VPN 授权。锁屏后连接中断时，检查电池优化与后台限制，不要直接判断为节点失效。 |
覆盖升级提示无法安装时，先区分系统版本、架构和签名来源问题。不同签名的安装包不能直接覆盖同一应用，贸然卸载可能删除现有配置。应先在旧应用中导出必要数据，再决定迁移方式。安装器提示不兼容时，也不要反复改文件扩展名尝试安装。
Linux 图形客户端 · deb / rpm
Linux 需要同时确认包管理格式和处理器架构。Debian、Ubuntu 系通常使用 deb，Fedora、RHEL 系通常使用 rpm，但同一包格式不代表所有发行版版本都兼容。先在系统信息中确认发行版与架构，再用系统的软件安装器打开下载的文件，阅读依赖与兼容性提示后安装。
x64 也常写作 amd64 或 x86_64，arm64 也常写作 aarch64。它们分别属于不同的处理器架构，不能通过修改文件名互相转换。如果软件安装器提示依赖版本不足，应确认当前发行版是否满足安装包要求；不要为了装一个图形客户端而强制覆盖系统基础组件。
完成安装后，从桌面应用菜单启动 v2rayN。系统代理是否被应用遵循，取决于桌面环境与应用本身；浏览器、终端以及后台服务可能使用不同的代理来源。先用一个明确支持代理的应用完成测试，再排查其他程序。需要 TUN 时，还要额外确认权限、路由与已有网络管理工具之间的关系。
| 检查项 | 选择与处理 |
|---|---|
| 软件包体系 | 按发行版使用 deb 或 rpm；包管理器能识别文件，不等于依赖一定满足，仍需阅读安装提示。 |
| 设备架构 | 常见桌面电脑选 x64；arm64 设备选择对应的小字入口，不要混装不同架构。 |
| 桌面与权限 | 需要可用的图形桌面和相应运行依赖；常规使用与网络接管的权限要求分别处理。 |
迁移已有配置时，特别检查路径大小写和文件访问权限。其他系统中的目录路径不能原样作为 Linux 路径使用。修改路由或 DNS 后，应让客户端重新加载配置，再观察实际连接行为；仅保存文本文件不一定会让运行中的内核立即使用新设置。
下载与安装问答
还需要有效的服务器配置或订阅链接。客户端负责导入配置、启动内核和设置本机代理，不会自动提供服务器账号。导入后选择服务器，再按需要开启系统代理或 Android VPN 连接；首次使用建议先阅读快速上手。
首次安装可先选桌面版 Desktop，它使用新一代跨平台界面；已熟悉经典 Windows 界面的用户可选 WPF 版。两者界面和运行环境要求不同，不宜混用程序目录。切换前导出配置，在独立目录完成导入和连接测试。
2015 年后主流手机通常优先选 arm64，但仍应以设备实际支持的应用架构为准。系统较旧、架构不明确或提示安装包不兼容时，可选择通用版。通用版包含多个架构，包体通常更大，并不表示功能更多。
先在原客户端导出配置并保存自定义路由，再退出程序后升级。桌面端不要先删除原数据目录；Android 同一应用通常可覆盖安装，但签名来源不同可能导致安装失败。不要直接卸载重装，应先确认备份可用。
先查看浏览器下载记录，确认是否被询问保存位置、权限或剩余空间。中断时可重新点击对应安装包入口，必要时换用稳定网络。页面入口已包含文件地址，即使版本信息未刷新，也可以继续尝试下载。
无法启动时先检查包的系统和架构、是否完整解压以及运行环境提示；能够启动但无法连接时，再检查订阅有效性、本机时间、端口占用和内核日志。两类问题应分开排查，不要仅因连接失败就反复更换安装包。