桌面端选 v2rayN，安卓优先选 v2rayNG。先确认系统与处理器架构，再下载对应安装包。
本页提供 x64 安装包。先在“设置 → 系统 → 系统信息”查看系统类型。
桌面版 Desktop 使用新一代跨平台 UI；经典 WPF 版保留 Windows 经典界面，是延续既有操作习惯的稳定选择。首次安装可从桌面版开始，已经熟悉 WPF 的用户也可继续选择经典版。
将压缩包解压到可写目录，保留解压后的文件结构，不要直接在压缩软件的预览窗口中运行程序。安装过程中若提示缺少运行环境，按安装器说明处理，具体依赖以当前安装包要求为准。普通系统代理通常不需要管理员权限；准备启用 TUN 时，再按客户端提示处理所需权限。
首次打开后先导入订阅并更新服务器列表，选中一个有效配置，再设置路由与系统代理。暂时不要叠加 TUN、自定义 DNS 等设置。先验证基础连接，能更清楚地区分安装问题与配置问题。
| 检查项 | 本页安装包要求 | 确认方法 |
|---|---|---|
| 处理器架构 | 64 位 x64 环境 | 在系统信息中查看“系统类型”，不要只根据电脑品牌判断。 |
| 系统与运行环境 | 使用仍受支持的 Windows；具体最低版本与依赖以安装器为准。 | 先完成系统更新，遇到依赖提示时记录完整提示内容。 |
| 文件与权限 | 可写安装目录；TUN 可能需要额外权限。 | 完整解压，首次测试先使用普通系统代理。 |
安装成功不等于服务器已经可用。订阅地址失效、配置过期或路由选错，都需要在配置阶段分别排查。继续阅读 v2rayN 安装与订阅导入教程。
在苹果菜单的“关于本机”查看芯片信息，再选择 Apple Silicon 或 Intel。
macOS 使用 v2rayN 跨平台桌面界面。两种 DMG 对应不同处理器，不需要同时安装；芯片名称为 Apple M 系列时选 arm64，显示 Intel 处理器时选 x64。
打开 DMG 后，将应用拖入“应用程序”文件夹，再从该文件夹启动。不要长期直接运行磁盘映像中的应用，否则后续更新、路径记录与权限管理容易混淆。若系统提示无法验证开发者，先确认应用来源与下载过程，再到“系统设置 → 隐私与安全性”查看本次拦截对应的处理入口。
不建议为了一次启动而关闭整套系统安全机制。若应用报告文件损坏、架构不符或系统版本过旧，先区分具体提示，不要把所有启动失败都当成权限问题。网络权限与 TUN 相关授权是否出现，以系统和客户端实际请求为准，只处理当前功能需要的授权。
| 检查项 | 选择依据 | 安装提醒 |
|---|---|---|
| Apple Silicon | “关于本机”显示 Apple M 系列芯片。 | 下载 arm64 DMG，移动到应用程序后启动。 |
| Intel | “关于本机”显示 Intel 处理器。 | 下载 x64 DMG，避免混用其他架构。 |
| 系统与权限 | 具体最低系统版本以应用启动提示与发布要求为准。 | 检查隐私与安全性中的拦截记录，按需授予网络权限。 |
从其他桌面系统迁移时，先导出订阅与路由设置，再检查本机路径、监听端口和代理方式，不要直接照搬系统专属路径。遇到启动拦截可阅读 macOS 权限放行与网络授权步骤。
优先选择 v2rayNG；需要 v2fly 内核生态时，再考虑 v2flyNG。
v2rayNG 使用 Xray 内核，通过 Android 的 VpnService 接管设备流量。需要导入 VLESS、REALITY 等配置时，应同时确认当前客户端与配置字段的兼容性，不能只看协议名称判断能否使用。
版本文字与各平台文件路径分别来自下载清单，可能暂时存在差异；安装后在客户端“关于”页面确认实际版本，不要手动改写文件地址。
v2flyNG 面向 v2fly 内核生态。已有配置明确依赖这套内核时可将它作为备选；不要把不同内核的功能列表视为完全相同，导入前应确认传输方式与扩展参数。
| 检查项 | 要求或选择依据 | 处理方式 |
|---|---|---|
| 应用架构 | arm64 需要设备系统支持对应应用架构。 | 无法确认时选通用版；不能只凭处理器型号判断。 |
| 系统兼容性 | 最低系统版本以 APK 安装提示和当前应用要求为准。 | 安装提示不兼容时，同时检查系统版本与架构。 |
| 安装来源 | 浏览器或文件管理器可能需要单独的安装授权。 | 仅向本次使用的应用授权，完成后可关闭该权限。 |
| 连接权限 | 首次启动连接时需要确认系统 VPN 请求。 | 避免与其他占用 VPN 通道的应用同时运行。 |
下载完成后，从系统下载列表打开 APK。若提示与已安装应用签名冲突，先停止安装并备份旧配置，不要为了覆盖安装立即清除数据。安装成功后导入订阅，选中配置，再确认系统弹出的 VPN 连接请求。
首次测试先保持分应用规则简单。如果锁屏后频繁断连，再检查电池优化、后台运行与自启动权限，而不是反复重装。具体操作见 v2rayNG 分应用代理与省电白名单设置。
先区分发行版的包格式，再区分 x64 与 arm64。这里提供图形客户端安装包。
Linux 使用 v2rayN 跨平台桌面界面。Debian、Ubuntu 等发行版通常选择 deb；Fedora、RHEL 系发行版通常使用 rpm。相同扩展名并不代表所有发行版都满足依赖，安装前仍需检查发行版版本与包管理器提示。
下载后使用发行版自带的软件安装器打开安装包，留意架构与依赖检查。若图形安装器提示依赖不满足，先确认当前发行版是否适合该包，不要通过强制忽略依赖来继续安装。发行版名称相近，也可能使用不同的系统库版本。
在系统“关于”或硬件信息中查看处理器架构：x86_64 通常对应本页 x64 包，aarch64 通常对应 arm64 包。amd64 是 x64 架构的常见包标记，并不限定处理器品牌。装错架构时，应重新选择安装包，而不是修改文件名。
| 检查项 | 要求或选择依据 | 安装提醒 |
|---|---|---|
| 桌面环境 | 可运行图形应用的 Linux 桌面会话。 | 本页不是面向纯命令行服务器的部署入口。 |
| 包格式 | 按发行版选择 deb 或 rpm。 | 包管理器仍需确认系统库与其他依赖。 |
| 处理器架构 | x86_64 选 x64；aarch64 选 arm64。 | 确认系统实际架构，避免混用安装包。 |
| 代理与权限 | 系统代理支持情况与桌面环境有关。 | 先测试应用代理，TUN 权限按需配置。 |
部分应用不会自动读取桌面系统代理，因此“客户端能启动”和“所有应用都使用代理”不是同一件事。先确认本地监听与普通代理可用，再参考 进阶配置手册 处理路由、DNS 与 TUN。
安装包只负责客户端程序。订阅、路由与系统代理需要分别配置，按顺序操作更容易定位问题。
配置来源
从有权使用的服务或自建环境获取订阅链接，导入后执行更新。链接包含访问凭据，不要公开粘贴到截图、评论或求助记录中。服务器列表为空时，先检查链接是否有效，再检查订阅请求能否完成。
查看订阅导入教程 →最小设置
选定服务器后，先启用常用路由预设与普通系统代理，保持其他设置接近默认值。Android 先确认 VPN 请求。不要一开始同时修改 DNS、路由与 TUN，否则失败时难以判断是哪一项引起的。
阅读路由与 TUN 配置 →结果确认
能安装但不能连接，通常需要检查订阅参数、服务器状态或代理设置，而不是重新下载。只有安装器打不开、架构不兼容或缺少依赖时，才优先返回安装环节。记录完整报错，比反复切换安装包更有效。
进入常见问题 →更新前先记录当前客户端、安装方式与配置位置。导出订阅分组、自定义路由和必要设置，再退出正在运行的程序。备份中可能包含服务器地址与认证信息，应放在个人可控的位置，迁移完成后及时处理多余副本。
使用系统安装器或包管理器更新时，先阅读现有安装提示。若准备从桌面版切换到 WPF，或从 v2rayNG 切换到 v2flyNG，应将它视为一次配置迁移：确认新客户端能导入所需字段，逐项核对路由和 DNS，不要假定每个开关都能一一对应。
更新结束后，先打开客户端的“关于”页面确认实际版本，再测试订阅更新与常用连接。卡片上的版本文字来自下载清单，安装包名称由具体平台文件决定；文字与文件名暂时不同，不应通过改写地址来拼出另一个下载包。
如果应用退出后浏览器无法正常访问网络，先检查系统代理是否仍指向已关闭的本地端口。恢复系统代理后再启动客户端，确认端口未被其他程序占用。卸载之前也应先停用代理与相关连接模式，避免将设置残留误判为网络故障。
客户端负责读取配置并建立连接，安装包不包含可用的服务器配置。需要自行准备有权使用的订阅链接或单个服务器参数。安装完成后导入配置，再选择服务器与路由模式；本页的下载入口不提供订阅服务。
首次安装可先选桌面版 Desktop，它使用新一代跨平台界面。已熟悉 Windows 经典界面或需要延续现有操作习惯，可选经典稳定的 WPF 版。两者都是 v2rayN，安装与迁移前先备份配置，不要让两个实例同时接管系统代理。
2015 年后的主流手机通常优先选择 arm64，但仍应以设备支持的应用架构为准。无法确认架构，或设备只能运行其他架构的应用时，选择通用版。若安装提示不兼容，还要检查系统版本；通用版不能解决所有系统兼容问题。
卡片版本号展示下载清单的 latest 字段，按钮则使用对应平台的实际文件路径，两者可能不同步。确认安装结果时，以客户端关于页面显示的版本为准。不要手动修改下载地址中的版本数字；需要更新时重新使用本页对应入口。
先退出旧客户端并备份配置，再按照安装器提示更新；是否需要卸载取决于安装方式与包管理器要求。遇到签名冲突、包冲突或准备更换客户端时，不要直接删除应用数据。先确认备份可恢复，再处理旧安装，并在更新后检查订阅、路由和系统代理。