发布日期：2026年3月5日

OpenWrt 社区非常自豪地宣布 OpenWrt 25.12.0 稳定版正式发布！这是 OpenWrt 25.12 系列的第一个稳定版本，累计超过 4700 次代码提交，开发周期超过一年。本次更新带来了众多令人兴奋的新特性、平台扩展和核心优化。

📢 本版本命名："Dave's Guitar"——纪念 Dave Täht

OpenWrt 25.12 被命名为 "Dave's Guitar"，以纪念于 2025 年 4 月 1 日不幸离世的 Dave Täht。Dave 在减少缓冲区膨胀（bufferbloat）和改善网络延迟方面做出了卓越贡献，他的工作让全球数百万用户的网络变得更快、响应更灵敏、更可靠。本版本致力于纪念他对网络社区的深远影响。

✨ 核心亮点

1. 包管理器重磅升级：从 opkg 迁移到 apk

这是本次更新最重大的变化之一。OpenWrt 正式从传统的 opkg 包管理器过渡到 Alpine Package Keeper。

为什么选择 apk？

  • 持续维护：OpenWrt 的 opkg 分支已不再维护，而 apk 仍在积极开发中

  • 功能兼容：apk 支持 opkg 的大部分功能，仅有极少数包名发生变化

  • 性能更优：apk 在处理依赖关系和包管理方面更加高效

迁移提示：官方提供了 opkg-to-apk 命令速查表，帮助用户平滑过渡。虽然命令行参数有所不同，但基本工作流程都能找到对应实现。

2. 自动系统升级集成

attended.sysupgrade LuCI 应用现已默认安装，owut 命令行工具也默认包含在闪存较大的设备镜像中。这意味着：

  • 轻松升级到新版本

  • 自动重建包含所有已安装包的固件镜像

  • 升级过程中保留系统配置

  • 包直接集成到 SquashFS 文件系统，存储更高效

只需在 LuCI 中点击几下，等待片刻，即可获得定制固件镜像并完成安装，无需手动干预！

3. Shell 历史记录跨会话保留

命令历史现在存储在基于 RAM 的文件系统中，这意味着：

  • 登录之间不再丢失历史记录

  • 默认不会对闪存进行不必要的写入

  • 如需持久保存，可编辑 /etc/profile.d/busybox-history-file.sh

⚠️ 注意：持久保存到闪存会增加写入次数，可能影响闪存寿命。

4. Wi-Fi 脚本重构：全面采用 ucode

Wi-Fi 管理脚本已用 ucode 完全重写，这是系统脚本从 shell 迁移到 ucode 的重要一步。ucode 的优势：

  • 比 shell 脚本更快、更安全

  • 直接集成 ubus 和 UCI

  • 更少的错误，更易于维护

📱 平台支持扩展

OpenWrt 25.12 现支持超过 2200 种设备，新增 180 多种设备！

新增平台和扩展：

  • realtek：扩展支持 10G 以太网交换机 SoC

  • qualcommax：新增 ipq50xx 和 ipq60xx SoC 支持

  • siflower：新增 Siflower SF21A6826/SF21H8898 SoC 支持

  • sunxi/arm926ejs：新增 Allwinner F1C100/200s SoC 支持

  • microchipsw/lan969x：新增 Microchip LAN969x 交换机支持

🔧 核心组件版本

  • 工具链：

    • musl libc 1.2.5

    • glibc 2.41

    • gcc 14.3.0

    • binutils 2.44

  • Linux 内核：6.12.71（所有平台统一）

  • 主要软件包：

    • cfg80211/mac80211：内核 6.18.7 版本

    • hostapd：2025年8月快照版

    • dnsmasq 2.91

    • dropbear 2025.89

    • busybox 1.37.0

📦 视频源集成

OpenWrt 视频源现已默认集成，包含 Qt5 和 UI 应用程序，为多媒体应用提供更好支持。

⚠️ 升级注意事项

支持的升级路径

  • 24.10 → 25.12：官方支持，配置通常可保留

  • 23.05 → 25.12：不被官方支持

已知变更

  1. Cron 日志级别修复：system.@system[0].cronloglevel 默认值为 7（正常日志），未设置时自动使用默认值

  2. Bananapi BPI-R4 接口重命名：

    • eth1 → sfp-lan 或 lan4

    • eth2 → sfp-wan

    • ⚠️ 必须在不保存配置的情况下升级

已知问题

  • Zyxel EX5601-T0：WAN 接口从 eth1 重命名为 wan

  • Pixel 10 手机：连接 WPA3 保护的 WiFi 6 AP 时存在问题 Issue #21486

  • 802.11r 快速过渡：使用 WPA3 时可能导致部分 WiFi 客户端问题 Issue #22200

🔄 升级方法

方法一：全新安装（最安全）

  1. 从固件选择器下载镜像

  2. 备份现有配置

  3. 使用 sysupgrade -n 或 LuCI（关闭"保留设置"）

  4. 从备份恢复配置

方法二：自动系统升级（推荐）

安装 ASU 工具（24.10 需要手动安装）：

bash

opkg update
opkg install luci-app-attendedsysupgrade
opkg install owut

使用 owut 检查升级：

bash

owut check --verbose --version-to 25.12

执行升级：

bash

owut upgrade --verbose --version-to 25.12

方法三：LuCI 自动系统升级

通过 Web 界面直观操作，自动收集已安装包并构建定制镜像。

📅 OpenWrt 24.10 生命周期结束通知

随着 25.12 的发布，OpenWrt 24.10 稳定系列将在 6 个月后（2026年9月） 结束生命周期，之后不再提供安全更新。建议用户在此之前完成升级。

🙏 致谢

感谢所有活跃的软件包维护者、测试者、文档编写者和支持者！是你们的贡献让 OpenWrt 不断进步。

享受 OpenWrt 25.12 带来的全新体验！

本文基于 OpenWrt 官方发布公告整理，完整更新日志请查阅 changelog-25.12.0