安装包先选系统，再选架构
桌面端选 v2rayN，安卓优先选 v2rayNG。按系统、处理器和安装格式定位入口，再继续订阅导入。
四个平台入口分别列出对应包型。卡片内的主按钮为常用选择，其他架构与经典界面放在相邻入口。
以下两个包均为 x64 架构。首次安装从 Desktop 开始，已有经典界面使用习惯时再考虑 WPF。
Desktop 是新一代跨平台 UI；WPF 是经典稳定版，保留熟悉的 Windows 桌面操作布局。
先解压，再安装。 当前两个入口提供 ZIP 压缩包。下载后在文件管理器中完整解压，查看解压目录中的安装程序与说明，不要直接从压缩包预览窗口启动。目录应允许当前账户读写，避免把配置放在受保护的系统目录。
Desktop 与 WPF 的区别主要在界面技术和交互布局，不代表使用同一服务器时必然存在速度差异。选择时先看操作习惯、系统兼容情况和所需设置项。若旧版配置已有较多规则，先导出备份，再在新界面逐项确认，不要覆盖唯一一份可用配置。
| 检查项目 | 选择与处理 |
|---|---|
| 处理器架构 | 本页提供 x64 包。在系统设置的“系统信息”或“关于”中查看系统类型，32 位系统不能安装这些包。 |
| 系统与运行库 | 使用仍受支持的 64 位 Windows；具体最低版本及桌面运行库需求以该安装包说明为准。启动报错时按提示补齐对应架构的依赖。 |
| 文件与权限 | 保留足够解压空间。普通代理使用与虚拟网卡操作的权限要求不同，TUN 启用时可能需要提升权限。 |
如果双击后无反应，先查看系统错误信息、运行库提示与客户端日志。不要把长期以管理员身份运行当成通用修复方案。可继续阅读 v2rayN 启动闪退排查，区分依赖缺失、目录权限与配置损坏。
在苹果菜单中打开“关于本机”：显示 Apple M 系列芯片选 Apple Silicon，显示 Intel 处理器选 Intel。
优先使用匹配芯片的原生架构包，不要仅凭设备外观或购买年份判断。
从应用程序目录运行。 打开 DMG 后按磁盘映像中的提示安装，将应用放入“应用程序”目录，再从该目录启动。首次打开可能触发系统安全提示，应先核实来源，再到“系统设置 → 隐私与安全性”查看与本次打开对应的允许入口。
应用获准启动，并不等于系统代理或虚拟网卡相关权限已经就绪。导入配置后，先用系统代理验证浏览器连接，再按需要启用 TUN。系统升级、应用迁移或重新安装后，原有授权可能需要再次确认。受组织管理的设备应遵循本机管理策略，不要绕过管理员设置。
| 检查项目 | 选择与处理 |
|---|---|
| 芯片架构 | Apple M 系列使用 arm64；Intel 处理器使用 x64。使用对应原生包，减少架构转换带来的兼容变量。 |
| 系统版本 | 先记录“关于本机”中的 macOS 版本；最低系统版本以当前包要求为准，不能仅凭 DMG 格式判断兼容性。 |
| 安装授权 | 需要应用程序目录写入权限。首次打开、安全放行与后续网络授权分别处理，不关闭系统整体防护。 |
遇到“无法验证开发者”或启动后无法接管流量，可按 macOS 放行设置与网络权限说明 检查。先确认应用能正常打开，再定位代理与网络权限，避免同时改动多个设置。
优先选择 v2rayNG。2015 年后的主流手机通常选 arm64；无法确认架构时可使用通用版，但仍需满足系统版本要求。
适合安卓日常使用，通过订阅分组管理配置，通过 VPN 授权接管流量，并可设置分应用代理。
arm64 包只包含对应架构组件，适合支持 64 位应用的设备；通用版覆盖更多架构，文件通常更大。部分手机虽然使用 64 位处理器，系统却未必开放 64 位应用支持，安装失败时应核对系统与应用架构，不要只看处理器名称。
打开 APK 后，系统可能要求允许当前浏览器或文件管理器安装应用。只对本次使用的来源按需授权，安装完成后可收回该权限。首次点击连接还会出现系统 VPN 授权提示；若另一款应用正在占用 VPN 通道，应先确认是否需要停止它，再建立客户端连接。
适用于明确需要 V2Fly 内核且配置与之兼容的场景。选用前核对协议、传输和参数，不以外观相近判断支持范围。
v2flyNG 与 v2rayNG 使用不同的内核路线，支持的协议与新参数可能不同。遇到订阅条目导入失败，应先核对配置所需功能，再决定使用哪个客户端。把同一段配置反复导入并不能补上内核尚未支持的能力，也不应靠随机打开设置开关处理兼容问题。
迁移前保留原客户端中的订阅地址、手动配置和分应用列表。新客户端中先导入少量已知可用的配置，验证连接和 DNS 行为后再迁移其余内容。两个客户端可分别保留设置，但同一时间只启用需要使用的连接，便于判断流量由哪一套规则接管。
| 检查项目 | 选择与处理 |
|---|---|
| 系统与架构 | 在“设置 → 关于手机”查看 Android 版本，结合设备支持的应用架构选包。通用版不意味着兼容所有旧系统。 |
| 安装条件 | 预留下载及安装空间，按需允许当前来源安装应用。提示签名冲突时先备份，不要直接卸载唯一可用配置。 |
| 连接权限 | 首次连接需确认系统 VPN 授权。长时间后台使用时检查电池优化策略，但不必授予与连接无关的权限。 |
提示“应用未安装”时，依次检查剩余空间、Android 版本、架构和已有应用的签名兼容性。若问题发生在覆盖安装阶段，先保留旧配置；若安装成功但后台断开，再检查系统省电策略，这与安装包架构属于不同问题。
先按发行版选择 deb 或 rpm，再按处理器选择 x64 或 arm64。这里提供图形桌面客户端，不用于替代服务器部署工具。
Ubuntu、Debian 等发行版选择 deb；Fedora 等 RPM 系发行版选择 rpm，并检查包依赖是否适合当前发行版。
用系统软件安装器打开包文件。 安装器会显示包架构与依赖信息。相同的 deb 或 rpm 扩展名并不保证跨发行版兼容，尤其应留意系统库版本与包构建目标。依赖无法满足时先确认发行版环境，不要强制忽略依赖完成安装。
安装完成后从桌面应用菜单启动，先确认主界面和日志可正常打开。部分桌面环境需要额外启用托盘支持；关闭主窗口后若找不到托盘入口，应先检查桌面扩展及客户端后台设置。自动启动宜配置为用户登录后的桌面启动项，不要把整个图形客户端长期作为系统管理员进程运行。
| 检查项目 | 选择与处理 |
|---|---|
| 发行版包型 | Debian 系通常使用 deb，RPM 系使用 rpm。安装前以软件安装器显示的依赖和发行版兼容要求为准。 |
| 处理器架构 | x86_64、amd64 对应此页 x64；aarch64 对应 arm64。不要把发行版位数与包格式混为一谈。 |
| 桌面与权限 | 需要可用的图形桌面环境。安装包管理与 TUN 配置可能要求授权，普通界面使用不等于需要管理员会话。 |
桌面应用能启动但浏览器未使用代理时，先核对桌面环境的代理设置和应用自身代理策略，再决定是否需要 TUN。安装、自启动与托盘入口的连贯操作见 Linux deb/rpm 安装与登录自启动说明。
把安装与连接验证分开处理。每完成一步再进入下一步，出错时更容易定位原因。
确认下载包与当前系统、处理器匹配，再按包格式安装。首次启动只检查界面、日志与必要授权，不急于同时修改 DNS、路由和 TUN。若应用本身无法启动，先处理系统依赖与目录权限；更换订阅不会修复启动阶段的问题。
在订阅分组中添加有权使用的订阅地址，更新后查看导入结果。手动配置需要逐项核对地址、端口、协议与传输参数。不要把订阅链接当作普通网址公开分享，其中可能包含个人访问标识。导入完成后明确选中要使用的服务器。
桌面端可先启用系统代理；安卓端确认 VPN 授权。系统代理依赖应用遵循系统设置，并不保证所有程序都会使用它。验证时结合应用访问结果和客户端日志，不以开关变蓝作为连接成功的唯一依据。有虚拟网卡需求时，再单独配置 TUN 与相关路由。
客户端程序、内核能力和订阅内容是不同层面的内容。升级可能调整设置入口或配置结构，但不会自动修复服务器侧参数错误。准备升级时先记录当前使用的客户端、代理端口、路由模式与关键 DNS 设置，再退出程序，避免配置仍在写入时覆盖文件。
备份至少应包括手动服务器、订阅分组和自行编写的路由。备份中可能有访问凭据，应限制读取范围，不放在公开分享目录。跨界面或跨客户端迁移时，优先使用导入、导出功能，并在新环境检查字段是否完整；不要假定目录名称相同就能直接替换。
先判断问题发生在下载、安装、启动还是连接阶段，再选择对应处理方式。
新安装优先选择 Desktop，它使用新一代跨平台界面；习惯经典 Windows 界面的用户可选择 WPF 经典稳定版。两个入口均为 x64 包，不要根据界面名称判断处理器兼容性。切换前先导出订阅、服务器与自定义规则，避免直接共用正在使用的配置目录。
2015 年后的主流手机通常优先选择 arm64，但仍需确认设备系统支持 64 位应用。无法确认架构，或 arm64 包提示不兼容时，可尝试通用版；通用版仍受客户端最低系统要求限制。安装前确认系统版本、剩余空间与安装来源授权。
客户端提供配置管理与流量转发功能，安装包不包含可用订阅或服务器。需要自行准备有权使用的订阅或连接参数，完成导入、选择服务器，再启用系统代理或授权 VPN 连接。连接失败时先查看日志，不要反复更换安装包。
先保存订阅分组、手动添加的服务器、自定义路由与 DNS 设置，再退出客户端。备份文件可能包含订阅地址和访问凭据，应保存在受控位置。更新后检查代理端口、路由模式与 TUN 设置，不要假定所有界面版本都能直接复用同一个配置目录。
卡片版本文字来自应用级版本字段，具体包地址来自平台安装包字段，两者可能尚未同步。判断某个包的具体版本，应结合实际下载文件名与安装后客户端的版本信息，不要仅凭卡片文字认定所有平台包已同步更新。
先确认安装包来源与芯片架构，在首次尝试打开后查看系统设置中的隐私与安全性，按系统提供的入口决定是否允许打开。受管理设备可能需要管理员批准。不要为了运行客户端关闭系统整体防护；后续网络权限与系统代理授权需分别确认。