客户端安装包 / 系统与架构
桌面选 v2rayN，安卓先看 v2rayNG。
先确认操作系统，再选择处理器架构与安装格式。
下方按钮直接进入对应安装包。免费图形客户端负责配置与连接管理；安装完成后，还需导入有权使用的订阅或节点信息。系统要求表用于选包判断，具体运行条件随客户端发行版本变化。
新一代跨平台 UI。首次安装可先选这一版，桌面各系统的界面与操作思路更一致。
经典稳定版，使用 Windows WPF 界面。习惯原有菜单布局、需要延续旧版操作流程时可选。
两个入口均为 v2rayN，不是两种代理协议。选择界面版本时先考虑使用习惯，再核对所需功能；系统代理、路由分流和订阅管理的具体入口可能随界面更新调整。已有配置不要直接放进另一版程序目录覆盖，先使用导出或备份功能保存，再检查新版是否能正确读取。
在“设置 → 系统 → 关于”中查看系统类型，确认属于 x64 环境。本页两个 Windows 包都是 x64，不应仅凭电脑品牌判断兼容性。系统位数、处理器架构与应用运行环境是不同条件；较旧系统能运行某个历史版本，并不代表当前发行包也能运行。安装提示缺少运行组件时，应按该发行包的实际提示处理。
下载文件是 ZIP 压缩包。先解压到本地目录，再查看其中的安装程序与说明，不要直接在压缩软件的预览窗口里运行。升级前退出托盘中的旧客户端；如果旧实例仍在后台占用文件，安装过程可能无法完成。保存原配置后再安装，能减少误把空配置当作升级结果的情况。
启动后先导入订阅、更新列表并选中节点，再决定启用系统代理还是 TUN 模式。普通启动不等于所有程序都会经过客户端；系统代理主要影响遵循系统代理设置的应用，TUN 则涉及虚拟网络接口与额外权限。首次测试先用一种接管方式，确认连接正常后再调整路由与 DNS，避免同时改变多项设置而难以定位问题。
| 检查项 | 本页安装包 | 安装前确认 |
|---|---|---|
| 处理器与系统 | x64 | 在系统类型中确认 64 位运行环境 |
| 文件形式 | ZIP，内含安装程序 | 下载完成后解压，按包内说明安装 |
| 系统与运行组件 | 取决于发行版本 | 按安装程序提示确认兼容性与依赖 |
| 代理接管权限 | 系统代理 / TUN | TUN 按提示授权，避免多个客户端同时接管 |
适用于 Apple Silicon 芯片。关于本机显示 Apple M 系列芯片时，选择此入口。
适用于 Intel 处理器。关于本机的处理器信息包含 Intel 时，选择此入口。
两种 DMG 的用途相同，区别是程序面向的处理器架构。不要按屏幕尺寸、购买年份或外观选择，也无需为了“通用”而优先运行另一架构的包。原生架构更直接；如果安装后出现无法打开或不兼容提示，应先回到芯片信息与系统版本检查，而不是反复切换订阅。
打开系统菜单中的“关于本机”，查看“芯片”或“处理器”一栏。显示 Apple Silicon 的机器选 arm64，显示 Intel 的机器选 x64。这一步决定程序能否在本机运行，与订阅中使用 VMess、VLESS 或 Trojan 无关。客户端的系统版本要求随发行更新，本页不把一个固定版本号当作所有后续包的兼容承诺。
打开下载完成的 DMG，按磁盘映像内的提示把应用放入应用程序目录，再从该目录启动。安装完成后可以推出磁盘映像，避免以后误从映像中启动旧副本。若系统显示安全提示，应在系统设置中核对具体原因与应用来源，再依照系统提供的流程处理；不要为打开一个应用而整体关闭系统安全机制。
首次设置系统代理或 TUN 时，可能出现相关权限请求。先确认请求来自正在配置的客户端，再按用途授权。如果电脑中已有其他代理程序，先暂停其接管功能。出现浏览器可以访问而其他程序不能访问的情况，通常需要检查应用是否遵循系统代理，并不是换一种芯片包就能解决。
从 Windows 迁移时，可以复用兼容的订阅与节点信息，但本地路径、开机启动项及网络接口设置不应照搬。先恢复节点列表，再检查路由和 DNS；对桌面系统特有的设置逐项重新确认。完成连接测试后再启用自动启动，能避免把尚未验证的配置带入每次登录流程。
| 检查项 | 对应选择 | 确认方式 |
|---|---|---|
| Apple Silicon | arm64 DMG | 关于本机显示 Apple M 系列芯片 |
| Intel | x64 DMG | 关于本机显示 Intel 处理器 |
| 系统兼容性 | 按发行版本确认 | 核对系统版本与应用启动提示 |
| 安装与授权 | 应用程序目录 | 按系统提示确认首次启动与网络权限 |
2015 年后的主流手机通常可先选 arm64。仍需确认系统具备对应的应用运行环境。
包含多种架构支持。无法确认手机架构，或 arm64 包提示不兼容时，可尝试此包。
v2rayNG 是 Android 上管理节点、订阅与路由设置的图形客户端，使用 Xray 内核。若连接配置涉及 VLESS、REALITY 等功能，除了安装客户端，还要确认当前版本支持服务端提供的具体组合。客户端名称、代理协议与传输安全层是不同概念，不要把“安装了 Xray 客户端”理解为所有配置都会自动兼容。
用于需要 V2Fly 内核的配置与使用场景。架构选择方式与上方客户端相同。
架构不确定时的备选入口。通用包不代表能运行另一内核专属的协议功能。
v2flyNG 使用 V2Fly 内核，适合明确需要这一内核生态的用户。它与 v2rayNG 的界面操作可能相近，但不能据此认为全部配置字段相同。迁移前先核对协议、传输方式和安全设置；尤其不要把针对 Xray 特定功能的配置直接导入后，就把失败归因于安装包架构。
下载 APK 后，系统可能要求允许浏览器或文件管理器安装应用。只为当前使用的来源开启权限，完成安装后可按需要收回。若安装器显示解析失败，先确认下载已经完成，再检查系统版本与文件是否适用于本机；“存储不足”“与现有应用冲突”和“架构不支持”是不同问题，应按提示分别处理。
同一客户端从不同发布渠道取得的包，可能采用不同签名。出现签名冲突时，不要直接卸载旧应用：先导出订阅分组、手动节点和个人设置，并确认备份可以找到。卸载通常会移除应用数据，仅记住订阅地址并不足以恢复自定义路由、分应用列表等内容。
首次启动连接时，Android 会显示 VPN 授权。这里的 VpnService 是系统提供的流量接管接口，不表示客户端会自动生成服务器信息。确认授权后，还要有有效节点与正确配置。系统通常只允许一个 VPN 服务处于活动状态；如果另一应用已经占用该接口，需先停止它，再测试当前客户端。
锁屏后断连时，先查看电池优化、后台活动与自启动限制。可以把正在使用的客户端纳入适当的后台允许范围，但不需要对所有应用取消省电策略。分应用代理也应单独核对：白名单通常表示只接管选中应用，黑名单通常表示排除选中应用，具体以界面说明为准。列表方向选错，会造成某些应用始终不走预期出站。
| 检查项 | 建议选择 | 注意事项 |
|---|---|---|
| 主流较新手机 | 先看 arm64 | 芯片与系统都需支持对应运行环境 |
| 架构不确定 | 通用版 | 仍受系统版本与应用兼容性限制 |
| 内核需求 | v2rayNG / v2flyNG | 分别核对 Xray 与 V2Fly 的功能范围 |
| 运行权限 | VPN 授权、后台活动 | 安装授权与连接授权是两个不同步骤 |
适用于使用 deb 包管理方式的桌面发行版，例如 Debian、Ubuntu 系列。
适用于使用 rpm 包管理方式的桌面发行版。需同时确认发行版版本与依赖兼容性。
Linux 选包要同时满足“包格式正确”和“架构正确”。文件名中的 amd64、x86_64 通常对应 x64，arm64、aarch64 对应 ARM64。deb 与 rpm 不是界面版本差异，也不能只修改文件扩展名互换使用。这里的 v2rayN 面向桌面环境，服务器或路由设备的部署思路请看协议详解与相关技术文章。
先在系统信息中确认发行版与处理器架构，再查看系统使用的软件安装器或包管理工具。Debian、Ubuntu 系列通常选择 deb；采用 rpm 管理的发行版选择 rpm，但同为 rpm 格式也不保证跨发行版兼容。本页 rpm 文件名带有发行目标信息，安装前应特别关注系统库与包依赖要求，不要把包格式一致当成兼容性已经确认。
可以通过发行版提供的图形软件安装器打开下载的包，并查看依赖、安装位置与错误提示。若提示缺少依赖，应先确认该包是否适用于当前系统版本，而不是强制忽略所有依赖。安装成功后从应用菜单启动 v2rayN；只完成包安装，还不能判断系统代理与 TUN 是否已经工作。
不同桌面环境对系统代理设置的读取方式可能不同，有些应用只读取自己的代理配置。遇到部分程序能连接、部分程序不能连接时，先区分“客户端连接失败”和“应用没有被接管”。TUN 涉及网络接口、路由与权限，应遵循客户端提示操作；不建议为了省一步授权而长期以高权限运行整个图形客户端。
升级时先保存当前配置并退出旧进程，再由同一种包管理方式安装新包。混用多个安装来源容易造成应用菜单仍指向旧副本，或不同配置目录被误认成同一份数据。完成升级后，先查看实际启动的应用信息，测试一个节点，再恢复开机启动与其他自动化设置。
| 检查项 | 对应入口 | 安装前确认 |
|---|---|---|
| x64 桌面 | amd64 deb / x86_64 rpm | 确认包格式与发行版依赖 |
| ARM64 桌面 | arm64 deb / aarch64 rpm | 确认运行的是 64 位 ARM 系统 |
| 图形环境 | 桌面会话 | 具备应用运行所需的图形组件 |
| 代理与 TUN | 按客户端设置启用 | 核对应用接管方式及网络权限 |
安装阶段关注系统兼容性、架构、依赖和权限。如果应用无法启动，先处理这些基础条件；反复更换节点并不能解决程序运行问题。客户端能打开后，再检查订阅导入、节点选择与网络接管，分阶段测试更容易找到原因。
订阅地址与节点信息可能包含个人凭据，不要公开粘贴到截图或问答中。导入后核对协议、传输方式及安全设置，避免仅凭节点名称判断兼容性。出现连接错误时，记录经过脱敏的错误提示，并查看常见问题中的对应说明。