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)网络接口名称发生变更,这种情况下需在升级时不保存旧配置(全新安装)。
🧹 全新安装 / 清洁升级
如果您想从头开始安装(最安全但最费力):
下载固件镜像
确保提前备份配置
使用以下命令清洁升级:
sysupgrade -n /tmp/firmware.bin或通过 LuCI → 备份/刷新固件 功能执行升级,同时关闭 “保留设置”。
4. 再根据之前备份手动恢复配置。
🛠 Attended Sysupgrade 升级选项
通过 ASU 升级有三种方式:
Firmware Selector 在线构建器(需手动提供已安装软件包列表)
LuCI Attended Sysupgrade(网络界面自动构建与安装)
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 索引生成错误传播
OpenWrt 25.12.0-rc5 — 第五版发布候选版本 — 2026 年 2 月 20 日 And OpenWrt 25.12.0-rc5 变更日志(Changelog)
https://niujinkai.com/archives/1771710422678.html
评论