v2rayN
Desktop 使用新一代跨平台界面,适合初次安装或经常在不同桌面系统间切换的用户。WPF 是经典稳定版,已熟悉原有菜单位置和操作流程时可继续使用。界面版本不决定节点是否兼容,还要看客户端实际调用的内核和节点参数。
下载得到的是 ZIP。先解压到当前用户可以写入的目录,再运行其中的安装程序。更换界面版本前退出正在运行的客户端,备份配置和自定义规则;不要把新版本直接覆盖到唯一一份工作目录上。安装后先打开主界面确认配置正常,再重新启用系统代理或 TUN。
先选操作系统,再按处理器架构和安装格式取包。桌面端使用 v2rayN;Android 可按配置所需内核选择 v2rayNG 或 v2flyNG。
Desktop 使用新一代跨平台界面,适合初次安装或经常在不同桌面系统间切换的用户。WPF 是经典稳定版,已熟悉原有菜单位置和操作流程时可继续使用。界面版本不决定节点是否兼容,还要看客户端实际调用的内核和节点参数。
下载得到的是 ZIP。先解压到当前用户可以写入的目录,再运行其中的安装程序。更换界面版本前退出正在运行的客户端,备份配置和自定义规则;不要把新版本直接覆盖到唯一一份工作目录上。安装后先打开主界面确认配置正常,再重新启用系统代理或 TUN。
| 检查项 | 要求与确认方法 |
|---|---|
| 系统与架构 | 面向 64 位 Windows 10/11 的 x64 安装入口。在「设置 → 系统 → 关于」确认系统类型和处理器;ARM 设备不等同于 x64 设备。 |
| 运行环境 | 如启动时提示缺少 .NET,请按提示确认所需主版本和架构;WPF 所需的是桌面运行时,而非仅安装基础运行时。 |
| 目录权限 | 解压目录应可写;安装到受管理的目录或启用虚拟网卡时,按系统权限提示处理。 |
打开苹果菜单中的「关于本机」。如果显示 Apple 芯片,选择 Apple Silicon 包;如果显示 Intel 处理器,选择 Intel 包。不要仅凭设备外观、购入时间或系统版本猜测架构。
打开 DMG 后,将应用复制到「应用程序」再启动,不要把挂载的磁盘映像当成长期运行目录。如果系统阻止启动,先区分是系统版本不兼容、应用架构不匹配,还是安全策略阻止打开。使用受管理设备时,应遵循组织的安装策略。
| 检查项 | 要求与确认方法 |
|---|---|
| 芯片 | Apple Silicon 对应 arm64;Intel 对应 x64。 |
| 系统版本 | 将「关于本机」显示的 macOS 版本与当前发行包的最低要求核对;芯片匹配不代表旧版系统一定可以运行。 |
| 安装与权限 | 需要能将应用复制到目标目录。修改代理设置或启用网络功能时,按实际出现的系统提示授权。 |
已有 VLESS + REALITY 配置时,先从这个 Xray 客户端开始。2015 年以后推出的主流手机通常可优先选 arm64,但最终以 Android 系统支持的 ABI 为准;部分设备的处理器支持 64 位,实际系统却只运行 32 位应用。
适合明确要求 V2Fly 内核的配置。迁移之前,逐项核对协议、传输方式和安全层字段。订阅成功导入只代表客户端能解析条目,不代表每条配置都能由该内核运行。
| 检查项 | 要求与确认方法 |
|---|---|
| 应用架构 | 确认系统支持 arm64-v8a 再选 arm64。无法确认时可先试通用包;通用包仍受包内架构范围限制。 |
| 系统版本 | 以具体 APK 的最低系统要求为准。旧设备出现不兼容提示时,先查 Android 版本,再检查架构和安装记录。 |
| 安装权限 | 从浏览器或文件管理器打开 APK 时,系统可能要求授权该来源安装应用。授权对象是打开文件的应用。 |
| 网络权限 | 首次建立连接时,系统可能显示 VPN 连接请求;当前已有活动 VPN 时,先确认是否需要断开或切换。 |
使用 Debian、Ubuntu 等发行版时,先检查 DEB 入口;使用 RPM 系发行版时,还要核对包的构建目标。本页 RPM 标有 el10,不能只看扩展名就安装到其他发行版或发行版版本。
在系统信息里查看架构,也可用 uname -m 作初步确认。x86_64 对应 DEB 的 amd64,aarch64 对应 DEB 的 arm64。如果使用容器或兼容层,应以实际安装环境的用户空间架构为准,不只看宿主机的处理器型号。
| 检查项 | 要求与确认方法 |
|---|---|
| 包管理格式 | 选择发行版原生支持的 DEB 或 RPM,核对发行版版本和软件源依赖。 |
| 处理器架构 | 分别核对 x86_64/amd64 或 aarch64/arm64,不用文件扩展名判断架构。 |
| 桌面会话 | 此处提供图形客户端。启动后如托盘入口未出现,先确认当前桌面会话是否支持应用托盘。 |
| 安装权限 | 安装系统软件包通常需要管理员授权;日常启动客户端时优先使用普通用户会话。 |
客户端负责显示节点、管理订阅以及控制系统代理,内核负责按协议参数建立连接。更换客户端并不会改变服务器已经采用的协议。同一条配置能显示在列表里,却可能包含当前内核不支持的安全层或流控字段。首次安装时,先从配置提供方确认协议类型,再按设备选择安装包;从旧客户端迁移时,另外记下工作正常的那条配置所用的传输协议与安全层。需要比较字段时,可查阅协议手册。
有正在使用的配置时,先记录客户端名称、当前版本和代理模式,再备份节点、订阅与自定义路由。订阅通常能重新拉取服务端条目,但手动添加的节点、节点备注和规则顺序不一定随订阅恢复。备份应保存在应用数据目录之外;在 Android 上,卸载可能同时删除本地数据。订阅地址和节点配置可能带有访问凭据,备份应留在自己能够控制的位置,不要把完整链接或配置截图发到公开讨论区。
新装时按平台表选择安装包即可。覆盖升级时,应先退出旧客户端,记下原安装来源,不要为了消除安装提示就直接移除旧版本。换客户端时,不要假定两个应用的数据库格式或规则语法相同;先用应用支持的导出格式迁移,再核对导入后是否保留了传输层字段和路由规则。若打算暂时保留两个客户端做对照,测试时只启动一个,避免同时占用本地监听端口或争用系统代理。
文件还没打开就收到格式错误,先检查是否进入了正确的平台标签。安装程序拒绝运行,则优先核对系统版本、CPU 架构和安装权限;Linux 还要看包管理器指出的具体依赖。安装完成却启动失败,需要看首条运行时错误,而不是先换节点。能打开界面但无法使用配置时,再检查节点参数、所选内核、系统代理或 VPN 的状态。把安装问题和连接问题分开,可以保留每次尝试前后的可比性。
启动客户端后,先导入一条参数明确的配置,确认选中的节点和本地监听状态,再选择与当前应用匹配的接入方式。桌面端使用系统代理时,先用一个遵循系统代理设置的应用验证;Android 端则查看系统是否接受了 VPN 连接请求。确认基本连接后,再逐项增加分流规则、调整 DNS 或启用 TUN。若同时改变多个设置,连接异常时很难判断是哪一项影响了访问。
新装可先选 Desktop,使用新一代跨平台界面;习惯经典界面或正在维护既有 WPF 配置时,可以继续选 WPF。两者都是 Windows x64 包,换版前先备份配置。
按「关于本机」显示的信息选择:标为 Apple 芯片就选 arm64,标为 Intel 处理器就选 x64。即使系统能通过转译运行部分 Intel 应用,也优先选匹配本机芯片的包。
通用包主要解决处理器架构选择问题。已有安装的应用签名不同、目标版本低于已装版本,或系统版本不符合要求时,换通用包也不能解决。需要卸载时,先导出配置再操作。
架构匹配只说明二进制对应处理器类型。还要核对发行版、发行版版本和软件源能提供的依赖;例如本页 RPM 文件带有 el10 标识,不能据此认为它适用于所有 RPM 系统。
卡片显示应用级版本,安装入口对应具体文件,两者可能因清单更新节奏而不同。需要确认实际安装版本时,以安装完成后客户端的关于页面为准;已有配置时,升级前先备份。