OpenWrt 25.12稳定版官方正式发布

大家要注意，OpenWrt官方正式发布的版本才是稳定版本，而有些粉丝朋友自行编译的rc版本或者第三方自定义的版本都是非稳定版本，特别在国内，用非稳定版本的非常多，很多固件发布者直接用master分支编译固件发布，这样导致有些用户说OpenWrt系统不稳定，我建议大家用稳定版本分支的固件，即使是自编译加入插件，也要基于稳定分支，不要直接用master分支。

对于FanchmWrt，近期也我也会基于OpenWrt 25.12稳定版本编译发布固件，这样也会支持到更多型号的设备。

固件发布地址：www.fanchmwrt.com

下面我们来看看OpenWrt 25版本更新概要：

一、版本命名：「Dave's Guitar」——致敬一位网络先驱

OpenWrt 25.12 的代号是 「Dave's Guitar」，用以纪念于 2025 年 4 月 1 日离世的 Dave Täht。

Dave 在降低网络（bufferbloat）、改善 OpenWrt 及整个互联网的延迟与响应性方面做出了重要贡献，让无数用户的网络更快、更稳。本版本献给他的记忆与对网络社区的持久影响。

二、包管理器：从 opkg 切换到 apk

这是 25.12 中最显眼的一步变化：OpenWrt 已从传统的 opkg 全面过渡到 apk（Alpine Package Keeper）。

• 原因：OpenWrt 维护的 opkg 分支已长期缺乏维护，而 apk 仍在积极维护。
• 体验：apk 支持 opkg 的大部分能力，仅极少数包名有变动；主要差异在于命令行参数不同。
• 迁移：官方提供了 opkg 到 apk 速查表，方便老用户对照常用操作，平滑过渡。

习惯用 opkg update、opkg install 的朋友，升级后可以按速查表改用 apk 的等价命令。

三、Attended Sysupgrade

Attended Sysupgrade 的 LuCI 应用在本版本中默认安装，大容量闪存设备还会默认带上命令行工具 owut。

ASU 能做什么？

• 升级到新版 OpenWrt 固件
• 自动根据当前已安装的软件包，在服务器端为你重新构建定制固件
• 升级过程中保留系统配置
• 将额外安装的包直接写入 SquashFS，比 overlay 更省空间、更高效

也就是说：在 LuCI 里点几下、等一会儿，就能得到一份「带齐你所有软件和配置」的新版固件并完成升级，无需再手动记包名、手动重装。对爱折腾插件和主题的用户来说，这是实实在在的体验提升。

四、Shell 历史保留

Shell 命令历史现在保存在 RAM 文件系统中，实现：

• 会话间保留：重新登录后仍能看到之前的命令历史
• 默认不写闪存：避免为历史记录增加不必要的闪存写入，有利于延长寿命

若你希望历史持久化到闪存，可自行编辑 /etc/profile.d/busybox-history-file.sh 修改行为；官方提醒：写入闪存会增加擦写次数，可能影响闪存寿命，需自行权衡。

五、Wi-Fi 脚本用 ucode 重写，视频源默认集成

• Wi-Fi / 网络脚本：已用 ucode（一种 ECMAScript 风格语言，逐步替代 OpenWrt 中的 Lua）重写。ucode 比 shell 更快、更安全，并与 ubus、UCI 直接集成，有利于减少错误、便于后续维护。
• 视频源：带 Qt5 与 UI 应用的 OpenWrt video feed 已默认集成，对做多媒体、监控类应用的朋友更友好。

六、核心组件版本一览

更多应用也有同步更新，详见官方 changelog。

七、设备与目标：超过 2200 台设备，新增 180+ 机型

• OpenWrt 25.12 支持超过 2200 台设备，在 24.10 基础上新增超过 180 台。
• 硬件需求未发生大变化，绝大多数 24.10 已支持的设备在 25.12 中继续支持。

目标层面部分变化包括：

• realtek：扩展更多交换芯片支持（含 10G 以太网交换机）
• qualcommax：增加 ipq50xx、ipq60xx 等 SoC 支持
• siflower：新增 Siflower SF21A6826/SF21H8898 目标
• sunxi：新增 arm926ejs 子目标（Allwinner F1C100/200s）
• microchipsw：新增 lan969x（Microchip LAN969x 交换机）目标

覆盖从家用路由到企业交换、开发板等多种场景。

八、如何升级到 25.12

• 从 24.10 升级：在大多数设备上可以保留配置升级，大部分配置会保持不变或在首次启动时由包初始化脚本正确迁移。
• 从 23.05 直接升到 25.12：官方不提供正式支持，建议先备份，必要时参考文档做全新安装或经 24.10 过渡。

推荐方式：

1. LuCI Attended Sysupgrade：在网页里选择目标版本（如 25.12），由 ASU 自动收集已装包、生成镜像并下载安装。
2. Firmware Selector：在 Firmware Selector 选择设备与版本，可手动指定包列表生成定制镜像，再在「备份/刷写固件」中刷入（若需保留配置请勾选「保留设置」）。
3. 命令行 owut：执行 owut check --verbose --version-to 25.12 查看升级影响，确认无误后再 owut upgrade --verbose --version-to 25.12。

若当前系统没有 ASU 或 owut，在 24.10 上仍可用 opkg 安装：

opkg updateopkg install luci-app-attendedsysupgrade# 或opkg install owut

注意：Bananapi BPI-R4 的接口名有变更（如 eth1→sfp-lan/lan4，eth2→sfp-wan），升级时需不保留配置升级。

九、已知问题（升级前建议了解）

• Zyxel EX5601-T0：WAN 口由 eth1 更名为 wan，升级后需检查 WAN 配置。
• Pixel 10 手机：连接 WPA3 + WiFi 6 AP 时可能出现问题（见 issue ）。
• 802.11r 快速漫游：在启用 WPA3 时，部分 WiFi 客户端可能出现兼容性问题（见 issue ）。

更多回归与已知问题见官方说明：notes-25.12.0 - Known issues。

十、OpenWrt 24.10 支持周期

随着 25.12 稳定版发布，OpenWrt 24.10 将在 6 个月后停止维护（约 2026 年 9 月起不再提供安全更新）。建议在 2026 年 9 月前规划升级到 25.12。

十一、下载与文档

• 固件选择器：https://firmware-selector.openwrt.org?version=25.12.0
• 直接下载目录：https://downloads.openwrt.org/releases/25.12.0/targets/
• 发布说明与升级指南：https://openwrt.org/releases/25.12/notes-25.12.0
• 完整更新日志：https://openwrt.org/releases/25.12/changelog-25.12.0

发布概要根据OpenWrt官方发布的信息通过AI整理，具体请查看OpenWrt官方发布的文档。