24.10 → 25.12 升级准备状态
这是准备清单，不是实时设备检测结果。
- 设备支持 准确型号、硬件版本和 25.12 target 已确认 必须确认
- 配置与包记录 离线备份、关键包、VPN 与网络改动已记录 可准备
- 迁移警告 是否清除配置、接口改名或特殊 installer 已核对 需确认
- 盲目 apk upgrade 不能替代完整 OpenWrt firmware sysupgrade 不要执行
绿色表示可以在 Mac 侧提前准备；橙色或红色项目需要先核对。
OPENWRT 24.10 → 25.12 · 升级规划
OpenWrt 24.10 EOL 升级 25.12 恢复检查清单
OpenWrt 24.10 安全更新计划在 2026 年 9 月后结束。升级 25.12 前，先确认准确设备支持、把备份保存到路由器之外、阅读迁移警告，并记录设备真正的恢复方式。
这是刷写前的迁移与恢复规划，不是版本新闻页。多数设备可以从 24.10 升级到 25.12，但准确设备说明和配置迁移警告优先。
升级前建立可回退证据
先确认支持、备份、迁移警告和恢复入口
不要把包管理器升级当成固件升级，也不要把“多数设备支持迁移”理解为所有型号都能保留配置。
快速答案
用完整固件升级路径，不用包管理器拼接系统升级
- 下载固件前确认准确型号、硬件版本、target 和 25.12 支持状态。
- 把配置备份保存到路由器之外，并记录软件包、feeds、VPN、防火墙、VLAN 和自定义网络设置。
- 使用 sysupgrade、Attended Sysupgrade 或 owut 完成官方整机固件升级，不要盲目 apk upgrade。
- 保留配置前阅读设备专用 clean upgrade、接口、布局和 installer 警告。
- 刷写前记录管理 IP 和设备文档规定的真实恢复方式。
跨版本升级流程
按 Support、Backup、Validate、Recover 准备
升级工具负责正常迁移；Router Recovery 只在刷写失败且设备明确支持 TFTP 时帮助准备 Mac 侧环境。
-
步骤 1
Support
在 Firmware Selector、设备页与 25.12 release notes 中确认准确型号支持和特殊迁移说明。
-
步骤 2
Backup
保存离线配置备份，并记录关键包、feeds、VPN、防火墙、VLAN 与手动网络设置。
-
步骤 3
Validate
使用官方 sysupgrade、Attended Sysupgrade 或 owut 检查完整镜像与警告，不盲目跳过验证。
-
步骤 4
Recover
提前写下管理 IP 和设备恢复方式；失败后先区分 LuCI、SSH、failsafe 与 bootloader recovery。
先看懂这些词
恢复过程中会遇到的基础概念
Sysupgrade
OpenWrt 为受支持设备与镜像提供的完整固件升级机制。
Attended Sysupgrade
结合所选软件包请求完整固件镜像的 Web 升级流程。
owut
用于检查并请求完整 OpenWrt 镜像的命令行升级工具。
Clean upgrade
设备或迁移路径要求重新配置时，不保留旧配置完成安装。
稳定迁移清单
把版本变化转成设备级检查，而不是追逐版本号
把 EOL 日期当成规划期限，不是恐慌信号
OpenWrt 说明 24.10 安全更新将在 2026 年 9 月后停止，并建议此前迁移到 25.12。应在路由器健康时规划迁移，不要等到故障时仓促升级。
确认 25.12 支持准确设备
多数 24.10 支持的设备可以迁移到 25.12，但仍有型号例外。核对型号、硬件版本、target、profile、镜像类型，以及特殊 installer 或分区迁移要求。
备份范围不要只包含配置压缩包
把官方配置备份下载到其它设备，同时记录关键软件包、自定义 feeds、VPN 和防火墙规则、VLAN、接口名称，以及 clean rebuild 时需要恢复的启动或网络改动。
使用固件升级工具，不用 apk upgrade 代替
包管理器更新不能把内核、基础镜像和 target 专用固件作为一个完整测试单元替换。应使用官方 sysupgrade、Attended Sysupgrade、Firmware Selector 或 owut，并阅读所有软件包与验证警告。
设备说明要求清除配置时不要强行保留
很多设备可以正常迁移配置，但部分设备需要 clean upgrade、接口改名、布局迁移或特殊 installer。如果当前设备说明要求不保留设置，应依据事先记录重新配置。
准备恢复方式，但不要默认就是 TFTP
升级失败后先区分 LuCI 缺失、SSH 丢失、failsafe 与设备无法启动。只有准确 bootloader 资料明确恢复方式及其 IP、传输方向、固件和文件名时，才使用 Web Recovery、厂商工具或 TFTP。
最终检查
开始 24.10 → 25.12 升级前
- 准确设备与硬件版本在 25.12 中受支持
- 已选择官方、匹配 target/profile 的 sysupgrade 镜像
- 配置备份已下载到路由器之外
- 关键包、自定义 feeds 与网络设置已有记录
- 设备专用 clean upgrade 或迁移警告已阅读
- Image check failed 不会被未经说明的 force 参数绕过
失败后的 MACOS 恢复准备
升级前记录恢复方式，失败后不要盲目换固件
如果准确设备确实通过 TFTP recovery，Router Recovery 可以帮助检查临时 IP、网线、固件文件和本地 TFTP 等待状态。
FAQ
OpenWrt 24.10 升级 25.12 常见问题
应该从 OpenWrt 24.10 迁移到 25.12 吗？
OpenWrt 建议在 2026 年 9 月后停止 24.10 安全更新之前迁移。操作前必须确认准确设备支持和特殊迁移说明。
可以用 apk upgrade 把整台路由器升级到 25.12 吗？
不可以。应使用受支持的 OpenWrt 完整固件升级工具。为单个软件包使用 apk add 与替换固件版本是两种不同操作。
升级时可以保留配置吗？
很多情况下可以，但不是所有设备都可以。准确设备与 release notes 可能要求 clean upgrade、接口调整或特殊迁移。
Router Recovery 能完成 OpenWrt 升级吗？
不能。正常升级使用 OpenWrt 官方工具；只有刷写失败后准确设备需要 TFTP 时，Router Recovery 才帮助准备 Mac 侧恢复环境。
下一步