截至 2026 年 11 月，OpenWrt 官方下载站的稳定版本为 25.12.6。如果你的设备还运行 24.10，可以开始规划升级；但刷机文件和升级方式必须按设备型号选择，不能把一台设备的步骤直接套到另一台设备上。

本文只讨论官方 OpenWrt 从 24.10 升级到 25.12 的一般流程。iStoreOS、ImmortalWrt、厂商定制固件和个人编译固件有各自的升级规则，请以对应项目和设备页面的说明为准。

先确认设备和固件来源

升级前先在路由器管理页面或 SSH 中确认设备型号、当前版本和目标平台。前往 OpenWrt Firmware Selector 搜索准确的设备型号，确认目标版本确实提供该设备的固件。

已有 OpenWrt 系统升级时，通常应下载设备对应的 sysupgrade 镜像；从原厂固件首次刷入 OpenWrt 时才使用设备说明指定的初次安装镜像。不同设备的文件扩展名和刷写方式可能不同，不要只凭文件名猜测，也不要使用其他型号的镜像。

如果 Firmware Selector 找不到你的准确型号，或设备运行的是第三方分支固件，请先查该设备或固件项目的升级说明，不要直接套用本文步骤。

升级前做好备份

  1. 在 LuCI 的「系统 → 备份 / 升级」中下载一份配置备份，并确认能够找到本地文件。
  2. 记录手动安装的软件包、插件来源和自定义脚本。固件升级会替换系统分区，手动安装的软件包通常需要重新安装；没有纳入备份清单的自定义文件也可能消失。
  3. 记录网络、无线和代理等关键设置。升级后如果配置不能自动迁移，这些记录能帮助你恢复网络。
  4. 如果路由器在远程地点，先安排现场协助和备用联网方式。升级期间不要依赖正在刷写的这台路由器远程操作。

配置备份主要用于恢复设置，不等于固件镜像，也不能保证所有第三方插件的数据都能原样迁移。OpenWrt 官方建议升级前确认需要保存的配置文件和额外数据。

从 24.10 升到 25.12 时，是否保留配置？

OpenWrt 25.12 的官方升级说明表示，24.10 升级到 25.12 在大多数设备上可以迁移配置，但具体结果取决于设备、分区布局和安装的软件包。升级前应查看 25.12 对应设备的说明以及版本说明中的已知问题。

不要把“保留设置”当作所有设备都适用的固定选项：

  • 如果设备说明确认支持保留配置，并且你从官方 24.10 升级到官方 25.12，可按设备说明操作。
  • 如果版本说明要求清除配置、设备更换了分区布局，或你从第三方固件切换到官方固件，应按对应说明执行，必要时全新安装。
  • 从 OpenWrt 23.05 或更早版本直接升级到 25.12，官方不支持这种跨版本 sysupgrade。先查官方升级路径，不要跳过版本要求。

不确定时，先完成备份，再查设备专属说明；不要为了保留配置而忽略升级程序或版本说明中的警告。

通过 LuCI 执行升级

确认固件和设备匹配、备份已保存后：

  1. 使用网线连接路由器，避免刷写期间无线中断影响操作。
  2. 打开 LuCI 的「系统 → 备份 / 升级」，选择该设备对应的 25.12 sysupgrade 镜像。
  3. 让固件校验完成，并阅读页面显示的设备兼容性和配置保留提示。
  4. 根据设备专属说明决定是否保留配置，然后开始刷写。刷写期间不要断电、拔线或重复提交升级。
  5. 等设备重新启动后重新登录管理页面，检查版本、WAN/LAN、无线网络和实际使用的服务。

如果升级页面提示镜像不兼容，或你不能确认固件对应的设备型号，先停止操作，重新确认 Firmware Selector 中的设备信息。不要通过强制刷写绕过兼容性检查。

25.12 的软件包命令改为 apk

OpenWrt 25.12 将软件包管理器从 opkg 切换为 Alpine Package Keeper（apk）。因此，旧教程里的 opkg 命令不能原样用于 25.12：

操作 OpenWrt 24.10 及更早 OpenWrt 25.12 及更新
更新软件包列表 opkg update apk update
安装软件包 opkg install 软件包名 apk add 软件包名
删除软件包 opkg remove 软件包名 apk del 软件包名
查看已安装软件包 opkg list-installed apk list -I

第三方插件还需要确认它的仓库是否提供与你的 OpenWrt 版本、设备架构和内核匹配的包。尤其是内核模块，不要从其他版本或其他固件分支的仓库混装。遇到软件包不存在时，先检查软件源和插件兼容性，不要随意替换仓库地址。

升级后检查清单

  • 管理页面显示的版本为目标版本。
  • 有线网络、无线网络和 DNS 解析正常。
  • 防火墙、DHCP、旁路由或代理等你实际依赖的功能正常。
  • 重新安装必要的软件包，并检查旧插件是否支持 25.12。
  • 自定义脚本和非标准目录中的文件已恢复。
  • 保留升级前的配置备份和旧固件信息，确认设备稳定后再清理。

如果升级后无法联网，先通过有线连接进入管理页面，检查接口状态和系统日志；如果设备无法启动或无法进入管理页面，应查该型号的官方恢复方式。不同设备的恢复入口差异很大，不建议照搬其他型号的按键或刷写命令。

参考资料

固件版本、设备支持状态和升级限制可能变化。刷写前请以设备页面和当前版本发布说明为准。