v2rayN
首推新安装先看 Desktop；熟悉经典界面可选 WPF。两个入口均为 ZIP 包，下载后先解压，再运行其中的安装程序。
按平台选择安装包
每个入口对应具体包格式。客户端永久免费、代码开源；网络连接仍需要有效的服务器配置，订阅地址应由可信来源提供。
Windows 系统与运行条件
| 项目 | 选择与检查方式 |
|---|---|
| 处理器架构 | 本页提供 x64 包。在“设置 → 系统 → 系统信息”中查看系统类型，确认设备与安装包架构相符。 |
| 系统环境 | 使用仍受支持的 64 位 Windows；具体最低系统版本及运行时依赖以当前发行包说明为准。 |
| 权限与资源 | 保留解压和安装所需空间。普通代理配置与 TUN 权限要求不同，不要在首次启动时一并开启所有功能。 |
Desktop 与 WPF 的选择
两版的主要差别在界面框架与桌面使用方式，不是订阅来源。Desktop 使用新一代跨平台界面，WPF 延续经典 Windows 操作布局；菜单位置、窗口行为与部分功能入口可能不同。已有教程截图与实际界面不一致时，先根据菜单名称找对应功能，不要只凭按钮所在位置判断是否缺少功能。具体功能覆盖随发行版本变化，选型时应结合当前更新说明。
已有 WPF 配置且使用正常，可以先备份再评估是否切换 Desktop。不要直接用新版本覆盖唯一一份配置目录，也不要让两版同时运行并接管系统代理。迁移后依次检查订阅分组、当前服务器、系统代理与路由设置，确认基本连接后再恢复自定义选项。首次安装则从一个版本开始，减少重复配置带来的排查负担。
下载后的安装顺序
- 将 ZIP 保存到可写目录并完整解压；不要在压缩包预览窗口中直接启动安装程序。
- 运行解压后的安装程序，按提示完成安装。如果提示缺少运行环境，先记录依赖名称，再按发行说明补齐，不要反复重装同一个包。
- 启动客户端后导入配置，选择服务器，再开启自动配置系统代理。通过浏览器测试基本连接，最后处理路由分流和 TUN。
安装过程中若出现文件被占用，先退出托盘中的客户端，再检查是否还有旧进程运行。应用能打开但无法连接时，应转向配置与网络排查，重新下载安装包通常不能解决订阅失效、服务器参数错误或端口冲突。详细操作可继续阅读 使用指南。
v2rayN
桌面客户端按“关于本机”显示的芯片类型选择安装包，Apple M 系列与 Intel 使用不同入口。
macOS 系统与芯片要求
| 项目 | 选择与检查方式 |
|---|---|
| Apple Silicon | 苹果菜单 → 关于本机，芯片为 Apple M 系列时下载 arm64 DMG。 |
| Intel | 处理器为 Intel 时下载 x64 DMG，不要仅凭购买年份判断芯片架构。 |
| 系统与权限 | 最低 macOS 版本以当前发行包说明为准。首次启动可能需要安全放行，系统代理与 TUN 所需权限应按实际功能提示处理。 |
DMG 安装与首次启动
下载完成后打开 DMG，将应用拖入“应用程序”目录，再从应用程序目录启动。不要长期从挂载的磁盘映像内运行，否则更新、应用路径识别和权限记录可能不便管理。确认安装结束后可以推出磁盘映像；保留下载文件与否取决于后续维护需求，不影响已复制到应用程序目录的应用启动。
首次启动遇到开发者验证提示时，先核对下载来源和芯片包是否选对，再查看“系统设置 → 隐私与安全性”中的相关提示。只对已确认来源的应用执行放行，不要为了启动一个应用而整体关闭系统安全机制。不同 macOS 版本的按钮位置可能变化，应以系统当前提示为准。
安装与网络授权分开处理
应用可以打开，并不代表所有网络功能已经得到授权。先导入有效配置，用普通系统代理验证连接；确实需要接管更多应用流量时，再按说明启用 TUN 并处理对应权限。系统代理、网络扩展和虚拟网卡属于不同层面的设置，不能把一种权限的放行当成另一种功能已经生效。
若启动后没有显示窗口，先查看菜单栏或 Dock 中是否已有运行实例。若网络只在退出应用后恢复，检查系统代理是否仍指向本地端口，再核对是否同时运行其他代理客户端。处理权限问题时记录具体提示与系统版本，比反复下载不同架构的包更有助于定位原因。
v2rayNG
首推Android 常用选择，支持分享链接与订阅导入。2015 年后的主流手机通常先选 arm64，仍需核对系统支持的架构。
v2flyNG
备选适合已有 V2Fly 配置需求的用户。安装前确认现有协议和传输设置能被该客户端及内核版本支持。
arm64 安装包
设备支持 arm64-v8a 时选择此包；安装后重新检查订阅与服务器参数。
下载 v2flyNG · arm64 v2flyNG_1.10.31-fdroid_arm64-v8a.apkAndroid 系统与架构要求
| 项目 | 选择与检查方式 |
|---|---|
| 设备架构 | 2015 年后的主流手机通常可选 arm64；部分设备系统仍有架构限制，无法确认时选择通用版。 |
| 系统版本 | 最低 Android 版本以对应客户端当前发行说明为准；处理器支持 64 位不等于系统一定支持该包。 |
| 安装与连接权限 | 为实际打开 APK 的浏览器或文件管理器允许安装应用；首次连接需要确认系统 VPN 授权。 |
架构选择与安装失败排查
arm64 是处理器与应用运行架构，不能仅用手机品牌或型号年份替代判断。大多数近年的设备适用 arm64 包，但旧设备、特殊系统或采用其他架构的设备可能需要通用版。通用版扩大架构覆盖范围，并不会自动解决系统版本过低、存储不足或已安装应用签名不一致的问题。
打开 APK 后按系统提示完成安装。允许安装应用的权限通常绑定到发起安装的应用：从浏览器下载后用文件管理器打开，可能需要为文件管理器单独授权。安装完成后可关闭临时授予的安装权限。若系统提示应用未安装，先检查是否有同名旧应用、剩余空间和架构兼容性，再判断是否需要备份后重新安装。
v2rayNG 与 v2flyNG 的适用区别
v2rayNG 采用 Xray 内核，作为本页 Android 首推；v2flyNG 采用 V2Fly 内核，供已有相应配置需求的用户选择。两者属于同一代理生态中的不同客户端选择，不应据此假定所有订阅参数都能互通。协议、传输方式和扩展参数是否可用，仍取决于实际内核版本与客户端的配置支持。
首次连接时确认系统 VPN 请求，并注意同一时刻通常只有一个此类网络接管应用能工作。若已经启用另一款客户端或其他 VPN 应用，先停止原有连接再测试。连接按钮显示启动只说明本地服务已运行，还需要通过网页访问与日志确认服务器是否可用。后台断连时再检查电池优化和后台运行限制，不要把所有问题都归因于安装包。
v2rayN
桌面客户端先按发行版选择 deb 或 rpm，再匹配 x64 或 arm64。以下主入口适用于 x64 桌面，arm64 入口列在其后。
Linux 系统与包格式要求
| 项目 | 选择与检查方式 |
|---|---|
| deb 包 | 适用于采用 deb 包管理体系的发行版；需满足发行包要求的系统库版本。 |
| rpm 包 | 适用于采用 rpm 包管理体系的发行版；相同包格式并不代表所有发行版版本都兼容。 |
| CPU 架构 | 常见 Intel、AMD 桌面选择 x64；arm64 桌面选择对应备选包。amd64、x86_64 常指 x64，aarch64 常指 arm64。 |
| 运行环境 | 需要可用的图形桌面与相应依赖。普通用户启动应用，只有涉及系统网络设置时按提示授权。 |
通过图形包管理器安装
将安装包保存到本地后，用发行版提供的软件安装器打开。安装器可能需要管理员授权来写入系统目录，并从发行版软件源补齐依赖；遇到依赖问题时先查看具体缺失项和系统版本，不要强行忽略依赖。deb 与 rpm 是不同的包管理格式，给文件换扩展名不能将其转换成另一种格式。
安装完成后从应用菜单启动 v2rayN。窗口无法打开时，优先确认架构、图形环境和依赖是否匹配；窗口可用但网络未接入代理时，则需要检查桌面环境的系统代理设置。不同桌面和应用对系统代理的遵循程度不同，一个浏览器能连接并不能证明所有应用都会自动使用同一入口。
代理范围与权限边界
先用普通代理模式验证服务器连接，再考虑 TUN。TUN 涉及虚拟网卡、路由与权限，配置范围比应用代理更广。遇到授权提示时应明确对应的操作，不要为了方便让整个图形客户端长期以高权限运行。系统中已有其他代理或网络接管工具时，先关闭其中一个，再检查是否存在端口占用与路由冲突。
更新前先退出客户端并保留配置备份，再通过包管理器安装新包。发行版大版本升级后，原本可用的系统库和桌面集成可能发生变化，应重新核对当前包要求。完整配置步骤与分流原则见 完整手册，此页只提供图形客户端安装入口。
下载之后：配置与更新
下载异常先区分传输与安装
浏览器未完成保存、连接中断或文件仍处于下载状态，属于传输问题；保存完成后系统提示架构不兼容、依赖缺失或签名冲突，属于安装问题。先记录提示内容，再检查对应环节，避免在不同平台包之间反复尝试。下载完成并成功启动，但订阅无法更新或服务器连接失败，则应按网络配置问题处理，而不是继续更换安装包。
迁移到另一款客户端时，导入成功只代表配置被读取，并不能证明所有扩展参数都受到支持。先确认使用的协议与传输，再检查内核能力和客户端配置界面。Project V、V2Fly 与 Xray 属于相关开源生态，具体功能仍以实际发行版本为准；有明确配置需求时，选型应从需求出发，而不是只比较界面名称。
下载与安装常见问题
先核对包类型，再处理安装提示。以下问答聚焦下载选择；订阅更新和连接故障可转到 FAQ。
Windows 应该下载 Desktop 还是 WPF 版？
新安装可先选择 Desktop 桌面版，它使用新一代跨平台界面；习惯经典 Windows 界面可选择 WPF 版。两者都应按当前发行包要求准备运行环境。切换前备份订阅分组和路由设置，不要让两个客户端同时接管系统代理。
Android 的 arm64 与通用版怎么选？
2015 年后的主流手机通常可选 arm64，但仍应核对设备和系统支持的架构。无法确认架构，或 arm64 包提示不兼容时，可选择通用版。通用版包含更多架构内容，文件通常更大。
macOS 如何判断应该下载哪个安装包？
打开苹果菜单中的“关于本机”。芯片显示 Apple M 系列时选择 Apple Silicon arm64 包；处理器显示 Intel 时选择 Intel x64 包。安装后若有安全提示，先确认下载来源，再到系统设置的“隐私与安全性”中按提示处理。
Linux 的 deb 和 rpm 能互换使用吗？
应选择发行版原生支持的包格式。Debian、Ubuntu 及其常见衍生发行版通常使用 deb；Fedora、RHEL 系及相关发行版通常使用 rpm。还要同时匹配 x64 或 arm64 架构，并核对发行包所需的系统库版本。
下载安装后为什么还不能直接连接？
客户端负责导入和使用服务器配置，安装包本身不提供订阅或可用服务器。需要导入有效的分享链接或订阅地址，选择服务器，再设置系统代理或应用代理。先验证基本连接，再逐步配置分流与 TUN。
更新前需要备份什么，版本文字为何可能与文件名不同？
更新前备份订阅分组、手动添加的服务器、路由规则及自定义 DNS 设置，并退出正在运行的客户端。页面版本文字与文件名来自清单的不同字段，发布维护时可能暂时不同；不要据此手动改写下载地址，应结合安装后的“关于”页面与更新说明确认实际版本。