v2rayN 首推
桌面版采用新一代跨平台界面;WPF 是经典稳定版,保留熟悉的 Windows 界面与操作布局。两种入口选一个即可。
安装包与系统要求
先选操作系统,再核对处理器架构。桌面使用 v2rayN,安卓优先选择 v2rayNG;已有 v2fly 内核配置时,可考虑 v2flyNG。
桌面版采用新一代跨平台界面;WPF 是经典稳定版,保留熟悉的 Windows 界面与操作布局。两种入口选一个即可。
| 检查项 | 选择依据 |
|---|---|
| 系统类型 | 在「设置 → 系统 → 关于」核对系统类型。本页提供 x64 安装包。 |
| 运行环境 | 若启动提示缺少 .NET 桌面运行库,按提示核对所需版本与架构。 |
| 安装权限 | 解压后再运行安装程序。受管理设备需要遵循组织的软件安装策略。 |
不要直接从压缩包预览窗口运行程序。先解压到有写入权限的目录,再启动安装程序;这样也便于在出错时区分解压问题、运行库缺失和安装权限不足。
对照桌面版与 WPF 版 →
打开「关于本机」查看芯片或处理器。显示 Apple 芯片时选 arm64;显示 Intel 处理器时选 x64。两者都是磁盘映像安装包。
| 检查项 | 选择依据 |
|---|---|
| 芯片架构 | Apple Silicon 对应 arm64,Intel 对应 x64。 |
| 系统兼容性 | 芯片匹配不等于系统版本匹配;遇到兼容性提示时,核对构建的最低系统要求。 |
| 安装位置 | 挂载 DMG 后将应用复制到「应用程序」,再从该目录打开。 |
更新前先退出正在运行的实例,再替换应用。若系统拦截启动,先读清提示,区分系统版本不兼容、下载未完成与组织安全策略,不要为安装而停用系统保护。
使用 Xray 内核。2015 年后推出的主流手机通常可先选 arm64;若设备只运行 32 位系统或无法确认架构,选通用版。
使用 v2fly 内核。配置说明明确要求该内核时可选这款客户端。迁移前先核对协议和传输设置,不要仅凭订阅能导入就判断配置兼容。
| 检查项 | 选择依据 |
|---|---|
| 应用架构 | 系统支持 arm64-v8a 时选 arm64。手机使用 64 位芯片,不代表系统一定支持 64 位应用。 |
| 安装来源 | 若系统要求授权,仅为当前可信的文件管理器或浏览器临时开启安装权限。 |
| 连接授权 | 系统 VPN 授权在首次建立连接时出现,不属于安装流程。切换客户端前先断开当前连接。 |
Debian、Ubuntu 系通常选 DEB。使用 RPM 的发行版需进一步核对构建目标与依赖;本页 RPM 文件标有 el10。
| 检查项 | 选择依据 |
|---|---|
| 处理器架构 | uname -m 显示 x86_64 时选 x64;显示 aarch64 时选 ARM 64 位包。 |
| 包格式与依赖 | 用发行版的软件包管理器检查依赖。扩展名一致不代表可以跨发行版安装。 |
| 运行环境 | v2rayN 是图形客户端,请在本地图形会话中启动并查看状态。 |
遇到依赖错误时,保留提示中的库名、版本和发行版信息。不要强制安装面向其他发行版构建的包;强行跳过检查也不会补齐程序运行所需的库。
平台、架构和包格式分别决定能不能安装。原有配置能不能继续使用,需要另行确认。
不要只看设备型号或购买年份。台式机和笔记本可以从系统信息中确认架构;安卓设备则要看当前系统支持的应用架构。同一设备更换系统后,能够安装的包也可能变化。代他人下载时,应以目标设备的信息为准,而不是下载文件所用设备的信息。
amd64 和 x86_64 都指常见的 x86 64 位架构,前者不限定处理器品牌。arm64 与 aarch64 则指 ARM 64 位架构。认清这些命名后,再检查页面上所选的平台,避免把架构相同但系统不同的安装包混用。
备份时区分订阅、手动配置和客户端自身的设置。订阅重新导入后通常能恢复由订阅提供的条目,但不会自动找回本地添加的条目、路由规则或监听端口。若旧客户端支持导出,先导出需要保留的信息,并记录当前代理模式和活动配置。
订阅地址可能含有访问凭据,只保存在受控位置,不要连同截图公开发送。若只是换界面或换构建,先停止旧实例,再启动新实例,避免两个客户端占用相同端口或反复修改系统代理。确认基本连接和必要规则都正常后,再处理旧程序和备份。
安装程序不能打开、安装完成后应用退出、应用能打开但不能连接,是三个不同阶段的问题。第一类先看文件是否下载完整、包格式是否匹配,以及系统给出的权限提示。第二类先记录运行库、目录权限或程序启动日志,不必在此时重新导入订阅。
在旧系统上,处理器架构正确也可能遇到系统接口或依赖版本不匹配。把操作系统版本、选择的构建和报错原文放在一起排查,比反复换包更有效。安卓出现「应用未安装」时,还应区分签名不匹配、系统要求不符和存储空间不足。
查看启动闪退排查 →已有可用配置时,先在升级前记录正在使用的客户端、代理模式和本地端口。升级后先用原配置测试。若同时更换内核、订阅和路由,即使发现异常,也难以确定由哪一项变化引起。
需要回到旧客户端时,先确认新版是否改写了配置格式,再考虑使用升级前的备份。不要把新旧程序随意解压进同一个目录。对于由软件包管理器安装的程序,区分卸载程序与删除用户配置,避免清理旧包时误删仍要使用的规则。
先确认应用可启动,再导入配置并验证连接。下载、安装和接管流量是三个独立步骤。
打开客户端后,先为已有订阅建立分组,再执行一次手动更新。看到条目并不代表已经连接:还要选择活动配置,并通过客户端日志确认核心进程启动成功。已有手动配置时,把它和订阅条目分开管理,之后更新订阅不易混淆。
遇到订阅更新失败,先区分地址无法访问和内容无法识别。不需要为了测试而打开多个客户端:同时启用可能改变系统代理或 VPN 状态,反而使错误难以复现。需要求助时,可记录失败阶段和脱敏后的报错,不必提供完整订阅地址。
查看订阅导入步骤 →桌面端可先用遵循系统代理设置的浏览器验证。终端工具和部分桌面应用可能不读取系统代理,需要分别检查它们采用的代理地址。若更新后本地端口改变,曾手动填写代理地址的应用也要同步调整,不能只看客户端窗口中的连接状态。
安卓端在首次连接时留意系统 VPN 授权提示。若设备已有其他 VPN 会话,先明确需要保留哪一项,再切换客户端。只有当应用接管范围确实不够时,再阅读手册中的 TUN 与路由章节;初次验证不必同时改变接管方式和分流规则。
查看路由与分流说明 →安装包选择、覆盖更新与版本识别。
不需要。首次安装可选桌面版;已有经典界面使用习惯时可选 WPF 版。切换前先退出旧客户端并备份配置。
不能。通用版可减少架构选错的情况,但不会改变最低系统要求,也不能解决签名冲突或设备管理策略限制。
先确认是否支持覆盖更新,并备份配置。安卓若提示签名不匹配,不要直接卸载;卸载可能清除应用数据。
安装包提供客户端程序。安装后需要单独导入已有订阅或配置,客户端安装成功不代表代理连接已经建立。
卡片显示应用级版本,下载项对应具体构建。两者不一致时,记录实际文件名,并在安装后通过客户端的关于页面确认运行版本。