清夏晚风
  2026-01-13 16:48:23 2026-01-13 16:48:23 Created   2026-01-13 16:48:23 2026-01-13 16:48:23 Updated  

OpenWrt 固件升级指南

更新日期：2025年11月9日

校验文件

MD5 校验和命令

1
md5sum [文件名]

SHA256 校验和命令

1
sha256sum [文件名]

文件上传方法

将固件上传至 /tmp 目录（内存空间，读写速度快）：

1
2
3
4
5
6
7
8
9
# Windows 使用 TFTP
tftp -i 192.168.1.1 put code.bin

# Linux 使用 TFTP
tftp -m binary 192.168.1.1 69

# SSH 上传
scp /tmp/uboot-fritz7530.bin root@192.168.1.1:/tmp/
scp /tmp/avm_fritzbox-7530-squashfs-sysupgrade.bin root@192.168.1.1:/tmp/

固件升级方法

sysupgrade 方式

1
2
3
4
5
6
7
8
# 基础升级（保留配置）
sysupgrade openwrt.bin

# 强制升级（忽略校验）
sysupgrade -F openwrt.bin

# 不保留配置升级
sysupgrade -n openwrt.bin

参数说明

参数 说明
-d 重启前等待 N 秒
-f 从 .tar.gz 恢复配置
-c 保留 /etc 修改文件
-T 仅校验不烧写
-b 创建配置备份
-r 恢复备份配置

mtd 方式

1
2
3
4
5
6
# 常规写入（自动重启）
mtd -r write /tmp/firmware.bin firmware

# 双分区写入
mtd write /tmp/uboot.bin uboot0
mtd write /tmp/uboot.bin uboot1

ubirmvol 方式

1
2
3
# 删除 AVM 文件系统分区
ubirmvol /dev/ubi0 --name=avm_filesys_0
ubirmvol /dev/ubi0 --name=avm_filesys_1

注意事项

⚠️ 重要区别说明

  1. factory.bin vs sysupgrade.bin

    • factory：适用于原厂固件升级，包含完整分区结构
    • sysupgrade：仅用于OpenWrt系统升级，不保留二进制安装文件

  2. 容量关系公式：
    sysupgrade.bin大小 + 空闲空间 + 系统配置空间 = factory.bin大小

  3. 救砖操作时优先使用 mtd 命令，sysupgrade 可能不可用

参考：OpenWrt Wiki

  • Title:
  • Author: 清夏晚风
  • Created at : 2026-01-13 16:48:23
  • Updated at : 2026-01-13 16:48:23
  • Link: https://blog.kimikkorow.eu.org/计算机基础/操作系统相关/操作系统使用相关/Linux/OpenWrt/OpenWrt 固件升级指南/
  • License: This work is licensed under CC BY-NC-SA 4.0.
On this page
  1. OpenWrt 固件升级指南
    1. 校验文件
    2. 文件上传方法
    3. 固件升级方法
      1. sysupgrade 方式
      2. mtd 方式
      3. ubirmvol 方式
    4. 注意事项