Writing

别只备份 /etc/config —— OpenWrt 路由器“可复活”备份实战

sysupgrade 备份只覆盖一层:配置之外还有状态数据、自定义脚本和固件本体。四层备份法、Windows 无 sshpass 与 Dropbear 无 SFTP 的传输方案、mtd 固件 dump 与 MD5 校验,一份能让同款新机十分钟复活的 OpenWrt 备份实录。

· 更新于 2026/10/11 · 20 分钟阅读 · 1,793 字
目录
  1. 一、先想清楚:要备份的其实是四层东西
  2. 标准备份的三个坑
  3. 二、动手前的两个障碍
  4. 障碍一:Windows 上没有 sshpass
  5. 障碍二:Dropbear 默认没有 SFTP
  6. 三、五步实操
  7. Step 1:摸底——先看清自己有什么
  8. Step 2:官方标准配置备份
  9. Step 3:把标准备份之外的文件捞出来
  10. Step 4:软件包清单
  11. Step 5:固件整分区 dump + MD5 校验
  12. 四、恢复篇:新机器的三种姿势
  13. 姿势一:Breed 不死引导(最推荐)
  14. 姿势二:小米官方系统
  15. 姿势三:只还原配置到任意 OpenWrt
  16. 为什么不整个 flash 全盘克隆?
  17. 五、一键脚本(整理版)
  18. 六、复盘清单

一台调教了很久的小米路由器 3G(MT7621),跑着 OpenWrt SNAPSHOT:双 WAN、校园网门户自动登录、OpenClash、ZeroTier、一堆 crontab 脚本。这些不是一天调出来的,所以我决定给它做一次能复活的备份——哪怕哪天它寿终正寝,或者我买台同款新机器,十分钟就能原样复活。本文记录完整过程和踩过的坑,方法论同样适用于其他型号的 OpenWrt 设备。

一、先想清楚:要备份的其实是四层东西

很多人的第一反应是 cp -r /etc/config,但那只覆盖了最上面一层。OpenWrt 上真正构成“我的路由器”的,是四层东西:

层 内容 备份方式
① 配置文件 /etc/config/* 全部 UCI 配置 sysupgrade -b 标准备份
② 状态数据 OpenClash 核心/规则库、ZeroTier 身份密钥、SSH host key、uHTTPd 证书 sysupgrade -b(默认清单基本覆盖,但要核对)
③ 自定义文件 自己写、放到 /root、/usr/bin 的脚本 手动打包,标准备份完全不含
④ 固件本体 内核 + rootfs + 全部已安装软件 cat /dev/mtdX 整分区 dump

标准备份的三个坑

坑一:自定义脚本不在备份清单里。 sysupgrade -b 只打包 sysupgrade -l 列出的文件(/etc/config 加上 conffiles 标记的路径)。我这次的突破口是 crontab -l——里面赫然引用了三个标准备份根本不认识的路径:

*/5  * * * * /root/wan2/autologin.sh      # 校园网门户自动登录
*/10 * * * * /usr/bin/wanbal-check.sh     # 双 WAN 负载检查
*/10 * * * * /usr/bin/slim-clash-check.sh # OpenClash 规则保活

这些脚本丢了,配置恢复得再完美也只是个“看起来能跑”的空壳——定时任务每 5 分钟报一次“找不到文件”。crontab 和 /etc/rc.local 是发现隐藏自定义文件的最可靠线索。

坑二:SNAPSHOT 固件没了就是没了。 我的机器跑的是 OpenWrt SNAPSHOT R24.2.2(BUILD_ID r6448-a61217134),这种特定编译版本,官方仓库里未必还能下到一模一样的。

坑三:kmod 软件包和内核版本强绑定。 即使你留着 opkg list-installed 的软件清单,换一个固件版本,kmod-* 系列内核模块基本都要重装重配,因为它们是按内核 ABI 编译的。所以固件本身的 dump 是唯一能 100% 复刻运行环境的办法——这也是“四层”里第④层存在的意义。

