v2rayN
首推 7.24.1Desktop 使用新一代跨平台界面,适合首次安装或在不同桌面系统之间切换。WPF 是经典稳定版,适合习惯旧界面与托盘操作的用户。两者是同一客户端的不同界面版本,选一个即可。
图形客户端 · 安装包
先选操作系统,再核对处理器架构。桌面端使用 v2rayN,Android 可按配置所需的内核选择 v2rayNG 或 v2flyNG。
Desktop 使用新一代跨平台界面,适合首次安装或在不同桌面系统之间切换。WPF 是经典稳定版,适合习惯旧界面与托盘操作的用户。两者是同一客户端的不同界面版本,选一个即可。
| 检查项 | 要求 |
|---|---|
| 系统与架构 | Windows 10 或 11,x64 系统与处理器 |
| 安装格式 | ZIP 压缩包,完整解压后运行其中的安装程序 |
| 运行环境 | 如提示缺少运行时,按所选版本的启动提示处理 |
打开「设置 → 系统 → 关于」,查看「系统类型」。本区两个入口都是 x64 包。不要仅根据电脑品牌判断架构,也不要把处理器支持的位数等同于正在运行的系统类型。
从下载目录把 ZIP 完整解压到单独的文件夹,再打开其中的安装程序。如果更新前已经启用了系统代理,先在旧客户端清除系统代理,再退出程序。这样可以避免安装期间浏览器继续把请求发往已经关闭的本地端口。
换用另一种界面时,不要直接用新安装目录覆盖旧目录。先保存原有订阅分组、路由和代理模式,再启动新版本确认界面与配置。待新版本能够更新订阅并建立连接后,再决定是否移除旧版本。
从苹果菜单打开「关于本机」。显示「芯片」且名称是 Apple M 系列,就选 Apple Silicon;显示 Intel「处理器」,就选 Intel 版。两个包对应不同机型,不是功能分级。
| 检查项 | 要求 |
|---|---|
| 芯片 | Apple Silicon 对应 arm64,Intel 对应 x64 |
| 系统版本 | 以当前应用版本支持的最低 macOS 版本为准 |
| 安装格式 | DMG 磁盘映像;需要有权限将应用复制到应用程序目录 |
打开 DMG,把应用复制到「应用程序」,再从该目录启动。更新前先退出正在运行的旧版本,包括菜单栏里的进程。复制完成后退出磁盘映像,以免下一次从映像里的副本误启动旧应用。
如果应用能打开,但浏览器没有使用代理,先确认客户端里选中了活动服务器,再到「系统设置 → 网络」检查当前网络服务的代理配置。应用启动和代理生效是两个检查点,不必因为后者失败就重新下载。
遇到启动提示时,先记录完整提示并核对芯片和系统版本。应用权限、网络权限与安装包架构不是同一类问题。受组织管理的设备应按管理员规定处理。
使用 Xray 内核。2015 年后的主流手机通常选 arm64,前提是系统支持 arm64-v8a。无法确定架构时,可先选通用版。
使用 V2Fly 内核。已有面向 V2Fly 的配置、并确认当前版本支持所用协议时,可选此客户端。两款应用的高级配置不能假定通用。
| 检查项 | 要求 |
|---|---|
| arm64 包 | 系统支持 arm64-v8a 应用 |
| 通用包 | 设备匹配包内架构之一,系统版本满足应用要求 |
| 连接权限 | 使用 VPN 模式时,需确认系统的 VPN 连接请求 |
手机采用六十四位处理器,并不代表系统一定允许安装六十四位应用。如果系统提示安装包不兼容,先核对系统支持的应用架构与系统版本;通用包可以解决部分架构选择问题,但不会降低应用要求的系统版本。
通过浏览器或文件管理器打开 APK 时,系统可能针对该来源请求安装授权。确认自己打开的是刚下载的文件,再处理这一来源的权限。首次启动后,VPN 模式还会单独弹出连接授权;安装成功不代表这项权限已授予。
升级前若已启用「始终开启的 VPN」,先在系统 VPN 设置里核对它关联的是哪款应用。测试新客户端时停止旧连接,避免把连接被占用误判成订阅失效。遇到覆盖安装失败,先保留旧应用里的设置。
Debian、Ubuntu 系优先看 deb;使用 RPM 包的发行版先核对目标环境和依赖。当前 RPM 文件名含 el10,表示构建目标,不能仅凭扩展名判断适用于所有 RPM 系统。
| 检查项 | 要求 |
|---|---|
| 架构 | x86_64 选 x64;aarch64 选 arm64 |
| 发行版 | 包格式、目标发行版及依赖均相符 |
| 桌面环境 | 使用图形桌面会话,安装权限由系统包管理器处理 |
从系统设置的「关于」页面查看发行版、版本和处理器类型。包名中的 amd64 不只适用于 AMD 处理器,也用于兼容的 Intel x64 机型;aarch64 与 arm64 对应同一类架构。
用发行版的图形包管理器打开文件,检查依赖提示后再确认安装。若提示系统库版本过低,不要强制忽略依赖,也不要用其他发行版的软件源替换系统库。先确认当前发行版是否符合包的构建目标。
安装结束后,从桌面应用菜单启动 v2rayN。检查窗口能否打开、订阅能否刷新,再测试代理。若浏览器正常而其他程序没有使用代理,先确认该程序是否读取桌面环境的代理设置。
启动客户端后,先导入已有订阅,执行一次更新,再选中一个服务器。只测试一种连接模式,确认基础连接正常后再改路由或 DNS。若刚装好就同时开启系统代理、TUN 并修改分流,不容易分清问题出在导入、连接还是流量接管。
验证时分别检查两件事:客户端是否显示连接已经启动,目标应用是否实际通过所选模式访问网络。前者成立而后者失败时,先看目标应用是否读取系统代理,或是否被规则分到直连。操作路径见快速上手。
更新或迁移前,把原客户端里的订阅分组、手动录入的服务器、自定义路由和 DNS 单独记录。客户端支持导出时,先把备份保留在自己控制的设备里。订阅链接可能包含访问凭据,排查问题时不要把完整链接或含链接的截图发出去。
遇到问题时,记下是安装程序无法运行、客户端无法启动、订阅无法更新,还是连接已启动但应用未走代理。不同阶段应检查不同设置。若基础连接正常,下一步可按进阶手册逐项配置路由、DNS 和 TUN。
不需要。首次安装可选 Desktop;如果已有基于 WPF 界面的工作流程,可以继续使用经典 WPF 版。切换之前先退出旧客户端,并备份需要保留的订阅和路由设置。
能否覆盖取决于应用包名、签名和版本,而不只取决于架构。如果系统拒绝更新,先保留原应用并备份配置,再核对新旧安装包的来源与版本,不要先卸载再排查。
不能直接互换。选择发行版包管理器支持的格式,再核对发行版版本、处理器架构与依赖。包管理器报告依赖不满足时,先记录缺少的依赖,不要强制跳过检查。
安装包提供客户端。首次打开后,需要导入已有的订阅或服务器配置,再选中一个节点。已有订阅但列表仍为空时,先确认是否执行了更新,以及当前查看的是否是对应订阅分组。
订阅主要用于同步服务器列表。路由规则、DNS 设置和连接模式应单独记录,在新客户端中逐项核对。先验证基础连接,再恢复分流和其他高级设置。