OpenWrt 社区自豪地宣布 OpenWrt 25.12 稳定系列的第五个发布候选版本(Release Candidate)。
请注意:这仍然只是测试版 发布候选版本,不是最终稳定版本。


📥 固件下载

您可以通过以下方式下载固件镜像:

  • 通过 固件选择器 (Firmware Selector) 下载适合您设备的固件。

  • 或直接从 OpenWrt 官方下载服务器获取镜像文件。


⚠️ 升级提示

  • 在很多情况下可以使用 sysupgrade 工具 将 OpenWrt 24.10 升级到 25.12,它会尝试保留现有配置。

  • 无论如何,强烈建议先备份现有配置 再进行升级。


🧪 请测试此版本

这是一个 测试版本(非正式稳定版本)
如果发现任何问题或错误,请在社区的 问题跟踪器 (issue tracker) 中反馈。


📌 关于 OpenWrt

OpenWrt 是一个针对嵌入式设备的 Linux 操作系统,可完全替代厂商预装固件,尤其适用于无线路由器等设备。
支持设备列表可以在 硬件表格 (Table of Hardware) 中查看。


OpenWrt 25.12 的亮点

OpenWrt 25.12.0-rc5 自从从 OpenWrt 24.10 分支以来,包含了 4600 多次提交,开发周期超过一年。

以下为主要更新内容(完整变更请参见官方完整变更日志):


🛠 通用更新

🔄opkg 切换到 apk

  • OpenWrt 从传统的 opkg 包管理器切换到了 Alpine Linux 的 apk(Alpine Package Keeper)。

  • 这是因为 opkg 的 OpenWrt 分支已经不再维护,而 apk 仍有积极维护。

  • apk 支持大多数原先 opkg 的功能,仅有极少数软件包名称发生变更。

  • apk 的命令参数与 opkg 不同,建议查看官方提供的 opkg→apk 迁移对照表 来简化迁移过程。


🆙 默认集成 Attended Sysupgrade

OpenWrt 现在默认安装 attended.sysupgrade LuCI 应用(ASU)。

通过 ASU,设备可以:

  • 升级到新的 OpenWrt 固件版本

  • 自动构建包含当前已安装软件包的固件镜像

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

这大大简化了升级流程:在 LuCI 界面中点击几下即可自动构建并安装固件,无需手动干预。


📝 Shell 历史保持

Shell (命令行)历史现在不会在每次登录间丢失,而是通过 RAM-backed 文件系统 存储:

  • 登录间历史记录不会丢失

  • 默认不会写入闪存,以避免过度擦写损耗

如果您希望长期保存历史记录,也可以编辑:

/etc/profile.d/busybox-history-file.sh

⚠️ 注意:长期写入闪存会增加擦写次数,影响闪存寿命。


🎥 视频 Feed 默认集成

OpenWrt 现在默认集成 Qt5 视频 Feed 和相关 UI 应用。


📶 Wi-Fi 脚本 重写为 ucode

OpenWrt 的 Wi-Fi 脚本已用 ucode 脚本语言 重写,提供更灵活可靠的配置支持。


🎯 支持目标平台变更

25.12 RC5 包括以下硬件平台支持扩展:

  • 扩展 Realtek 平台以支持更多交换芯片 SoC(如 10G 以太网交换芯片)

  • 扩展 Qualcommax 支持 ipq50xx 和 ipq60xx SoC

  • 新增 Siflower 目标(支持 SF21A6826/SF21H8898 SoC)

  • 新增 sunxi/arm926ejs 子目标(支持 Allwinner F1C100/200 SoC)

  • 新增 microchipsw/lan969x 目标(支持 Microchip LAN969x 交换芯片)


📱 新增设备支持

OpenWrt 25.12 支持 超过 2240 种设备,相比 24.10 系列增加了 220+ 新设备支持。


🔄 核心组件更新

主要组件版本如下:

  • 工具链

    • musl libc 1.2.5

    • glibc 2.41

    • gcc 14.3.0

    • binutils 2.44

  • Linux 内核:6.12.71

  • 主要软件包

    • cfg80211/mac80211(来自 kernel 6.18.7)

    • hostapd 主分支快照(截止 2025 年 8 月)

    • dnsmasq 2.91

    • dropbear 2025.89

    • busybox 1.37.0

  • 以及许多其它软件包也被更新。


