Writing
别只备份 /etc/config —— OpenWrt 路由器“可复活”备份实战
sysupgrade 备份只覆盖一层:配置之外还有状态数据、自定义脚本和固件本体。四层备份法、Windows 无 sshpass 与 Dropbear 无 SFTP 的传输方案、mtd 固件 dump 与 MD5 校验,一份能让同款新机十分钟复活的 OpenWrt 备份实录。
目录
一台调教了很久的小米路由器 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 —— 一次校园网提速的完整复盘》