OpenWrt 25.12.2 - 服务版本 - 2026年3月27日

  _______                     ________        __
 |       |.-----.-----.-----.|  |  |  |.----.|  |_
 |   -   ||  _  |  -__|     ||  |  |  ||   _||   _|
 |_______||   __|_____|__|__||________||__|  |____|
          |__| W I R E L E S S   F R E E D O M
 -----------------------------------------------------
 OpenWrt 25.12.2, r32802-f505120278 Dave's Guitar
 -----------------------------------------------------

OpenWrt 社区欣然宣布 OpenWrt 25.12 稳定系列的最新版本正式发布。

您可以通过 固件选择器 或直接从我们的下载服务器获取固件镜像：

  • 使用固件选择器下载适用于您设备的固件镜像

  • 从 OpenWrt 下载服务器直接下载固件镜像

在多数情况下，可借助 sysupgrade 工具从 OpenWrt 24.10 升级至 25.12，该工具会尝试保留配置。但升级至 OpenWrt 25.12 时，仍建议备份配置（详见下文“升级说明”）。

关于 OpenWrt

OpenWrt 项目是一个面向嵌入式设备的 Linux 操作系统，旨在完全替代各类无线路由器及非网络设备的厂商固件。支持的设备列表请参阅 硬件兼容表。更多项目信息，请访问 关于 OpenWrt 页面。

新版本与安全公告订阅

希望及时获取新版本发布和安全更新等重要信息？
我们为此设立了专门的邮件列表，并支持 RSS 订阅：详见 重要变更与公告。

OpenWrt 25.12.1 至 25.12.2 主要变更

以下仅列出主要变更，完整日志请参阅 changelog-25.12.2。

设备支持

  • airoha：将内核模块 kmod-pwm-an7581 重命名为 kmod-pwm-airoha —— 显式安装此模块的用户需按新名称重新安装。

  • apm821xx：修复 NETGEAR WNDR4700、Western Digital MyBookLive、Meraki MR24 及 Meraki MX60 的 U-Boot 环境变量定义；修复 Meraki MX60 的 PCIe 启动失败问题。

  • ath79：修复 Huawei AP5030DN 和 AP6010DN 的 initramfs 启动问题；修复双 CPU 端口设备的 VLAN CPU 端口标记问题（影响多个双 CPU 交换机配置）；移除 Mikrotik RB750r2 中错误包含的 WiFi 软件包（该设备无无线硬件）。

  • ipq40xx：修复 Linksys Velop WHW03 V1 的 ART 分区名称，恢复正确的 WiFi 校准数据访问；修复使用 eMMC 存储 NVMEM 的 Linksys 设备 MAC 地址读取问题。

  • lantiq (xrx200)：修复 BT HomeHub 5A 的故障安全模式，LAN 1 和 LAN 2 端口现可正常工作 (#22480)。

  • mediatek：修复 Bananapi BPI-R4 的 SFP+ 电口模块支持，解决快照升级后模块失效的问题 (#19878)。

  • ramips：修复 ELECOM WRC-X1800GS 在 25.12.0 版本中因内核解压错误导致的变砖问题 (#22270)；修复 TP-Link EAP615-Wall v1 的 initramfs 内核加载地址；修复 Xiaomi Mi AC2100 的 MAC 地址分配。

  • realtek：修复 D-Link 风扇控制脚本。

WiFi 修复与改进

  • wifi-scripts：修复 160 MHz 信道宽度配置问题，此前 hostapd 未能正确配置，导致该频宽无法使用 (#22481)；修复 SU 波束成形天线数量计数错误。

  • hostapd：修复无线资源管理（RRM）ubus 接口中的内存泄漏问题。

  • mac80211：为 ath12k 添加 QCA/IPQ 设备的热传感器支持；修复 ath9k 的设备树 GPIO 掩码处理问题。

  • mt76：修复 25.12.1 版本中引入的 2.4 GHz 严重 WiFi 延迟回退问题（延迟可达 30 秒以上），受影响设备包括 OpenWrt One、Zyxel EX5601、ASUS RT-AX53U、Xiaomi AX3000T/AX6000、Cudy WR3000/X6、GL Flint 2 等 (#22491)；为 MediaTek WiFi 芯片（MT7615/MT7915/MT7996/MT7992/MT792x）添加多项稳定性修复，包括为 MLO 添加每链路信标监控、修复 MLO 站点添加/移除时的链路处理、修复扫描工作重入的竞态条件等。

升级至 25.12 的注意事项

  • 从 24.10 升级至 25.12 在大多数设备上可平滑进行，多数配置数据保持不变或可在首次启动时由初始化脚本自动转换。在 25.12 稳定系列内部升级时，支持 自动化系统升级，可保留已安装软件包。

  • 从 23.05 或更早版本升级至 25.12 不在官方支持范围内。

  • Cron 日志级别 已在 busybox 中修复。system.@system[0].cronloglevel 应设为 7 以启用常规日志记录，7 现为默认值。若未设置此选项，系统将使用默认值，无需手动干预。

  • Bananapi BPI-R4：接口 eth1 更名为 sfp-lan 或 lan4，接口 eth2 更名为 sfp-wan 以匹配设备标签。升级时必须不保留配置。

  • TP-Link RE355 v1、RE450 v1 和 RE450 v2：此版本中分区布局和块大小发生变更，以解决系统升级时的配置丢失问题。从 25.12.0 或更早版本升级的用户必须使用 sysupgrade -F 强制升级，且镜像大小不得超过 5.875 MB（6016 KiB）。

  • Meraki MX60：无法直接通过 sysupgrade 升级至 25.12.2，需手动准备 —— 升级前必须修改 meraki_loadaddr，因为默认值不足以启动 OpenWrt 25.12+。具体操作请参阅设备 Wiki 页面。

已知问题

  • Zyxel EX5601-T0：WAN 接口已从 eth1 更名为 wan，升级后请检查并更新网络配置。

  • Pixel 10 手机 连接受 WPA3 保护的 WiFi 6 接入点时存在问题 (#21486)。

  • 使用 WPA3 时，802.11r 快速漫游 可能与部分客户端产生连接问题 (#22200)。

  • SQM CAKE MQ (cake_mq)：在此版本的调度器修复后，某些配置下可能出现吞吐量意外偏低的情况 (#22344)。

结语

再次向所有活跃的软件包维护者、测试人员、文档贡献者及支持者表示由衷感谢！

祝使用愉快！

OpenWrt 社区