客户端安装包 / 平台与架构
桌面选 v2rayN，安卓首选 v2rayNG。先确认操作系统，再按处理器与安装格式选择文件。
以下两个入口均为 x64 安装包。桌面版采用跨平台界面，经典 WPF 版保留熟悉的窗口布局。
桌面代理客户端 · 7.24.1
文件为 ZIP 压缩包。下载后先解压到独立目录，再运行其中的安装程序。
第一次使用可从桌面版开始，它是新一代跨平台 UI，适合在不同桌面系统间保持相近的操作习惯。WPF 是经典稳定版，适合已经熟悉传统界面的用户。两个版本承担相同的订阅管理与代理配置任务，不必为了导入同一份订阅同时安装。
切换版本前，先记录原来的订阅分组、路由选择和自定义端口。不要把两个程序同时设为自动启动，否则它们可能争用本地监听端口，或相互改写系统代理。界面差异不决定服务器质量，也不意味着同一条配置会获得不同的网络资源。
| 检查项目 | 本页提供 | 安装前操作 |
|---|---|---|
| 处理器架构 | x64 | 在设置 → 系统 → 系统信息中确认系统类型 |
| 系统兼容性 | Windows 桌面安装程序 | 以安装程序提示为准；旧系统需确认运行环境支持情况 |
| 文件格式 | ZIP 内含安装程序 | 完整解压后启动，不在压缩包预览窗口内运行 |
| 权限 | 普通代理与 TUN 按需配置 | 仅在安装程序或 TUN 明确要求时授予管理员权限 |
安装完成后先添加订阅，确认列表出现服务器，再选择系统代理模式。TUN 不是完成安装的必选步骤；普通浏览器使用可以先从系统代理开始，便于定位配置问题。
打开苹果菜单 → 关于本机，查看“芯片”或“处理器”一栏，再选择对应安装包。
macOS 桌面客户端 · 7.24.1
Apple M 系列芯片选择 Apple Silicon，Intel 处理器选择 Intel。两个入口都使用 DMG 格式。
芯片架构应以系统信息为准，不按电脑外观判断。打开下载的磁盘映像，按窗口提示将应用放入“应用程序”目录，再从该目录启动。不要长期从挂载的磁盘映像中运行，也不要在更新时保留多个位置不同、名称相同的应用副本。
首次启动若遇到系统拦截，先核对文件来源、文件类型与错误提示，再到“系统设置 → 隐私与安全性”检查是否有针对该应用的处理入口。不要全局关闭安全检查。应用能够打开后，再配置订阅和代理；安装成功本身并不代表已经建立代理连接。
| 检查项目 | 对应选择 | 确认方法 |
|---|---|---|
| Apple Silicon | arm64 DMG | 关于本机的芯片栏显示 Apple M 系列 |
| Intel | x64 DMG | 关于本机的处理器栏显示 Intel |
| 系统兼容性 | 以当前应用要求为准 | 遇到系统版本不兼容提示时，先确认系统更新条件 |
| 应用位置 | 应用程序目录 | 复制完成后从该目录启动，再推出磁盘映像 |
需要接管遵循系统代理设置的应用时，再在客户端选择相应代理模式。若某个应用不走代理，先确认它是否读取系统设置，不要仅因为这一现象反复更换安装包。
先选 v2rayNG；需要 V2Fly 内核兼容性时，再考虑 v2flyNG。两款客户端独立管理各自的配置。
Xray 内核 · 2.2.6
2015 年后的主流手机通常先选 arm64，具体以系统支持的 ABI 为准。架构不明确时可考虑通用版。
v2rayNG 适合作为 Android 上的常用选择。安装 APK 后，先通过订阅分组或剪贴板导入配置，再选择需要使用的服务器。首次启动连接时，系统会请求建立 VPN 连接的授权；这是客户端接管设备流量的系统入口，不等于已经获得可用的远程服务。
主流手机使用 arm64 安装包通常可以减少下载体积。通用版包含更多架构代码，主要解决安装兼容问题，不会让同一条服务器配置自动变快。较旧设备即使处理器支持 64 位，也可能运行 32 位系统，因此不能只看处理器宣传名称。
V2Fly 内核备选 · 1.10.31
按设备架构选择，安装与订阅配置均独立于 v2rayNG。
已有配置围绕 V2Fly 内核使用时，可以选择 v2flyNG。不要把两款应用理解成仅名称不同的同一个程序；具体协议与传输支持取决于各自集成的内核版本。导入后若某些设置无法识别，先核对配置所需功能，而不是反复切换 arm64 与通用版。
切换客户端测试前，先停止另一款应用的连接。Android 的 VPN 连接通常由一个应用接管，多个代理应用同时尝试连接会增加排查难度。也不要为了迁移配置先删除原应用，确认订阅和自定义规则已保存后再整理旧安装。
| 检查项目 | 建议选择 | 注意事项 |
|---|---|---|
| 系统 ABI | arm64 或通用版 | 硬件架构与系统架构可能不同，以系统支持情况为准 |
| 安装格式 | APK | 允许当前浏览器或文件管理应用安装未知来源应用 |
| 系统兼容性 | 由 APK 的系统要求决定 | 安装器提示系统版本不兼容时，先检查系统信息 |
| 连接权限 | 系统 VPN 授权 | 首次连接时确认；测试前停止其他 VPN 应用 |
若安装器显示“应用未安装”，还可能是已有安装的签名、版本或空间条件不匹配。先保存原配置并查看错误，不要把卸载重装作为第一步；卸载可能同时删除本地设置。
先确认包管理体系，再确认处理器架构。deb 与 rpm 不是两个功能版本，而是不同的软件包格式。
Linux 图形客户端 · 7.24.1
Debian、Ubuntu 系通常使用 deb；采用 RPM 包管理体系的发行版选择 rpm，并检查包依赖是否兼容。
在系统“关于”或硬件信息页面确认处理器。常见的 Intel、AMD 桌面设备通常选择 x64；arm64 桌面设备选择对应架构。文件名中的 amd64 与 x86_64 都用于表示 x64，arm64 与 aarch64 则指向相应的 ARM 64 位架构。
优先用发行版的软件安装器打开软件包，让包管理器显示依赖与兼容性提示。文件后缀相同不代表所有发行版都能安装，运行库版本也会影响结果。不要强制忽略依赖；应用正常启动后，再逐项配置订阅、系统代理和路由。
| 检查项目 | 对应安装包 | 安装前确认 |
|---|---|---|
| Debian 系包管理 | deb | 使用软件安装器检查依赖与发行版兼容性 |
| RPM 包管理 | rpm | 确认当前发行版能够满足该软件包依赖 |
| 处理器架构 | x64 / arm64 | 软件包架构必须与系统匹配 |
| 运行环境 | 图形桌面会话 | 本页为图形客户端，不作为服务端安装指引 |
系统代理是否被应用读取，与桌面环境和应用自身设置有关。先用明确支持代理设置的应用测试，再评估是否需要 TUN。TUN 涉及额外权限与路由配置，不宜在第一次启动时同时修改多个网络选项。
安装前确认
先确认设备运行的系统，而不是只看设备品牌。然后查看系统提供的处理器与架构信息，最后选安装格式。相同客户端的不同架构包主要解决运行兼容性，不改变订阅内容，也不是不同等级的服务。
下载卡中的数字由版本清单提供，实际文件名也可能包含发布编号。两者不一致时，不把显示数字当作已经安装的版本；安装完成后在客户端的“关于”页面确认当前程序信息。不要为了让数字看起来一致而自行改写下载文件名。
第一次配置时，每次只改一项。先确认程序能打开，再确认配置能导入，最后测试流量是否按预期转发。
桌面端在“订阅分组”中添加分组，填写订阅地址并保存，然后执行更新订阅。粘贴地址只是在保存来源，更新成功后才会出现可选择的服务器。若提供的是分享链接，可在主窗口使用从剪贴板导入的操作，不要把它误填进订阅地址栏。
Android 端同样先完成订阅设置，再更新配置列表。不同客户端的菜单文字可能略有差别，但“保存订阅来源”和“拉取订阅内容”是两步。列表为空时先看更新结果，不要直接判断为安装包错误。
查看订阅导入步骤 →桌面端选择“自动配置系统代理”后，遵循系统代理设置的应用才会使用该入口。路由选项决定哪些连接走代理、哪些连接直连；它与系统代理是不同层次的设置。应先确认选中的配置可用，再调整分流规则。
TUN 通过虚拟网络接口接管流量，涉及权限、DNS 与路由。它不是安装必选项，也不是解决所有连接问题的开关。Android 使用系统 VPN 接口时，应先停止其他占用该接口的应用。
阅读代理模式说明 →已有客户端可以正常使用时，更新前先整理需要保留的订阅分组、手动添加的配置、自定义路由和端口设置。订阅能够重新拉取，不代表手工修改的项目也会自动恢复。若客户端提供导出或备份入口，先使用对应功能，并把备份放在安装目录之外。
关闭正在运行的程序和开机启动项，再开始安装。尤其在桌面版与经典版之间切换时，不要同时启动两个实例测试同一端口。安装后先确认应用信息，再检查订阅分组与默认选择是否保留，最后恢复代理模式。一次更改客户端、订阅、DNS 和路由，会让出错位置难以判断。
Android 提示不能覆盖已有应用时，应先查看版本与签名相关提示，而不是直接卸载。Linux 更新则优先继续使用原来的包管理方式，避免留下多个安装来源。若新安装无法启动，记录系统给出的原始错误，通常比反复点击下载更有助于定位兼容性问题。
前往常见问题，按现象继续排查 →首次安装可先选桌面版 Desktop，它采用新一代跨平台界面。习惯经典布局时可选 WPF 版，它是经典稳定版。两者都是 v2rayN，不需要同时安装；切换前先备份订阅分组与自定义设置。
2015 年后的主流手机通常先选 arm64，但最终应以设备系统支持的 ABI 为准。若设备架构不明确，或确认系统不是 64 位，可考虑通用版。通用版包含更多架构代码，文件通常更大，并不代表连接更快。
打开苹果菜单中的“关于本机”。芯片栏显示 Apple M 系列时选 Apple Silicon；处理器栏显示 Intel 时选 Intel。选择与硬件匹配的文件，不要只根据电脑外观或购买年份判断。
需要自行准备可用的订阅地址或分享链接。安装包提供客户端程序，不包含可直接使用的服务器配置。桌面端可在“订阅分组”中添加地址，保存后更新订阅；也可从剪贴板导入分享链接。
更新前备份订阅分组、自定义路由与其他重要设置，退出旧客户端后再安装。优先保持原有客户端、架构和安装方式；切换界面版本或软件包类型时，不要假定所有配置都会自动迁移。更新后检查订阅列表、代理模式与路由选择。
先核对系统类型、处理器架构和文件格式，再查看系统给出的具体错误。Windows 的 ZIP 文件需要先解压；Android 需给当前下载或文件管理应用授予安装来源权限；Linux 应通过软件包管理器查看依赖提示。不要为了安装而全局关闭系统安全防护。