バックアップと復元: 設定、パッケージ、管理アクセスを個別に確認する

3種類の「バックアップ」

種類	含まれるもの	含まれないもの	主な用途
設定アーカイブ `sysupgrade -b`	`/etc/config` と `sysupgrade.conf` に記載されたファイル	ファームウェア、インストール済みパッケージ、ディスク全体	書き換え/アップグレード後に設定を復元する
パッケージ一覧	名前、バージョン、フィード	パッケージのバイナリ	再インストールのチェックリスト
完全イメージ/VMバックアップ	ディスク/VM全体	なし（サイズは大きい）	マシン全体のロールバック/ディスク交換

設定のバックアップはファームウェアのバックアップではありません。 設定を復元しても、削除したパッケージは再インストールされません。

バックアップの前に

ルーターのシェルリリース、ターゲット、パッケージ一覧を記録する

cat /etc/openwrt_release
cat /etc/apk/arch 2>/dev/null
apk list --installed > /tmp/packages-$(date +%F).txt
wc -l /tmp/packages-$(date +%F).txt
sysupgrade -l

このテスト環境: 25.12.6、x86/64、インストール済みパッケージ239個。sysupgrade -b は59エントリをアーカイブしました。

期待される結果バックアップ元のリリース/ターゲット/アーキテクチャが分かります。

ルーターのシェル設定アーカイブを作成する

sysupgrade -b /tmp/backup-$(date +%F).tar.gz
ls -lh /tmp/backup-*.tar.gz
tar -tzf /tmp/backup-$(date +%F).tar.gz | head
sha256sum /tmp/backup-$(date +%F).tar.gz

このテスト環境: 4.2MB、59エントリ。etc/config/network、dhcp、firewall、openclash、sqm を含みます。

アーカイブにはWi-Fiパスワード、PPPoE認証情報、DDNS/プロキシ設定が含まれる場合があります。公開クラウドストレージやリポジトリにアップロードせず、機密情報として扱ってください。

期待される結果検証可能な.tar.gzを作成し、デバイス外にコピーできます。

パソコンアーカイブをデバイスの外にコピーする

# ルーターから管理用マシンへ取得する
scp [email protected]:/tmp/backup-2026-10-20.tar.gz ./
sha256sum backup-2026-10-20.tar.gz

/tmp にだけ置かないでください。再起動で消え、書き換えでは確実に消えます。

期待される結果デバイスが起動しなくなったり書き換えられたりしても、バックアップが残ります。

3つの復元方法

1. 稼働中の同一バージョンでの復元（このテストで実施）

sysupgrade -r /tmp/backup-2026-10-20.tar.gz

-r は設定を復元して終了します。ファームウェアは書き換えません。その後、関連サービスを再起動するか、再起動してネットワーク/DHCP/DNSを再読み込みしてください。

このテストでは network.lan.e2_marker='before-restore' を書き込みました。sysupgrade -r の後、マーカーは消え、LANは 192.168.1.2/24 のままで、HTTP 200とSSHが動作しました。

2. 書き換え/アップグレード中の復元

sysupgrade -f /tmp/backup-2026-10-20.tar.gz <firmware.img>

-f はアップグレード中に設定を復元します。バックアップをファームウェアと見なさないでください。また、異なるリリース/ターゲット間で無闇に復元しないでください。

3. VM/イメージ全体のロールバック

PVEでは vzdump/スナップショットでVMのディスクと設定全体を復元します。ファームウェア、パッケージ、設定がすべて元に戻りますが、規模が大きく、新しいデータを上書きすることがあります。設定アーカイブとマシン全体のバックアップは代替になりません。

復元後の確認

パソコン管理アクセス

ping -c 2 192.168.1.2
curl -sSI --max-time 5 http://192.168.1.2/ | head -3
ssh [email protected] 'uci show network.lan | grep ipaddr'

HTTP 200はDHCPが動作する証明にはなりません
SSHで接続できても、LuCIの設定が正しい証明にはなりません
クライアントは更新して、復元したプールからアドレスを取得する必要があります

期待される結果LAN IP、HTTP、SSH、DHCPを少なくとも一度ずつ確認します。

ルーターのシェルネットワーク/DHCP/DNS

uci show network.lan
uci show dhcp.lan
ubus call network.interface.lan status
logread | grep -Ei 'dnsmasq|dhcp|netifd' | tail -30

必要に応じて再起動します。

/etc/init.d/network reload
/etc/init.d/dnsmasq restart

期待される結果ファイルが展開されただけでなく、復元した設定が実際に反映されています。

ルーターのシェルパッケージ

apk list --installed | wc -l
apk list --installed | grep -E 'openclash|sqm|adguard|luci-app' || true

設定アーカイブにはバイナリは含まれません。書き換えの後は、パッケージ一覧とフィードから再インストールしてください。OpenClash/SQM/AGHの設定は残っていても、プログラムとカーネルモジュールは再インストールして確認する必要があります。

期待される結果再インストールが必要なパッケージが分かります。設定の復元はパッケージの復元ではありません。

よくある失敗

復元後も古い設定のまま

sysupgrade -r の後にサービス/デバイスを再起動していない
別のアーカイブを復元してしまった
後から実行したUCIコマンドで上書きされた
アーカイブにそのファイルが含まれていない（sysupgrade -l / tar -tzf で確認）

復元後に接続できない

バックアップが別のLANサブネットのものだった
DHCP/ファイアウォールが再読み込みされていない
アーカイブに古いパスワード/SSH設定が含まれている
コンソールを使い、ip -4 addr show br-lan を確認する。すぐに工場出荷状態へリセットしない

パッケージが戻らない

設定のバックアップにパッケージファイルは含まれない
フィード/バージョンの不一致
luci-app-* とカーネルモジュールを再インストールする
「設定がある」ことは「プログラムがインストールされている」ことを意味しない

バージョンをまたぐ復元

リリース/ターゲット/アーキテクチャの不一致
新しいリリースでオプションの名前が変わった、または削除された
まずVMでテストする
ロールバック用に、旧ファームウェアとマシン全体のバックアップを保管する

E2テスト結果 (2026-10-20)

環境: OpenWrt 25.12.6 x86 VM 200、LAN 192.168.1.2/24、apk、インストール済みパッケージ239個
sysupgrade -b /tmp/backup-e2.tar.gz: 4.2MB、59エントリ。tar -tzf で etc/config/network、dhcp、firewall、openclash、sqm を確認
network.lan.e2_marker='before-restore' を書き込み。sysupgrade -r の後にマーカーは消え、LANは .2 のまま、HTTP 200、SSHが動作
未テスト: PVE全体のバックアップ復元、バージョンをまたぐ復元、パッケージの再インストール、実機での電源断/文鎮化
レシピ: tests/recipes/backup-restore-25.12.md

出典とレビュー

本ページはE2の一部です。同一バージョンでの設定のバックアップ/復元と管理アクセスをテストしました。マシン全体、バージョンをまたぐ復元、パッケージの再構築はテストしていません。
設定アーカイブには機密データが含まれます。コミットや共有をしないでください。
独立したレビュアーはいません。結論はこのVM環境に限られます。

出典

Router.Homes

独立した OpenWrt の実践ノートです。各ページにファームウェア、デバイス、パッケージマネージャー、元に戻す手順を明記しています。

アイコン：Solar by 480 Design, CC BY 4.0