🔁 升级到 OpenWrt 25.12

✔️ 通过 Sysupgrade 升级

一般来说,从 24.10 系列升级到 25.12 是透明且自动保留配置的,因为大多数配置格式保持兼容,初次启动时会自动迁移。

⚠️ 注:从 23.05 直接升级到 25.12 不被官方支持


⚙️ 特别注意事项

  • cron 日志等级修复:现在默认值为 7,无需手动动作。

  • 部分设备(如 Bananapi BPI-R4)网络接口名称发生变更,这种情况下需在升级时不保存旧配置(全新安装)。


🧹 全新安装 / 清洁升级

如果您想从头开始安装(最安全但最费力):

  1. 下载固件镜像

  2. 确保提前备份配置

  3. 使用以下命令清洁升级:

sysupgrade -n /tmp/firmware.bin

或通过 LuCI → 备份/刷新固件 功能执行升级,同时关闭 “保留设置”。
4. 再根据之前备份手动恢复配置。


🛠 Attended Sysupgrade 升级选项

通过 ASU 升级有三种方式:

  1. Firmware Selector 在线构建器(需手动提供已安装软件包列表)

  2. LuCI Attended Sysupgrade(网络界面自动构建与安装)

  3. owut 命令行工具(更详细的诊断与输出)

如果尚未安装 ASU 或 owut,可以使用命令安装:

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

可单独安装其中任意一项或两者同时安装。


🧠 已知问题(Known Issues)

  • 部分 Zyxel EX5601-T0 设备的 WAN 端口名称有变更(从 eth1 → wan),请检查网络接口设置。


📌 结语

感谢所有活跃的包维护者、测试者、文档撰写者和社区支持者!
祝大家使用愉快!

OpenWrt 25.12.0-rc5 变更日志(Changelog)

本变更日志列出了自 v25.12.0-rc4 标签以来 OpenWrt 所有提交记录,按子系统分组。
变更按时间顺序排列(从上到下),涵盖直到 25.12.0-rc5 正式打标签为止的 Git 仓库历史。

另请参阅发布说明(Release Notes),以获取 25.12.0-rc5 主要变更的更易读概览。


构建系统 / Buildroot(4 项)

  • ext-toolchain:修复 gcc-ar、gcc-nm、gcc-ranlib 的 wrapper 问题

  • package-pack:修复 Ubuntu 18.04 下的编译问题

  • image:支持为每个设备单独生成 targz rootfs

  • build:向 cmake 构建传递 CPPFLAGS


构建系统 / 主机工具(1 项)

  • m4:更新至 1.4.21


构建系统 / 工具链(1 项)

  • fortify-headers:修复 fortify/stdio.h 中 -Werror=format-nonliteral 问题


内核(17 项)

  • 添加 tpm-tis-spi 模块

  • 修复 rtl8261n 驱动在非 Realtek 芯片上的问题

  • Linux 6.12 从 .67 → .68 → .69 → .70 → .71 多次更新

  • 回退 ip6_tunnel 中对 skb_vlan_inet_prepare() 的使用

  • 修复 mtk_eth_soc 内存泄漏

  • airoha an7581 启用 USB 支持

  • 添加 cake-mq 支持

  • mtdsplit:新增可执行前导分割器

  • 添加 CONFIG_MTD_SPLIT 配置选项

  • 回移植(backport)pppoe 改进

  • 刷新补丁

  • 将 mpc85xx 补丁移至 pending

  • 重新回退之前的 ip6_tunnel 改动


软件包 / 引导加载器(7 项)

  • uboot-rockchip:增加 HINLINK H28K 支持

  • mediatek filogic:修复 gl-mt2500 PHY 兼容性

  • u-boot:初步支持 qoriq 架构

  • uboot-qoriq:修复 T4240RDB 选择问题

  • filogic:增加 Bazis AX3000WM 支持

  • mediatek:增加 netis NX32U 支持

  • mvebu:增加 RIPE Atlas Probe v5 支持


软件包 / 通用(43 项)

