OpenWrt の Docker:インストール、ストレージ、ネットワーク、再起動後の復旧
状態: VM上のDockerプラットフォームはE2。AdGuard Home、Home Assistant、NAS、USB/SSD、実機ルーター再起動はE1。16MB/128MBルーターにパッケージがあるだけでDockerを入れない。
Dockerは適切か
Section titled “Dockerは適切か”RAM(VMは512MB)、ストレージ(ルートを2GBに拡張)、書き込み可能なdata root(/opt/docker)、公開ポートのfirewall、再起動後のdocker0/veth復旧計画が必要。
インストール
Section titled “インストール”apk updateapk add dockerd docker/etc/init.d/dockerd enable/etc/init.d/dockerd startdocker infoOpenWrt 25.12.6 に Docker 29.6.1。containerd、runc、kmod、大きなdockerdが入るので空き容量を確認。
レジストリミラー(地域依存)
Section titled “レジストリミラー(地域依存)”Docker Hubはタイムアウトし、ミラーで成功:
uci add_list dockerd.globals.registry_mirrors='https://docker.m.daocloud.io'uci commit dockerd/etc/init.d/dockerd restart万能な推奨ではない。信頼できるミラーを使いdigestを確認。
uci show dockerddocker info | grep -E 'Docker Root Dir|Storage Driver'df -h /opt/opt/dockerは実ディスク、USB SSD、NVMeへ。小さなoverlayに置かない;- Docker起動前にストレージをマウント;
docker system dfで確認し不要なイメージ/コンテナを削除;- 再起動で消えるFSにデータを置かない。
この実験は2GBのルートを使用。USB/SSDはE1。
ネットワークとポート
Section titled “ネットワークとポート”ip link show docker0docker run --rm hello-worlddocker run --rm -v /tmp/docker-test:/data alpine \ sh -c 'echo hello > /data/hello && cat /data/hello'docker run -d --name rh-test-http -p 8082:80 nginx:alpinecurl -sS http://127.0.0.1:8082結果:hello-world成功、ボリュームが/tmp/docker-test/helloを書き込み、nginxが8082で応答。実機ではWANへデフォルト公開しない、53ポート、hostネットワーク、Docker socket/APIの露出に注意。
重要な再起動障害
Section titled “重要な再起動障害”reboot後、Dockerは起動したがdocker0がない:
ip link show docker0# Device "docker0" does not existdocker ps -a# rh-test-http Exited (255)docker start rh-test-http# failed to create endpoint ... veth... bridge docker0 failed:# Device does not exist新規コンテナも失敗。復旧:
/etc/init.d/dockerd restartip link show docker0docker run -d --name rh-test-http3 -p 8082:80 nginx:alpinecurl -sS http://127.0.0.1:8082dockerd restart後にdocker0が戻り、新規コンテナが動作。--restart unless-stoppedが再起動後に人手なしで復旧することは未証明。実際は失敗した。
意味:--restartはdocker0確認の代わりにならない。起動順/フックは機種依存で要検証。停電後の信頼性には実再起動と監視が必要。
アプリ例(E1)
Section titled “アプリ例(E1)”未検証:AdGuard Home(53/host)、Home Assistant(USB/host)、NAS(ディスク/権限)、ダウンロード(I/O/VPN)。1つずつ追加。
障害マトリクス
Section titled “障害マトリクス”| 症状 | 確認 | よくある原因 |
|---|---|---|
docker: not found |
パッケージ/PATH | dockerdのみ、dockerなし |
| dockerd起動不可 | logread、ディスク、設定 | data root/kmod/ポート |
| pullタイムアウト | registry/ミラー/DNS | Hub遮断、ミラー停止 |
| 再起動後docker0なし | ip link、サービス順 | ネットワーク/ブリッジ前にdockerd |
| veth Device does not exist | docker0、dockerd restart | 古いbridge/namespace |
| ポート到達不可 | docker ps、firewall | 未公開、WAN/zone |
| OOM | free、docker stats | RAM不足 |
| ディスク満杯 | df、docker system df | イメージ/ログ |
- アプリ/コンテナ停止、ルーターの管理経路を維持。
docker0確認、なければdockerd再起動。docker ps -aとエラー確認。- ストレージを先にマウント。
- 本番で盲目的にpruneしない。
- 不要なら
dockerd stop; dockerd disable。
E2(2026-10-26)
Section titled “E2(2026-10-26)”- OpenWrt 25.12.6 x86 VM 200、Docker 29.6.1、containerd/runc。
- ミラー
docker.m.daocloud.io、hello-world成功。 - Alpineボリューム、nginx 8082成功。
- 再起動後docker0なし、コンテナはveth Device does not existで失敗。
dockerd restartでdocker0復活、新nginx 8082成功。- 未検証:USB/SSD、AGH/HA/NAS、実機、firewall露出、コンテナ自動起動。
出典とレビュー
Section titled “出典とレビュー”プラットフォームのみE2、アプリ/ストレージはE1。独立レビュアーなし。Dockerは攻撃面が大きい。デーモンと不要ポートを露出しない。
出典
独立した OpenWrt の実践ノートです。各ページにファームウェア、デバイス、パッケージマネージャー、元に戻す手順を明記しています。
アイコン:Solar by 480 Design, CC BY 4.0