客户端安装包 / 系统与架构选择
先选系统，再选安装包。桌面端使用 v2rayN，Android 首推 v2rayNG，v2flyNG 作为备选。
已有配置？更新前先备份。首次安装？下载后继续阅读快速上手教程 →
以下两个入口均为 x64 安装包压缩文件。新安装可先选桌面版，已有 WPF 使用习惯可继续选择经典版。
新一代跨平台 UI。适合首次使用，或希望在不同桌面系统间保持相近操作方式的用户。
下载桌面版 · x64 ZIP 压缩包 · 下载后先解压经典稳定版，保留熟悉的 Windows 桌面操作布局。适合沿用既有操作习惯与配置流程。
下载 WPF 版 · x64 ZIP 压缩包 · 使用独立目录两个版本的界面布局、运行环境与部分功能入口可能不同。已有配置时先备份，再按所选版本的导入方式迁移；不要将两套程序文件混放，也不要为了切换界面直接覆盖原目录。
| 检查项目 | 选择与操作 |
|---|---|
| 系统与架构 | 面向 Windows x64。进入“设置 → 系统 → 系统信息”查看系统类型，系统支持范围以当前包说明为准。 |
| 运行环境 | 不同版本可能需要对应的 .NET 桌面运行环境；如启动提示缺少组件，按提示确认所需架构与类型。 |
| 目录与权限 | 先将 ZIP 完整解压到可写目录，再打开程序。避免直接在压缩软件中运行，也避免放入受限系统目录。 |
| 首次配置 | 准备有效订阅或配置，确认本地端口未被占用；普通系统代理可用后，再考虑启用 TUN。 |
首次打开时先观察程序是否正常显示主窗口，不要急着修改路由、端口和内核。如果提示无法写入配置，先检查解压目录权限及安全软件拦截记录；只有明确需要提权的功能才使用相应权限，不必把所有启动问题都归因于权限不足。
退出旧客户端后再启动新程序，可减少端口冲突与系统代理被反复改写的情况。需要完整的操作顺序，可阅读Windows 安装配置全流程，按解压、启动、导入、启用系统代理的顺序完成设置。
先从“关于本机”确认芯片。显示 Apple M 系列选 Apple Silicon，显示 Intel 处理器选 Intel。
适用于 Apple M 系列芯片。优先选择与处理器匹配的 arm64 包，避免把转译运行当成默认安装方式。
下载 Apple Silicon 版 DMG 磁盘映像 · arm64适用于配备 Intel 处理器的 Mac。不要只凭购买年份判断，优先查看系统中列出的处理器信息。
下载 Intel 版 DMG 磁盘映像 · x64打开磁盘映像后，按安装界面提示将应用放入“应用程序”，再从该目录启动。更新已有应用前先退出正在运行的实例，保留原配置备份；不要长期从挂载的磁盘映像中运行。
| 检查项目 | 选择与操作 |
|---|---|
| 芯片架构 | Apple M 系列使用 arm64；Intel 使用 x64。通过系统菜单中的“关于本机”核对。 |
| 系统兼容性 | 确认当前系统满足安装包要求；旧系统遇到启动失败时，先查看具体兼容性提示。 |
| 应用位置 | 安装到“应用程序”并从该位置启动，更新时先退出旧进程，再替换应用。 |
| 网络权限 | 按需批准网络相关操作；涉及系统代理或 TUN 的权限请求，应确认来源与用途后再授权。 |
遇到安全提示时，先读取提示的具体原因，并到系统设置的“隐私与安全性”查看相关记录。系统版本不兼容、文件未下载完成和架构选错是不同问题，不应一律通过关闭防护或执行来源不明的命令处理。
导入订阅后先使用普通系统代理测试浏览器。若浏览器可用而其他应用仍无法连接，先确认该应用是否遵循系统代理，再决定是否需要 TUN。切换模式之前保留一套已验证可用的设置，方便出现问题时恢复。
先选 v2rayNG。需要使用 V2Fly 内核或验证特定配置兼容性时，再考虑 v2flyNG。
2015 年后的主流手机通常优先选此包，最终以设备支持的应用架构为准。适合大多数现代 Android 设备。
下载 v2rayNG · arm64 APK 安装包 · arm64-v8a无法确认架构时可选。包含更多架构支持，安装包通常较大；与 arm64 版的区别不在于功能数量。
下载 v2rayNG · 通用版 APK 安装包 · universalv2rayNG 使用 Xray 内核。导入配置后，先保持默认网络设置并选择一个有效配置，再启动连接、确认系统 VPN 授权。是否支持某种协议或传输组合，还要结合当前客户端、内核与服务器参数判断。
适用于支持 arm64 应用的设备。需要 V2Fly 内核时选择此客户端，不必仅为排查网络问题同时更换全部设置。
下载 v2flyNG · arm64 APK 安装包 · arm64-v8a用于架构不明确或需要其他架构兼容的设备。安装前确认系统版本符合要求，并留出足够的存储空间。
下载 v2flyNG · 通用版 APK 安装包 · universalv2flyNG 与 v2rayNG 是不同应用，配置和权限需分别确认。不要假设从另一客户端复制的高级设置可以直接照用；尤其在更换内核后，应重新核对协议、传输方式与域名策略。
| 检查项目 | 选择与操作 |
|---|---|
| 设备架构 | 主流设备通常选 arm64；仍需以系统支持的应用架构为准，不确定时尝试通用版。 |
| 系统版本 | 以所选 APK 的安装要求为准；提示解析失败时，同时检查系统兼容性与下载是否完整完成。 |
| 安装权限 | 按系统提示为实际打开 APK 的浏览器或文件管理器授予安装权限，用完可收回。 |
| 连接权限 | VPN 模式首次启动需要系统授权。同一时刻只启用一个使用系统 VPN 通道的应用。 |
提示“应用未安装”不一定是架构错误，也可能与已有应用的签名、安装来源或版本关系有关。先备份配置并确认旧应用信息，不要直接卸载后才发现订阅和自定义规则没有保存。安装界面给出的版本信息与实际下载文件应一并查看，页面版本文字仅供参考。
连接后后台中断时，查看电池优化、后台运行与网络权限。分应用代理会改变哪些应用进入代理通道，测试阶段先确认默认范围可以工作，再逐步加入排除规则。手机已运行其他 VPN 应用时，先停止它，避免授权后又被另一应用替换。
先按发行版选择 deb 或 rpm，再核对 x64 与 arm64。文件格式与处理器架构需要同时匹配。
适用于使用 deb 包管理体系的发行版，例如 Debian、Ubuntu。仍需确认当前发行版能满足依赖要求。
下载 deb · x64 使用 ARM 设备？下载 deb · arm64 →适用于使用 rpm 包管理体系的发行版。包格式相同不代表所有系统版本都满足运行环境要求。
下载 rpm · x64 使用 ARM 设备？下载 rpm · arm64 →优先通过发行版的软件安装器或包管理器处理依赖。不要将 deb 与 rpm 混用，也不要通过重命名扩展名尝试安装。x64 常见架构标识为 amd64 或 x86_64；arm64 常见标识为 aarch64。
| 检查项目 | 选择与操作 |
|---|---|
| 发行版包格式 | 确认系统使用 deb 还是 rpm，再检查当前发行版版本是否满足软件包依赖。 |
| 处理器架构 | 在系统信息中查看架构；x86_64 选 x64，aarch64 选 arm64，不按设备外观判断。 |
| 图形桌面 | 本页提供图形客户端，需可用的桌面会话及相应图形依赖，不作为服务器后台服务安装指南。 |
| 代理与权限 | 系统代理是否被应用采用取决于桌面环境和应用本身；TUN 另需相关网络权限。 |
安装器提示缺少依赖时，先查看具体的软件包名称和版本约束。不要强行忽略依赖完成安装，否则程序可能在启动阶段失败。不同发行版的系统库版本差异较大，单看安装文件后缀无法判断兼容性。
程序打开后先导入订阅并测试普通代理连接。部分应用不读取桌面环境的系统代理，浏览器可用不代表所有终端程序已被接管。应先明确应用使用哪一种代理入口，再检查监听地址、端口与路由，不要直接将监听范围扩大到整个局域网。
安装程序只完成第一步。先导入配置，再验证连接，最后调整分流与高级模式。
已有客户端时，先停止当前连接，记录系统代理状态与本地监听端口，再使用客户端提供的备份或导出功能保存必要配置。订阅链接可能包含访问凭据，应放在受控位置，分享报错截图前遮挡相关内容。跨客户端迁移时优先重新导入原始订阅，不要直接复制不明用途的数据库或缓存文件。
同一客户端的常规更新与更换客户端是两种操作。前者通常沿用原配置，后者可能涉及不同的字段、路由与内核能力。更新后先确认原有分组、规则和配置能够读取，再测试连接；不要在尚未验证之前删除旧备份。
客户端安装包不附带订阅服务。准备有权使用的订阅链接后，打开订阅分组设置，新建分组并粘贴完整地址，保存后执行更新。列表为空时先检查更新日志，确认返回内容能够被当前客户端识别，而不是连续重复导入同一个链接。
更新成功后选择需要使用的配置，再启动连接。节点测试只用于辅助判断可达性，不替代实际应用验证。某个配置无法连接时，可以换一个已知可用的配置进行对比，但不要同时修改 DNS、路由、端口与传输参数，否则很难判断是哪一步解决或引入了问题。
桌面端先确认系统代理已启用，并与客户端的本地监听端口一致；Android 先确认 VPN 授权已经完成。用浏览器访问一个原本能够稳定访问的页面，再测试目标应用。遇到异常时先看客户端日志，区分本机网络故障、订阅错误与连接参数错误。
TUN、分应用代理和自定义路由都应在基本连接正常后逐项启用。每次只改一项，并保留可恢复的配置。关闭客户端后若网络异常，优先检查系统中是否仍保留指向已停止程序的代理地址，再决定是否需要进一步排查。
按安装包选择、配置迁移与首次连接归类。
首次使用可先选桌面版，它使用新一代跨平台界面；习惯经典 Windows 布局的用户可选 WPF 版。两版配置入口和运行环境可能不同，切换前先备份配置，分别使用独立目录，不要把两版文件覆盖到一起。
2015 年后的主流手机通常优先选 arm64，但仍应以设备实际支持的应用架构为准。无法确认架构或 arm64 包无法安装时，可尝试通用版。通用版覆盖更多架构，文件通常更大，不代表功能更多。
客户端是读取配置并建立连接的工具，安装包不等于订阅服务。需要自行准备有权使用的订阅链接或服务器配置，再在订阅分组中导入、更新并选择配置。不要向他人公开包含访问凭据的订阅链接。
通常不需要先删除配置。更新前停止连接、退出客户端并备份配置；保持应用、架构和安装方式一致。跨桌面版本或更换内核时，先阅读对应说明，确认配置能正常读取后再清理旧文件。
先核对系统、处理器架构和文件格式，并确认下载已完成。Windows 的 ZIP 文件应先完整解压；macOS 应区分 Apple Silicon 与 Intel；Linux 要匹配发行版包格式。安全提示应先查看具体原因，不要直接关闭系统整体防护。
先关闭代理确认基础网络可用，再检查订阅是否成功更新、是否已选择配置以及客户端是否启动。桌面端核对系统代理和本地监听端口；Android 核对 VPN 授权。仍有问题时按问题诊断页逐项排查，不要同时修改多组设置。