OpenWrt 升级恢复准备

OpenWrt 24.10 EOL 到 25.12 升级恢复清单

OpenWrt 24.10 已进入 security maintenance,并预计在 2026 年 9 月结束支持。升级到 25.12 前,先准备好失败后的恢复路径:如果路由器无法启动、LuCI 不回来,或固件选错,至少知道下一步该检查什么。

为什么这次升级值得提前准备恢复路径

  • OpenWrt 24.10.7 是安全维护版本,修复了 dnsmasq、Linux kernel 和加密库等问题。
  • 24.10 系列处于 security maintenance,预计 2026 年 9 月 EOL。
  • OpenWrt 25.12 将包管理从 opkg 转向 apk,并默认集成 Attended Sysupgrade。
  • 多数 24.10 已支持设备在 25.12 中仍被支持,但具体设备升级说明仍然重要。

信息来源:OpenWrt v24.10.7 release notesOpenWrt v25.12.0 release notesOpenWrt Firmware Selector

先安全升级,再考虑恢复

Step 1

确认设备支持和镜像类型

用 OpenWrt Firmware Selector 或官方设备页确认准确型号和硬件版本。不要默认 sysupgrade、factory、recovery 镜像可以互换。

Step 2

备份配置并记录包和网络改动

升级前下载配置备份。由于 25.12 改变了包管理模型,也建议记录重要包、自定义 feeds、VPN、防火墙、VLAN 和手动网络设置。

Step 3

阅读 target 或设备特殊警告

有些设备需要全新安装、分区布局调整或特殊迁移步骤。如果 release notes 或设备页要求不要保留配置,不要为了省时间强行保留。

如果 25.12 升级失败

Check 1

不要继续乱刷文件

失败后先停下来,确认准确型号的恢复方式:TFTP Server、Web Recovery、厂商工具、failsafe、TTL 串口,还是其它 bootloader 路径。

Check 2

准备 Mac TFTP Server 环境

如果型号使用 TFTP 恢复,用网线直连,按型号要求设置 Mac 临时静态 IP,把正确固件放到 App 服务的文件夹,并在进入恢复模式前确认文件名。

Check 3

需要时选择 recovery 或 factory 固件

sysupgrade 文件通常用于已经能运行 OpenWrt 的系统。bootloader 恢复往往需要 factory 或 recovery 镜像。以设备页和 Firmware Selector 输出为准。

Check 4

观察路由器是否发起请求

在路由器进入短暂恢复窗口前启动 Router Recovery。App 帮助准备和检查 macOS 侧 TFTP Server 路径;是否请求和接受固件仍由路由器决定。

OpenWrt 24.10 到 25.12 恢复清单

已确认准确型号和硬件版本
已从官方来源选择 OpenWrt 25.12 镜像
升级前已保存配置备份
已记录包列表和自定义网络设置
已写下恢复 IP 和 Mac 静态 IP
已准备 TFTP Server 文件夹和固件文件名
边界说明:Router Recovery 不保证 25.12 升级成功,也不替代 OpenWrt 官方升级工具。它用于在升级失败后,帮助准备和检查 Mac 侧 TFTP 恢复环境。

检查 Mac 上的 OpenWrt 恢复设置

FAQ

现在应该从 OpenWrt 24.10 升级到 25.12 吗?

OpenWrt 官方建议在 24.10 EOL 前迁移。请先确认具体设备支持,再选择官方 25.12 镜像和升级路径。

opkg 到 apk 会直接导致救砖吗?

包管理变化本身不是 TFTP 恢复机制,但它让升级前的包列表、配置备份和重建计划更重要。

Router Recovery 能替我升级 OpenWrt 吗?

不能。正常升级请使用 OpenWrt 官方升级工具。Router Recovery 更适合在刷机失败或 bootloader 恢复场景中,准备和检查 Mac 侧 TFTP 恢复路径。