コンテンツにスキップ

OpenWrt の Docker:インストール、ストレージ、ネットワーク、再起動後の復旧

状態: VM上のDockerプラットフォームはE2。AdGuard Home、Home Assistant、NAS、USB/SSD、実機ルーター再起動はE1。16MB/128MBルーターにパッケージがあるだけでDockerを入れない。

RAM(VMは512MB)、ストレージ(ルートを2GBに拡張)、書き込み可能なdata root(/opt/docker)、公開ポートのfirewall、再起動後のdocker0/veth復旧計画が必要。

ターミナルウィンドウ
apk update
apk add dockerd docker
/etc/init.d/dockerd enable
/etc/init.d/dockerd start
docker info

OpenWrt 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 dockerd
docker 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。

ターミナルウィンドウ
ip link show docker0
docker run --rm hello-world
docker 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:alpine
curl -sS http://127.0.0.1:8082

結果:hello-world成功、ボリュームが/tmp/docker-test/helloを書き込み、nginxが8082で応答。実機ではWANへデフォルト公開しない、53ポート、hostネットワーク、Docker socket/APIの露出に注意。

reboot後、Dockerは起動したがdocker0がない:

ターミナルウィンドウ
ip link show docker0
# Device "docker0" does not exist
docker 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 restart
ip link show docker0
docker run -d --name rh-test-http3 -p 8082:80 nginx:alpine
curl -sS http://127.0.0.1:8082

dockerd restart後にdocker0が戻り、新規コンテナが動作。--restart unless-stoppedが再起動後に人手なしで復旧することは未証明。実際は失敗した。

意味:--restartはdocker0確認の代わりにならない。起動順/フックは機種依存で要検証。停電後の信頼性には実再起動と監視が必要。

未検証:AdGuard Home(53/host)、Home Assistant(USB/host)、NAS(ディスク/権限)、ダウンロード(I/O/VPN)。1つずつ追加。

症状 確認 よくある原因
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 イメージ/ログ
  1. アプリ/コンテナ停止、ルーターの管理経路を維持。
  2. docker0確認、なければdockerd再起動。
  3. docker ps -aとエラー確認。
  4. ストレージを先にマウント。
  5. 本番で盲目的にpruneしない。
  6. 不要ならdockerd stop; dockerd disable。
  • 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露出、コンテナ自動起動。

プラットフォームのみE2、アプリ/ストレージはE1。独立レビュアーなし。Dockerは攻撃面が大きい。デーモンと不要ポートを露出しない。

出典

Router.Homes

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

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