二、动手前的两个障碍

障碍一:Windows 上没有 sshpass

想全自动备份,绕不开“非交互式输密码”。Windows/Git Bash 自带的 OpenSSH 没法像 Linux 那样用 sshpass 喂密码。我的方案是 Python + paramiko:

pip install paramiko

障碍二:Dropbear 默认没有 SFTP

paramiko 连上路由器后,open_sftp() 直接抛 EOF during negotiation——OpenWrt 默认的 SSH 服务端 Dropbear 不带 SFTP 子系统(除非手动装 openssh-sftp-server 包)。

不想为了“备份”反过来给路由器装东西?其实 SSH 的 exec 通道本身就能传文件:远程执行 cat 文件名,标准输出的字节流直接落到本地文件就行。SSH 通道天然 8-bit clean,传二进制毫无压力。整个备份的所有传输,都是这么完成的。

三、五步实操

Step 1:摸底——先看清自己有什么

import paramiko

ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
ssh.connect('192.168.1.1', username='root', password='你的密码',
            timeout=10, look_for_keys=False, allow_agent=False)

def run(cmd, timeout=300, quiet=False):
    _, out, err = ssh.exec_command(cmd, timeout=timeout)
    data, e = out.read(), err.read().decode(errors='replace').strip()
    if e and not quiet:
        print(f'  [stderr] {e[:120]}')
    return data

print(run('ubus call system board').decode())   # 型号/架构/固件版本
print(run('cat /proc/mtd').decode())            # 分区布局
print(run('sysupgrade -l').decode())            # 标准备份会包含哪些文件
print(run('crontab -l').decode())               # 定时任务里引用了哪些自定义脚本
print(run('cat /etc/rc.local').decode())        # 开机脚本同理

我的机器摸底结果(节选):小米 Mi Router 3G,MediaTek MT7621,squashfs + UBI,内核 5.4.268。分区表里最关键的两行:

mtd8: 00400000 00020000 "kernel"    ← 内核,4 MB
mtd9: 07580000 00020000 "ubi"       ← rootfs + 全部用户数据,约 117 MB

Step 2:官方标准配置备份

run(f'sysupgrade -b /tmp/backup.tar.gz', quiet=True)  # stderr 里的 "Saving config files..." 是正常输出
open('sysupgrade-backup.tar.gz', 'wb').write(run('cat /tmp/backup.tar.gz'))

sysupgrade -b 生成的是 OpenWrt 官方意义上的“配置备份”,89 个文件,包含 /etc/config 全部、OpenClash 的核心和规则文件、ZeroTier 的身份密钥、dropbear host key、crontab、rc.local。恢复时可以直接喂给 sysupgrade -r 或 LuCI 页面,这是兼容性最好的格式。

Step 3:把标准备份之外的文件捞出来

run('tar -czf - -C / root/wan2 root/openclash_backup '
    'usr/bin/wanbal-check.sh usr/bin/ocmon.sh usr/bin/slim-clash-check.sh '
    'etc/crontabs/root etc/rc.local', quiet=True)
# ↑ 路径因人而异!按 Step 1 摸底结果调整
open('custom-files.tar.gz', 'wb').write(...)

再把 /etc/config 整个打包一份解压到本地——不是为了备份,是为了随时能打开看当前配置长什么样。

Step 4:软件包清单

open('packages.txt', 'wb').write(run('opkg list-installed'))

我的机器上有 315 个包。这份清单配合固件 dump,是双保险:固件在,软件就在;固件万一刷坏,还能按清单在对应版本上重装。

Step 5:固件整分区 dump + MD5 校验

这是整个备份的灵魂。直接把两个分区读下来:

import hashlib

