v2rayN · v2rayNG · v2flyNG
桌面使用 v2rayN；Android 首选 v2rayNG，v2flyNG 作为备选。先选操作系统，再确认处理器架构与安装格式。
安装包只提供客户端程序；连接前需要准备有权使用的订阅地址或配置。已有安装记录时，建议先备份再更新。
两个界面版本，均为 x64 安装入口。第一次安装可从桌面版开始；习惯经典布局则选择 WPF 版。
采用 Avalonia 的新一代跨平台 UI。适合新安装，或希望在不同桌面系统之间保持相近操作习惯的用户。
面向 Windows 的经典稳定界面版本。适合熟悉原有菜单位置、偏好传统桌面布局的用户。
这里的“桌面版”和“WPF 版”区分界面框架，不是两套订阅服务，也不代表某一版必然连接更快。具体协议能否使用，还取决于实际运行的内核、连接参数与服务端配置。
查看客户端与版本差异 →| 检查项 | 要求与确认方法 |
|---|---|
| 系统与架构 | 本页提供 Windows x64 包。在“设置 → 系统 → 系统信息”检查系统类型；最低系统版本以所选发行包说明为准。 |
| 运行环境 | 桌面版与 WPF 版的依赖可能不同。出现运行库提示时按具体错误处理，不要把其他版本的依赖文件混入安装目录。 |
| 目录与权限 | 将压缩包完整解压到可写目录，再运行其中的安装程序。系统代理通常不需要持续提权，TUN 接管可能需要额外权限。 |
下载得到的是 ZIP 压缩包，不应直接在压缩软件的预览窗口中运行程序。先完整解压，再按照包内内容安装或启动，避免配置、日志和随附文件分散到临时目录。旧版仍在后台运行时先退出，防止监听端口被占用。
如果首次启动后界面正常但网页仍无法连接，先确认已导入配置并选中服务器，再检查系统代理。不要把安装完成与网络接管完成混为一谈。需要按顺序操作时，可参考使用指南，从导入订阅开始逐步确认。
在系统菜单的“关于本机”查看芯片或处理器名称，Apple Silicon 与 Intel 分别使用对应的 DMG。
“关于本机”显示 Apple M 系列芯片时选择此包。按芯片名称判断，不必根据机身型号或购买年份推测。
“关于本机”显示 Intel 处理器时选择此包。与 Apple Silicon 包使用相同客户端名称，但可执行文件架构不同。
打开 DMG 后，将应用复制到“应用程序”目录再启动。首次使用先完成普通配置导入和系统代理设置，确认基本连接正常后，再考虑 TUN 与自定义 DNS。
安装后的配置步骤 →| 检查项 | 要求与确认方法 |
|---|---|
| 芯片架构 | Apple M 系列对应 arm64；Intel 对应 x64。优先使用与芯片匹配的原生包。 |
| 系统适配 | 最低 macOS 版本以当前发行包要求为准。旧系统无法启动时，应先判断系统兼容性，而不是反复切换芯片包。 |
| 系统权限 | 网络接管与辅助组件可能要求授权。仅针对已确认来源的应用按系统提示处理，保持系统安全机制正常启用。 |
系统提示无法打开应用时，应先读完整提示：架构不匹配、系统版本过旧、应用安全确认与文件损坏属于不同问题。不要将所有提示都归为同一个原因，也不建议通过全局关闭系统安全检查来处理单个应用的启动问题。
更新前先退出正在运行的客户端，再替换应用。应用程序目录与用户数据目录不是同一位置，移动应用图标不等于迁移全部配置。更换电脑时，应使用客户端支持的导出方式保存必要信息，并检查新环境中的代理与权限设置。
先看内核方向，再看处理器架构。一般使用先选 v2rayNG；有明确 V2Fly 配置需求时再考虑 v2flyNG。
2015 年后的主流手机通常选择 arm64。少数设备可能运行 32 位系统，仍需以实际系统支持的应用架构为准。
无法确认设备架构时可选通用版。包体包含多种架构支持，但不会因此自动支持更旧的 Android 系统。
适合以 Xray 生态配置为主的 Android 用户。安装后可导入订阅或连接信息，再按系统提示授予 VPN 连接权限。这里的权限用于接管设备流量，不表示安装包附带可用服务器。
适合明确需要 V2Fly 内核且设备支持 arm64 的用户。选择依据是配置兼容性，而不是名称是否与其他客户端相近。
适合无法确认架构时使用。导入来自其他客户端的配置后，仍需检查协议、传输、安全设置与路由字段。
不要默认把 Xray 特有的扩展参数直接用于 V2Fly。订阅能够导入，只说明客户端识别了相应信息，并不代表所有连接参数都能由当前内核执行。
比较两款 Android 客户端 →| 检查项 | 要求与确认方法 |
|---|---|
| 系统与架构 | 优先确认设备支持 arm64 应用；最低 Android 版本以对应 APK 的安装要求为准，通用版不等于兼容所有系统。 |
| 安装授权 | 按系统提示允许当前浏览器或文件管理器安装应用，完成后可收回这项安装权限。 |
| VPN 与后台 | 首次连接需要 VPN 授权。已有其他 VPN 应用运行时先检查冲突；后台频繁断开时，再检查电池优化策略。 |
“应用未安装”并不只对应架构问题，还可能与系统版本、已有应用的签名、可用空间或安装文件读取失败有关。若提示更新冲突，先备份当前配置，确认原应用来源；不要为了完成更新而直接删除唯一一份配置数据。
Android 的 VPN 连接权限与系统网络接管有关。测试两款客户端时建议一次只启动一个，先停用另一个的连接，再检查浏览器访问与客户端日志。只有部分应用异常时，应优先检查分应用代理，而不是马上更换安装包。
先区分 deb 与 rpm，再确认 x64 或 arm64。桌面客户端需要可用的图形会话，不面向仅有终端的服务器环境。
适合使用 deb 包管理体系的发行版，例如 Debian、Ubuntu。amd64 是这里的 x64 架构标记，不限于某一处理器品牌。
适合使用 rpm 包管理体系且依赖版本匹配的系统。相同包后缀不保证适用于所有发行版，应读取软件安装器的依赖提示。
下载后可使用系统软件安装器打开安装包。若依赖不能满足，应检查发行版与包的适配关系，不建议强行忽略依赖安装。arm64 与 aarch64 在这些包名中指向同类处理器架构。
系统代理、入站与路由参考 →| 检查项 | 要求与确认方法 |
|---|---|
| 软件包体系 | 使用发行版原生支持的 deb 或 rpm 格式；具体系统库要求以包元数据和安装器提示为准。 |
| 处理器架构 | x86_64、amd64 对应 x64；aarch64、arm64 对应 arm64。可在系统信息中确认。 |
| 桌面与权限 | 需要图形桌面及相应运行依赖。应用是否读取系统代理由应用自身决定，TUN 与网络接口管理可能另需权限。 |
Linux 桌面环境对系统代理的处理并不完全一致。客户端已经开启系统代理，但某个程序仍直连时，应检查该程序是否读取桌面代理设置，以及它是否有独立的代理选项。这类接管范围问题通常不能通过重装相同安装包解决。
升级时保持包管理方式一致，避免混用手动复制文件与系统软件包安装。若同时保留多个客户端目录，应明确当前运行的是哪一个实例、使用哪个数据目录与监听端口，再判断是否发生配置丢失或端口冲突。
安装、导入、接管是三个独立环节。按顺序确认，可以减少把配置问题误判成安装包问题的情况。
按系统与架构安装，确认界面能正常打开。出现错误时先记录完整提示，区分系统兼容性、依赖缺失和权限问题；不要一次替换多个组件。
使用有权访问的订阅或连接信息，更新后选择具体配置。订阅地址可能包含访问凭据，不应发布到公开讨论区或连同截图一起分享。
桌面先检查系统代理，Android 按提示授权 VPN。确认基本连接后再调整分流、DNS 与 TUN；每次只改一项，保留可回退的设置。
围绕版本选择、架构、配置兼容与备份的五个问题。
新安装可先选采用 Avalonia 跨平台界面的桌面版；习惯 Windows 经典界面与操作方式的用户可选 WPF 版。两者都是 v2rayN，界面框架不同不等于连接性能有固定高低。迁移前先备份订阅、路由与自定义设置。
2015 年后主流手机通常先选 arm64，但仍需确认系统支持 64 位应用。无法确认架构时可选通用版；若提示安装包不兼容，应检查系统版本和应用架构，而不是反复安装同一个文件。
不能默认全部互换。v2rayNG 以 Xray 内核为方向，v2flyNG 以 V2Fly 内核为方向。通用连接信息可能可以导入，但具体协议、传输和扩展字段仍取决于内核支持与客户端版本，迁移后应重新核对。
客户端安装包不包含可直接使用的连接配置。需要准备有权使用的订阅地址或连接信息，导入后选择有效配置，再设置系统代理或相应接管方式。首次连接建议保持默认 DNS 与路由，确认可用后再逐项调整。
先退出客户端并使用其导出或备份功能保存订阅、路由和自定义配置，同时确认实际数据目录。保留原安装文件与备份，升级后检查当前配置、系统代理和日志。回退旧版前也应确认数据格式兼容性，不要直接覆盖唯一备份。