v2rayN
Windows · x64
Desktop 是新一代跨平台 UI；WPF 是经典稳定版，保留熟悉的 Windows 桌面操作布局。首次安装可先选 Desktop。
当前清单 7.24.1 · ZIP 压缩包
先解压到独立目录，再运行包内安装程序或启动入口。不要直接在压缩包预览窗口里启动。
客户端安装包 / 平台与架构
V2Ray 客户端下载
桌面端选择 v2rayN，Android 优先选择 v2rayNG。先确认系统与处理器，再选择安装包。
- VMess
- VLESS
- Trojan
- Shadowsocks
桌面客户端v2rayN · Desktop / WPF
Android 客户端v2rayNG / v2flyNG
使用前准备订阅地址或服务器配置
按操作系统选择
安装包与系统要求
首推
Desktop 与 WPF 的选择
两种入口的主要区别是界面技术与操作布局，不是两套订阅服务。Desktop 适合希望在多个桌面系统间保持相近操作习惯的用户；WPF 适合已经熟悉经典菜单和设置位置的用户。教程中的菜单位置可能随界面与版本调整，遇到名称差异时应按设置含义对应。
这里提供的是 x64 包。在“设置 → 系统 → 系统信息”查看系统类型，确认处理器与系统均适合该架构。若启动时提示缺少运行库，按错误信息确认所需的 .NET Desktop Runtime 版本，不要仅凭客户端名称安装任意运行库。
更换版本前先退出旧程序并备份配置。保留一份可恢复的原目录，待新版本确认订阅分组、路由和本地端口正确后再整理旧文件。不要同时让两个进程接管系统代理。
Windows 安装前检查
| 检查项 | 要求与操作 |
|---|---|
| 系统与架构 | 优先使用仍受系统厂商支持的 Windows；本页提供 x64 包。具体最低系统版本以安装提示及对应发布说明为准。 |
| 安装目录 | 使用当前账户可写入的独立目录，避免直接覆盖正在运行的程序目录。 |
| 运行环境 | 按包类型和启动提示准备运行库；包含运行环境的包与依赖系统运行库的包，要求可能不同。 |
| 代理接管 | 普通系统代理与 TUN 的权限需求不同。先用系统代理完成基础连接，再按需评估 TUN。 |
v2rayN
macOS · Desktop
按“关于本机”显示的芯片选择。Apple Silicon 使用 arm64，Intel 处理器使用 x64，不按设备外观或购买年份判断。
当前清单 7.24.1 · DMG 磁盘映像
打开映像后将应用放入“应用程序”，再从该目录启动；完成安装后可推出磁盘映像。
先确认芯片，再安装应用
打开苹果菜单中的“关于本机”。若显示 Apple M 系列芯片，选择 Apple Silicon；若显示 Intel 处理器，选择 Intel。优先使用与机器架构一致的包，减少转译层带来的额外变量。安装界面提示系统版本不满足时，应先核对应用要求，而不是反复更换同一架构的包。
首次启动可能需要在“系统设置 → 隐私与安全性”中确认应用来源。只在确认下载来源与文件用途后处理系统提示，不建议关闭全局安全机制。若设备受组织管理，应用安装和网络设置还可能受到管理员策略限制。
导入订阅后先检查当前配置，再设置系统代理。网络扩展、其他 VPN 与手动代理可能影响请求路径；排查时一次只保留一种接管方式。退出客户端前清除其设置的代理，避免本地监听停止后应用仍向旧端口发送请求。
macOS 安装前检查
| 检查项 | 要求与操作 |
|---|---|
| 处理器 | Apple Silicon 对应 arm64；Intel 对应 x64。以“关于本机”的信息为准。 |
| 系统版本 | 使用应用当前构建支持的 macOS；最低版本以安装和启动提示为准，不仅取决于芯片类型。 |
| 应用位置 | 安装到“应用程序”后运行，确认当前账户有正常的配置写入权限。 |
| 网络权限 | 按系统提示授予实际需要的权限；TUN 与系统代理分别配置，避免与现有网络工具重复接管。 |
v2rayNG
Android · Xray
以 Xray 为内核的 Android 客户端。2015 年后的主流手机通常先选 arm64；设备架构不明确时选择通用版。
当前清单 2.2.6 · APK 安装包
清单版本字段与包文件名可能更新不同步，安装时显示的版本以实际安装包信息为准。
v2flyNG
Android · V2Fly
使用 V2Fly 内核的备选客户端。适合明确需要该内核配置的场景；导入前确认协议、传输与扩展字段的兼容性。
当前清单 1.10.31 · APK 安装包
切换客户端前先备份订阅与自定义规则，停止另一客户端的 VPN 连接后再启动。
APK 安装与首次 VPN 授权
下载完成后，通过系统文件管理器打开 APK。若提示来源权限未开启，仅为本次使用的浏览器或文件管理器允许安装应用，安装后可恢复原设置。“应用未安装”不一定是文件架构问题，还可能与系统版本、存储空间或已有应用签名不同有关；已有配置应先导出，不要直接卸载后再寻找备份。
arm64 指设备应用运行环境支持的架构，处理器出厂年份只能作为初步参考。部分设备虽然使用 64 位处理器，系统仍可能采用不同的应用运行环境。无法确认时可尝试通用版，但通用版也不能绕过应用本身的最低系统要求。
首次连接会出现系统 VPN 授权提示，确认后客户端才能建立本地网络接管。若切到后台后连接中断，检查电池优化、后台活动和省电策略。按应用分流时，需要留意所选列表代表“代理这些应用”还是“绕过这些应用”，不要只看列表中是否勾选。
Android 安装前检查
| 检查项 | 要求与操作 |
|---|---|
| 架构选择 | 主流设备优先 arm64；不确定时选 universal，并核对实际系统 ABI 与应用兼容性。 |
| 系统版本 | 以各 APK 的安装要求为准；两款客户端可能采用不同的最低系统版本。 |
| 安装权限 | 允许当前文件来源安装应用；更新时注意签名与现有安装来源是否一致。 |
| 连接权限 | 确认系统 VPN 授权，同一时间只运行一个需要占用系统 VPN 通道的客户端。 |
v2rayN
Linux · Desktop
先按发行版选择 deb 或 rpm，再选择处理器架构。以下主入口为 x64，使用 ARM 桌面设备时改选下方 arm64 包。
当前清单 7.24.1 · 使用发行版软件安装器打开
包格式与发行版兼容性
Debian、Ubuntu 等系统通常使用 deb；Fedora、部分企业发行版通常使用 rpm。包格式一致只表示安装管理方式相近，不保证系统库版本一定满足要求，尤其 rpm 文件名包含特定发行版构建信息时，更应留意依赖提示。遇到依赖无法满足，不要强制忽略安装器的错误。
x64 在 deb 包中常标为 amd64，在 rpm 包中常标为 x86_64；arm64 在 rpm 包中常标为 aarch64。这些命名差异不是不同级别的功能版本。通过桌面“设置 → 关于”查看系统与处理器信息后，再打开对应的软件安装器完成安装。
桌面环境对系统代理的处理并不完全相同，部分应用需要单独设置本地代理地址。TUN 还涉及设备权限、路由和 DNS，建议先完成普通代理测试。图形客户端不应为了修改一项网络设置就长期以管理员身份运行。
Linux 安装前检查
| 检查项 | 要求与操作 |
|---|---|
| 包管理格式 | 按发行版选择 deb 或 rpm，使用软件安装器查看依赖及兼容性提示。 |
| 处理器架构 | x64 对应 amd64 / x86_64；arm64 对应 arm64 / aarch64。 |
| 桌面运行环境 | 需要可运行图形应用的桌面环境及相应系统库，不把图形安装包当作纯服务端组件。 |
| 网络接管 | 确认桌面环境的系统代理行为；TUN 的权限和路由需求另行处理，不与其他网络工具重复配置。 |
- 导入配置。桌面 v2rayN 打开“订阅分组”，填写订阅地址并保存，再执行订阅更新。Android 客户端可在订阅分组设置中添加地址，回到主界面执行更新。教学地址
https://example.com/sub?token=xxxx仅用于说明格式，不能提供实际连接。 - 选择路由与配置。先确认当前选择的是准备使用的配置，再选择适合的路由模式。“绕过大陆”“全局”“直连”决定内核接收请求后的出站策略；全局模式并不意味着所有应用都会自动接入本地代理。
- 启用接管并验证。桌面按需选择“自动配置系统代理”，Android 确认 VPN 授权后启动。先测试单个应用，再检查其他应用。若连接异常，记录错误发生在订阅更新、程序启动还是请求阶段，避免反复卸载丢失排查线索。
安装包选择与更新
下载常见问题
Windows 的 Desktop 与 WPF 应该选哪个？
首次安装可先选 Desktop，它采用新一代跨平台界面。WPF 是经典稳定版，适合熟悉传统 Windows 操作布局的用户。两者均需导入可用配置；更换界面前先导出配置，不要同时运行两个客户端修改系统代理。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但仍应以设备实际处理器及系统 ABI 为准。架构不确定时可选通用版。若提示应用未安装，还需检查系统兼容性、剩余存储和已有应用的签名，先备份配置再处理旧应用。
下载客户端后能直接连接吗？
安装包提供客户端程序，不附带可用服务配置。需要自行准备有权使用的订阅地址或服务器参数，导入后选择配置并启动连接。桌面端还需按应用需求设置系统代理或 TUN；Android 首次连接需确认系统 VPN 授权。
更新客户端会保留订阅和路由吗？
是否保留取决于安装方式、配置目录和版本迁移行为，不能只根据安装包名称判断。更新前先导出配置并记录自定义路由、端口和订阅分组。退出旧程序后再安装，首次启动检查配置是否迁入，再开启系统代理或 TUN。
v2rayNG 与 v2flyNG 可以互相替代吗？
两者是不同的 Android 客户端，v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核。协议、传输和配置字段的支持范围可能不同，导入成功不代表所有参数都能运行。优先按服务配置的要求选择，不要同时启动两个客户端的 VPN 连接。
为什么打开系统代理后有些应用仍然直连？
系统代理只影响遵循该设置的应用，终端、部分游戏及自带代理设置的程序可能不读取它。先确认客户端正在运行、本地端口一致，再检查应用自己的代理配置。需要覆盖更多应用时可评估 TUN，但应先处理与现有 VPN、虚拟网卡及路由的冲突。