for mtd, name in [('mtd8', 'kernel'), ('mtd9', 'ubi')]:
    # 远端先算一次 MD5
    remote_md5 = run(f'md5sum /dev/{mtd}').decode().split()[0]

    # 流式下载,边收边算
    _, out, _ = ssh.exec_command(f'cat /dev/{mtd}', timeout=1800)
    h, size = hashlib.md5(), 0
    with open(f'{name}-dump.bin', 'wb') as f:
        while chunk := out.read(256 * 1024):
            f.write(chunk); h.update(chunk); size += len(chunk)

    ok = '✓' if h.hexdigest() == remote_md5 else '✗ 校验失败!'
    print(f'{name}: {size} bytes, md5={h.hexdigest()} {ok}')

117 MB 的二进制跨 SSH 传输,必须校验。我两次都拿到远端与本地 MD5 一致的结果,才敢把这个文件称为“备份”。

最后把 kernel 和 ubi 按顺序拼接,得到一个与刷机包等价的完整固件镜像:

cat kernel-dump.bin ubi-dump.bin > firmware-full.bin   # 顺序不能颠倒

四、恢复篇:新机器的三种姿势

姿势一:Breed 不死引导(最推荐)

如果新机器已经装了 Breed(R3G 玩家的标配):Breed 网页 → 固件更新 → 把 kernel-dump.bin 刷到 kernel 分区、ubi-dump.bin 刷到 ubi 分区,重启。开机后和旧机器完全一致——IP、密码、WiFi、脚本、插件,全部原样。

姿势二:小米官方系统

  • 网页方式:登录 192.168.31.1 → 手动升级,刷入拼接好的 firmware-full.bin
  • TFTP 方式:电脑设静态 IP 192.168.31.100/24,TFTP 服务器根目录放好改名为 r3g.bin 的固件(恢复引导只认这个文件名),按住 reset 上电,路由器会自动从 192.168.31.1 拉取刷入。详见 OpenWrt 官方 Wiki 的 mir3g 页面。

姿势三:只还原配置到任意 OpenWrt

如果新机器打算刷别的固件,就退回“配置层”恢复:

# 路由器上执行,还原后重启
sysupgrade -r /tmp/sysupgrade-backup.tar.gz && reboot

(LuCI 里对应:系统 → 备份/升级 → 恢复配置。)

然后把自定义脚本按原路径放回并 chmod +x,软件包按 packages.txt 重装:

opkg update
sed 's/ - .*//' packages.txt | xargs opkg install   # 已装的会跳过,报错属正常

注意:跨固件版本还原配置时,个别 UCI 字段可能不兼容,恢复后到 LuCI 逐页检查一遍。

为什么不整个 flash 全盘克隆?

你可能会想:干脆把 Bootloader 到最后一个分区全部 dump 下来,新机器整盘写回去,100% 克隆。别这么做。 factory 分区(mtd3)存的是每台机器自己的射频校准数据和 MAC 地址:

  • 把 A 机器的校准数据写进 B 机器,无线信号会变差(校准是产线逐台做的)
  • 两台机器会拿到同一个 MAC,同时开机就在局域网里打架

正确的姿势就是只刷 kernel + ubi,factory 不动——新机器用自己出厂的校准和 MAC,跑我备份的系统。

五、一键脚本(整理版)

把上面五步合成一个脚本,改改 IP 密码就能用(Python 3.8+,需 pip install paramiko):

#!/usr/bin/env python3
"""openwrt_full_backup.py — OpenWrt 完整备份:配置 + 自定义文件 + 软件清单 + 固件
用法: python openwrt_full_backup.py 192.168.1.1 你的密码 [输出目录]"""
import datetime, hashlib, os, sys
from pathlib import Path
import paramiko

HOST, PASSWORD = sys.argv[1], sys.argv[2]
STAMP = datetime.date.today().strftime('%Y%m%d')
OUT = Path(sys.argv[3] if len(sys.argv) > 3 else f'router-backup-{STAMP}')
(OUT / 'system-info').mkdir(parents=True, exist_ok=True)

ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
ssh.connect(HOST, username='root', password=PASSWORD, timeout=10,
            look_for_keys=False, allow_agent=False)

