CLIENT PACKAGES / 平台与架构
桌面端选择 v2rayN；Android 首选 v2rayNG，V2Fly 配置环境可考虑 v2flyNG。先选操作系统，再核对芯片架构与安装包格式。
x64 安装包 · Desktop / WPF
新一代跨平台 UI。首次安装可从这一版开始，使用统一的桌面界面管理订阅、服务器和路由设置。
ZIP / x64 / Windows
经典稳定版，使用 Windows WPF 界面。适合已经熟悉原有菜单位置、希望保持既有桌面操作流程的用户。
ZIP / x64 / Windows
两种入口对应不同界面，不代表连接质量的等级。连接结果取决于服务器参数、内核支持和网络路径。切换版本时先备份配置，再退出旧进程，避免相同的本地监听端口被重复占用。
| 检查项 | 选择依据 |
|---|---|
| 操作系统 | 使用仍获系统维护的 Windows 桌面环境；具体最低系统版本以所选包的安装提示为准。 |
| 处理器架构 | 本页两个入口均为 x64。可在“设置 → 系统 → 系统信息”中查看系统类型。 |
| 包与运行环境 | 下载为 ZIP，先解压再运行其中的安装程序。若提示运行环境缺失，按安装提示处理，不混装其他架构组件。 |
| 权限 | 常规启动与系统代理设置按客户端提示操作；启用 TUN 时可能需要管理员权限。 |
将压缩包解压到可写的独立目录，不要直接在压缩文件预览窗口内启动。安装完成后先导入一条有效配置并验证，再设置开机启动。已有另一个代理程序运行时，应先确认由哪个程序管理系统代理。
按“关于本机”中的芯片信息选择 DMG
适用于“芯片”一栏显示 Apple M 系列的设备。优先使用与处理器匹配的原生架构包，不必仅因文件名不同而切换到 Intel 包。
DMG / arm64 / macOS
适用于“处理器”一栏显示 Intel 的设备。设备外观和购买年份不能代替芯片信息，下载前应直接查看系统中的硬件说明。
DMG / x64 / macOS
打开 DMG 后按安装窗口提示将应用放入“应用程序”，再从该目录启动。首次打开遇到系统安全提示时，应核对文件来源与应用名称，并按系统提供的单个应用授权流程操作。
| 检查项 | 选择依据 |
|---|---|
| 芯片 | 在苹果菜单的“关于本机”查看 Apple Silicon 或 Intel，分别对应 arm64 和 x64。 |
| 系统版本 | 所选应用包必须支持当前 macOS 版本；最低要求以安装时的兼容性提示为准。 |
| 安装位置 | 应用放入“应用程序”后再启动，避免长期从挂载的磁盘映像中运行。 |
| 网络权限 | 系统代理或 TUN 可能触发授权。确认操作来自当前客户端，再按提示授予所需权限。 |
完成安装不等于流量已经接管。先检查服务器配置，再选择系统代理或适合当前需求的接管方式。若系统中有其他网络工具，记录其代理与 DNS 设置，避免在排查时同时修改多个程序。
v2rayNG 优先 · v2flyNG 作为 V2Fly 内核备选
2015 年后的主流手机通常先选 arm64。还需确认系统支持 64 位应用，不能只根据处理器名称判断。
APK / arm64-v8a
无法确认应用架构时可选。通用包包含多种架构组件，通常占用更多下载空间，仍受最低系统要求约束。
APK / universal
v2rayNG 使用 Xray 内核。导入连接后检查服务器地址、端口、协议与传输选项；首次启动连接时，Android 会请求建立 VPN 连接权限。该权限用于本机流量接管，不等同于自动获得服务器连接参数。
适合系统支持 arm64 应用、并希望使用 V2Fly 内核配置的设备。安装前确认所需协议与传输方式在该客户端中可用。
APK / arm64-v8a
用于架构尚未确认的安装场景。它与 arm64 包属于同一客户端，选择依据是设备兼容性，而不是节点速度。
APK / universal
v2flyNG 与 v2rayNG 不是同一个内核的两套主题。已有 V2Fly 配置时，可先检查协议和字段支持再决定是否使用。迁移连接信息后，重新检查 DNS、路由和接管设置，不直接覆盖另一个客户端的全部配置文件。
| 检查项 | 选择依据 |
|---|---|
| 系统兼容性 | 以 APK 安装器提示的最低 Android 版本和应用架构支持为准。 |
| 架构 | 支持 64 位应用的主流设备选 arm64；不确定时可尝试通用版。 |
| 安装权限 | 仅向本次打开安装包的浏览器或文件管理器授予所需安装权限，完成后可撤回。 |
| 流量接管 | 首次连接需确认 VPN 权限；同一时间通常只应由一个 VPN 服务接管流量。 |
| 后台运行 | 若锁屏后连接中断，检查电池优化和后台限制，再按设备系统的设置项调整。 |
若提示“应用未安装”，先看完整错误说明。架构不匹配、系统版本过低、存储不足或已有安装的签名不同，都可能导致失败。不要立即卸载已有应用；先导出配置，确认备份可用后再处理安装冲突。
先分发行版包格式，再分 x64 / arm64
使用 DEB 包管理体系的桌面发行版选此格式。文件名中的 amd64 表示 x64 架构，也适用于对应架构的 Intel 处理器。
使用 RPM 包管理体系的桌面发行版选此格式。具体依赖与发行版兼容性仍需由包管理器确认，不能仅凭扩展名判断可用。
通过发行版的图形软件安装工具打开安装包，先阅读依赖与变更提示，再确认安装。软件菜单中出现 v2rayN 后从桌面启动；若启动失败，优先查看包管理器给出的兼容性信息，不要反复更换无关架构的包。
| 检查项 | 选择依据 |
|---|---|
| 桌面会话 | 需要可运行图形应用的桌面环境。本页提供桌面客户端，不作为无桌面服务器的部署包。 |
| 包格式 | Debian、Ubuntu 系通常选 DEB；Fedora 等 RPM 系选 RPM，并检查具体包的依赖要求。 |
| 处理器架构 | x64 对应 amd64 或 x86_64；arm64 对应 arm64 或 aarch64。以系统硬件信息为准。 |
| 权限与依赖 | 安装由图形包管理器处理；TUN 与系统网络设置可能另需授权。 |
安装后先验证图形界面、配置导入与本地监听是否正常，再添加桌面自启动项。系统代理是否被应用使用，取决于桌面环境与应用自身行为；TUN 则需要另行检查权限、路由及其他网络工具的冲突。
安装包解决客户端部署；连接配置、代理模式与验证是后续的独立步骤。
完成以上步骤后，用实际需要访问的应用验证连接，并查看客户端日志中的错误类别。超时、认证失败和域名解析失败对应不同排查方向。不要仅凭一次测试结果就卸载重装，也不要同时调整协议、DNS、路由和代理模式，使问题失去可对照的基线。
把安装更新、连接参数和内核兼容性分别检查，避免混为同一类问题。
更新客户端通常不需要更换服务器，但界面、默认选项和配置转换方式可能变化。先记录当前可用的服务器、监听端口、路由模式与 DNS 设置，退出运行中的客户端后再安装。更新完成后检查订阅是否仍在、当前服务器是否正确、系统代理是否符合预期。
需要回退时，优先使用更新前导出的备份。旧版本未必能识别新版本写入的全部设置，不能将“能够打开配置文件”视为完整兼容。Desktop 与 WPF 之间迁移也应按同样原则处理。
Project V 生态包含不同内核实现。v2rayNG 基于 Xray，v2flyNG 使用 V2Fly；桌面端 v2rayN 的实际内核选择以客户端界面和连接配置为准。协议名称相同，并不保证扩展传输选项、TLS 参数和路由字段在所有内核中完全一致。
先按服务器配置要求选择客户端，再检查协议与传输支持。不要把 Android 上一个客户端的全部设置直接覆盖到另一个客户端。关于字段含义，可对照配置字段文档；关于名词差异，可查看名词解释。
查看协议与内核名词 →优先核对包格式、架构和系统提示，再处理客户端配置。
首次安装可先选 Desktop 桌面版，它使用新一代跨平台界面。习惯经典 Windows 界面或需要沿用原有操作流程时，可选经典稳定的 WPF 版。两者都需要导入有效连接配置；更换界面前先备份订阅、路由与设置，不要同时启动两份客户端占用相同端口。
2015 年后的主流手机通常可先选 arm64，但最终应以设备系统支持的应用架构为准。部分设备虽然使用 64 位处理器，系统仍只支持 32 位应用。无法确认架构，或 arm64 包提示不兼容时，可尝试通用版；通用版也不是对所有旧系统的兼容保证。
客户端安装包不包含可直接使用的服务器连接参数。需要准备有权使用的订阅地址或单个连接配置，再完成导入、选择服务器、设置代理模式与连通性验证。订阅地址可能包含访问凭据，不应公开粘贴到截图或讨论区。
先使用当前客户端的导出或备份功能保存订阅、服务器和自定义规则，记录系统代理及 TUN 设置，再退出客户端进行更新。不要默认不同界面、不同客户端或不同内核的配置目录可以直接互换。更新后先检查配置和监听端口，再恢复代理接管。
先核对操作系统、处理器架构与包格式，并确认下载已完成。Windows 下载项是 ZIP 压缩包，须先解压；macOS 应选择对应芯片的 DMG；Android 应检查应用安装权限和架构兼容性；Linux 应通过图形包管理器查看依赖信息。不要为了打开安装包而关闭整个系统的安全保护。
两者分别使用 Xray 与 V2Fly 内核，协议、传输和扩展字段的支持范围可能不同。常见连接信息可按客户端支持的方式重新导入，但不应假定全部设置或原始 JSON 可以原样迁移。迁移前备份，随后逐项检查服务器参数、TLS、传输、DNS 与路由规则。