Wi-Fi 脚本

  • 修复 psk-sae/sae-mixed 下 ieee80211w 覆盖问题

  • 修复默认 OpenWrt SSID 加密设置

  • 允许在 AP 模式下修改 sae_pwe

  • 修复 ieee80211w 默认值

  • 重构 iwinfo.uc 以支持动态数据更新

  • 缓存 survey 数据

  • 修复 macaddr 校验

  • 修复嵌套配置累积问题

  • 修复 config_init 空指针引用

  • 增加 MLO 支持

apk

  • 回移植时间戳错误修复

  • 修复未对齐访问

  • 处理解析 .apk 文件的边界情况

wireguard-tools

  • 重载时检测地址变更

  • 增加协议 renew 处理器

  • 避免生成密钥和 peer 时使用临时文件

  • 支持无需 teardown 的 reload

  • 修复脚本错误

unetmsg

  • TX 断开回调空指针检查

  • 增加认证超时

  • 修复网络更新清理问题

  • 修复条件反转

  • 删除冗余 close

  • 修复远程认证通知时间

  • 连接断开时通知订阅者

其他

  • ucode:增加 ubus 修复

  • udebug 更新

  • 多个软件包增加 CPPFLAGS
    (包括 binutils、gdb、bzip2、libcap、wireless-tools 等)


软件包 / 固件(4 项)

  • ipq-wifi 更新至 Git HEAD(两次)

  • 添加多个 BDF(板级数据文件),包括:

    • TP-Link EAP620 HD v3

    • TP-Link TL-WA1201 v2

  • qoriq:增加 NXP T4240RDB 支持


OpenWrt 网络用户空间(9 项)

  • 修复 config_change 导致的误 teardown

  • 改进 6in4 HE 隧道更新

  • uclient 更新两次(修复 HTTP/HTTPS 重定向、认证、内存泄漏等)

  • uclient-fetch:支持 --method、--body-data、--body-file、HEAD、OPTIONS、WebDAV

  • 6rd 增加 CPPFLAGS

  • iwinfo 增加 CPPFLAGS


OpenWrt 系统用户空间(3 项)

  • procd:reload_config 支持 UCI overlay 目录

  • libubox 更新:

    • 警告输出到 stderr

    • 文档改进

    • 数组支持匿名字符串与整数

    • uloop 改进

    • usock 实现 RFC 8305 Happy Eyeballs

  • fstools 更新


各目标平台更新(节选重点)

airoha(12 项)

  • 替换补丁为上游版本

  • 修复 DTS 错误

  • 修正 PHY/LED 节点

  • 默认禁用所有交换端口

  • 显示链路速率与双工

  • 添加 USB 支持

ath79

  • 为 TP-Link TL-WA1201 v2 添加校准变体

  • Sitecom WLR-7100 / WLR-8100 添加 env-size

bcm27xx / bcm53xx

  • 内核版本更新

  • 修复 meraki_mx64-a0 目标名称

gemini(13 项)

  • 修复 rootfs

  • 支持参考设计升级

  • 固件写入与分区修复

  • LED 活动指示修复

mediatek(10 项)

  • 修复 mtk_eth_soc 内存泄漏

  • 增加 Cudy AP3000 系列支持

  • 添加 Bazis AX3000WM

  • 添加 netis NX32U

ramips

  • 增加 D-Link DIR-1360 A1 支持

realtek

  • 多项 DSA 修复

  • 移除 storm control

  • 添加 LGS328C 端口定义

x86

  • 增加 Sophos 210r3 和 230r2 支持


无线通用

  • ath11k:修复不支持 11ax EDCA 导致的崩溃问题


杂项

  • 构建系统在生成 apk 索引时传播错误


修复的 Bug

#20702

ath11k 在 MX4300(ipq807x)STA 模式下崩溃
→ 修复 11ax EDCA 问题

#21307

APK 在 25.12.0-rc1 出现段错误
→ 修复未对齐访问问题

#21696

Sitecom WLR-8100 安装 rc1 后无法访问
→ 添加 u-boot-env env-size

#21737

ds-lite ipip6 数据包未解封装
→ 回退 ip6_tunnel 改动

#21751

PSK-SAE 下 11w “required” 设置被忽略
→ 修复 ieee80211w 覆盖问题

#21847

WireGuard 多 AllowedIPs 或 peer-PSK 失效
→ 修复脚本错误

#21981

rc4 缺少 packages.adb
→ 修复 apk 索引生成错误传播