v2rayN
首推 7.24.1桌面版采用新一代跨平台界面,适合首次安装或需要在不同桌面系统间保持操作一致的用户。经典 WPF 版保留熟悉的 Windows 布局,适合继续沿用原来的界面和操作习惯。两者是可单独使用的发行包,选一个即可。
两个入口外层都是 ZIP。先完整解压到可写目录,再按包内文件运行安装程序。不要在压缩包预览窗口里直接双击。如果从旧版迁移,先退出托盘里的旧客户端,再安装和测试,避免两个实例同时占用本地端口。
安装包索引GUI
桌面选 v2rayN,安卓按配置选 v2rayNG 或 v2flyNG。先匹配系统,再核对架构和包格式。
选项卡按安装目标切换。替另一台设备下载时,以那台设备的系统信息为准。
桌面版采用新一代跨平台界面,适合首次安装或需要在不同桌面系统间保持操作一致的用户。经典 WPF 版保留熟悉的 Windows 布局,适合继续沿用原来的界面和操作习惯。两者是可单独使用的发行包,选一个即可。
两个入口外层都是 ZIP。先完整解压到可写目录,再按包内文件运行安装程序。不要在压缩包预览窗口里直接双击。如果从旧版迁移,先退出托盘里的旧客户端,再安装和测试,避免两个实例同时占用本地端口。
| 检查项 | 适用条件 |
|---|---|
| 系统与架构 | 建议使用仍受支持的 64 位 Windows 10 或 11 环境;本页两包均为 x64。 |
| 识别方式 | 查看「设置 → 系统 → 关于」的系统类型,确认处理器架构和系统位数。 |
| 运行环境 | 若出现运行库提示,按提示核对所需组件、版本和位数。 |
安装程序能打开,不代表客户端已经启动。首次运行时检查托盘和主窗口,确认可以进入设置后再导入配置。
打开苹果菜单中的「关于本机」。显示 Apple M 系列芯片时选 Apple Silicon;显示 Intel 处理器时选 Intel。文件名里的 64 对应此处的 Intel 包,不能只凭「都是 64 位」判断兼容性。
打开磁盘映像后,将应用复制到「应用程序」,再从那里启动。若从旧电脑迁移过应用,先检查是否仍在打开旧副本。出现系统安全提示时,记录系统给出的具体原因,并遵循本机或组织的安装策略。
| 检查项 | 适用条件 |
|---|---|
| 芯片 | Apple Silicon 用 arm64;Intel 用 x64。 |
| 系统版本 | 旧版 macOS 需核对所选发行包支持的最低版本。 |
| 安装格式 | DMG 磁盘映像;应用复制完成后可推出映像。 |
若提示应用无法在当前系统运行,先核对芯片与系统版本。反复打开同一个不匹配的包不会改变兼容性。
采用 Xray 内核。2015 年后的主流手机通常可选 arm64,前提是系统支持 arm64-v8a。只知道处理器是 64 位、却不知道系统支持哪种应用架构时,可先核对设备资料,或选择通用版。
卡片徽章显示应用清单版本,下载入口对应单独的文件记录。需要指定版本进行覆盖安装时,先核对所选入口的文件名,尤其不要把徽章当成安装包版本。
采用 V2Fly 内核,适合明确要求该内核的配置。它不是 v2rayNG 的升级包。更换客户端前,先确认原有协议和传输设置可用;迁移后先用一条已知可用的配置做连接测试,再导入其余条目。
| 检查项 | 适用条件 |
|---|---|
| 应用架构 | arm64 包要求系统支持 arm64-v8a;通用包包含多种架构。 |
| 系统版本 | 旧设备须核对所选应用包的最低系统要求。 |
| 覆盖安装 | 安装器还会检查应用标识、签名和版本,通用包不改变这些条件。 |
使用受管理的设备时,先确认设备策略允许安装。若安装器提示与现有软件包冲突,先查原安装渠道,不要反复改选架构。
arm64: 下载 deb · arm64 下载 rpm · arm64
Debian、Ubuntu 系发行版先看 deb。使用 RPM 的发行版先看 rpm,但文件名中的 el10 标识了打包目标,不代表所有能读 RPM 的系统都能安装。以包管理器给出的依赖和冲突结果为准。
在虚拟机里安装时,查看来宾系统报告的架构,不要直接照用宿主机的架构。包已装好但点不开时,再确认当前会话具备图形桌面环境;这类包的安装成功与窗口能启动是两件事。
| 检查项 | 适用条件 |
|---|---|
| 包格式 | 发行版需支持对应的 deb 或 rpm 格式及该包声明的依赖。 |
| 架构 | x86_64 对应 x64;aarch64 对应 arm64;deb 文件名中的 amd64 也是 x64。 |
| 桌面环境 | 需要能运行图形客户端的桌面会话。 |
遇到未满足的依赖,先记下依赖名和版本范围,再核对发行版及软件源。不要把强制安装当成兼容性修复。
先确定故障发生在哪一步:下载、安装、启动,还是连接。前一步已经通过,就在下一步查,不要把所有异常都归到安装包。
给自己或同事装机时,先记下目标设备的系统版本、架构和所选文件名。用同一台电脑给多台设备准备安装包,很容易从下载记录里点错架构相近的文件。把文件名与目标设备一一对应,尤其要区分桌面版与经典版、芯片架构,以及同一客户端的两个移动包。
新装只需准备安装包和自己的配置来源。升级则要先打开旧客户端,记下版本、界面版本、安装渠道及自定义数据位置。分开记录订阅、手工节点、路由和本地端口。只记住订阅地址,通常不足以复原整套设置。配置和导出文件可能含敏感信息,应留在自己可控的位置,不要附在公开的排障截图中。
如果电脑由组织集中管理,先弄清账号是否有安装权限、应用应该装在哪个目录,以及代理设置是否由组织统一下发。权限不足时重复解压或更换同架构的包,通常不能解除安装限制。把完整报错交给设备管理员,比在不同目录里反复尝试更容易定位问题。
安装器提示应用与设备不兼容时,先回到系统信息复核架构。架构正确但仍提示不支持,再查系统版本或包所需的运行组件。软件包管理器若明确列出依赖及版本范围,就以这条信息为线索,而不是笼统地把问题归为「系统太旧」。
如果下载完成后压缩工具报告无法打开,先确认浏览器下载任务已经结束,并核对打开的是本次下载的文件,而不是同名旧副本或未下载完的临时文件。外层归档应先完整解压;磁盘映像应先打开再复制应用;软件包应交给系统安装器。文件扩展名不能靠手动改名来转换格式。
同一应用覆盖失败,先比较新旧安装渠道和版本。报错指向签名冲突时,换成通用包也无济于事;报错指向版本回退时,检查是否误点了较早的包。涉及卸载时,先确认数据已导出且有办法恢复。卸载应用可能同时删除本地数据,不宜拿它作为第一步测试。
安装后从本次安装位置打开客户端,确认能进入主界面并查看版本信息。桌面窗口关闭后,程序可能仍驻留在托盘或菜单栏;再次打开前先检查是否已有实例。若程序一开就退出,记录报错以及退出前执行的操作,不要先把旧配置全部导入再排查。
界面可用后,按订阅导入步骤添加配置。先选择一条已知可用的配置,确认客户端能够启动连接。能看到配置列表只说明导入成功,不能证明网络流量已按预期经过代理。连接无法启动时先看客户端日志;能启动却打不开网页,再对照无法上网排查。
如果只有个别应用表现不同,先记录哪些应用受影响,以及是否开启了系统代理。部分应用有自己的代理设置,不一定读取系统选项。保持其他条件不变,用同一应用对比连接前后的结果,再查路由分流。在连接层和路由层同时改设置,会让结果难以解释。
有备份功能时优先使用客户端提供的备份或导出入口。把生成的文件存到程序目录之外,记下创建时使用的版本、包含哪些配置,以及哪些设置需要手工重建。跨客户端迁移时,不要把整份应用数据直接覆盖到新客户端目录;不同客户端的备份结构与字段未必相同。
切换前退出旧程序,停用由它设置的系统代理,再启动新版。恢复后先检查配置是否完整、原来的自定义端口是否保留、开机启动项是否仍指向旧位置。测试通过前不要立即清理旧目录。若两套程序必须暂时保留,也不要同时启动并让它们写入同一份配置。
回退时,优先用与旧版本匹配的备份。新版写过的数据未必能被旧版读回。回退完成后先恢复一条配置测试,再恢复分组与自定义路由。如果旧版和新版在同一网络都出现相同症状,继续反复换包的价值不高,应转到连接、订阅或系统代理的对应章节查原因。
首次安装可先选桌面版。已有经典 WPF 版且希望沿用原有界面和操作习惯,可以继续选 WPF 版。两个入口都对应 x64 包,先在系统信息里核对系统类型。
打开苹果菜单里的「关于本机」。「芯片」显示 Apple M 系列时选 Apple Silicon;「处理器」显示 Intel 时选 Intel。换机器后重新核对,不要照抄旧机器的下载记录。
不能。通用包用于覆盖多种处理器架构,签名冲突属于覆盖安装条件不满足。优先沿用原安装渠道;必须迁移时,先确认配置可恢复,再卸载旧应用并重装。
两项都要匹配。先按发行版选择 deb 或 rpm,再按当前系统的 x86_64 或 arm64 架构选择对应入口。能识别文件格式不代表依赖一定满足,还需核对发行版版本。
需要。订阅可以重新拉取的条目,不等于手工节点、分组和路由设置也能恢复。升级前先使用客户端提供的备份或导出功能,并把备份保存在旧程序目录之外。
卡片版本取自清单的应用版本字段,安装包名称来自各入口的文件记录,两者可能暂时不同。需要指定版本时,先核对入口对应的文件名;若文件名无法确认版本或两处信息不一致,不要据此做覆盖升级。