def run(cmd, timeout=300, quiet=False):
    """Dropbear 没有 SFTP,一切传输走 exec 通道字节流"""
    _, out, err = ssh.exec_command(cmd, timeout=timeout)
    data, e = out.read(), err.read().decode(errors='replace').strip()
    if e and not quiet:
        print(f'  [stderr] {e[:120]}')
    return data

# 1. 摸底信息
Path(OUT / 'system-info/board.json').write_bytes(run('ubus call system board'))
Path(OUT / 'system-info/mtd.txt').write_bytes(run('cat /proc/mtd'))
Path(OUT / 'system-info/sysupgrade-list.txt').write_bytes(run('sysupgrade -l'))
print(run('ubus call system board').decode())

# 2. 官方标准配置备份(恢复用 sysupgrade -r 或 LuCI)
run(f'sysupgrade -b /tmp/backup-{STAMP}.tar.gz', quiet=True)
Path(OUT / f'sysupgrade-backup-{STAMP}.tar.gz').write_bytes(
    run(f'cat /tmp/backup-{STAMP}.tar.gz'))

# 3. 配置可读版 + 自定义文件(路径按自己机器的 crontab/rc.local 摸底结果改)
Path(OUT / 'etc-config.tar.gz').write_bytes(run('tar -czf - -C / etc/config'))
Path(OUT / 'custom-files.tar.gz').write_bytes(run(
    'tar -czf - -C / root/wan2 usr/bin/wanbal-check.sh '
    'etc/crontabs/root etc/rc.local', quiet=True))

# 4. 软件包清单
Path(OUT / 'packages.txt').write_bytes(run('opkg list-installed'))

# 5. 固件分区 dump + MD5 校验(mtd 编号以上面 /proc/mtd 输出为准)
dumps = {}
for mtd, name in [('mtd8', 'kernel'), ('mtd9', 'ubi')]:
    remote_md5 = run(f'md5sum /dev/{mtd}').decode().split()[0]
    _, out, _ = ssh.exec_command(f'cat /dev/{mtd}', timeout=1800)
    h, size = hashlib.md5(), 0
    with open(OUT / f'{name}-dump.bin', 'wb') as f:
        while chunk := out.read(256 * 1024):
            f.write(chunk); h.update(chunk); size += len(chunk)
    print(f'{name}: {size} bytes '
          f"{'✓' if h.hexdigest() == remote_md5 else '✗ MD5 不一致!'}")
    dumps[name] = OUT / f'{name}-dump.bin'

# 拼接完整固件镜像(kernel 在前,ubi 在后,勿颠倒)
Path(OUT / 'firmware-full.bin').write_bytes(
    dumps['kernel'].read_bytes() + dumps['ubi'].read_bytes())

ssh.close()
print(f'\n完成,备份在 {OUT}/  请连同 README 一起归档到网盘/移动硬盘')

六、复盘清单

  • sysupgrade -l 是备份范围的“事实标准”——先看它列了什么,再决定要补什么
  • crontab 和 rc.local 是挖出自定义脚本的最好线索,我的三个关键脚本就是这么找到的
  • 固件 dump 才是终极保险:SNAPSHOT/第三方固件会绝版,kmod 和内核 ABI 强绑定
  • 大文件传输必须校验(远端 md5sum vs 本地),否则你不备份了个寂寞
  • 别全盘克隆:factory 分区是每台机器的“身份证”,同型号迁移只刷 kernel + ubi
  • 备份文件本身就是敏感信息集合:WiFi 密码、订阅 token、SSH host key 全在里面,归档到加密盘或私有网盘,别传公共网盘
  • 恢复演练过一次的备份才算真备份——找机会在 Breed 里刷一遍试试,你会发现 README 比固件更值钱

整个过程约 10 分钟,产出 261 MB,值得。

系列后续:《一台百元路由器的完全体 —— 小米路由器 3G 功能盘点与 OpenWrt 从零调教》、《从 100M 到 400M —— 一次校园网提速的完整复盘》

相关文章