Aller au contenu

Docker sur OpenWrt : installation, stockage, réseau et récupération après redémarrage

État : E2 pour la plateforme Docker sur VM. AdGuard Home, Home Assistant, NAS, USB/SSD et redémarrage sur routeur réel sont E1. Pas de Docker sur un routeur 16 Mo/128 Mo juste parce que le paquet existe.

Il faut de la RAM (VM : 512 Mo), du stockage (racine portée à 2 Go), un data root inscriptible (/opt/docker), un plan firewall pour les ports publiés et une récupération pour docker0/veth après redémarrage.

Fenêtre de terminal
apk update
apk add dockerd docker
/etc/init.d/dockerd enable
/etc/init.d/dockerd start
docker info

Docker 29.6.1 sur OpenWrt 25.12.6. Le paquet tire containerd, runc, kmods et un gros dockerd ; vérifier l’espace.

Docker Hub a expiré ; un miroir a fonctionné :

Fenêtre de terminal
uci add_list dockerd.globals.registry_mirrors='https://docker.m.daocloud.io'
uci commit dockerd
/etc/init.d/dockerd restart

Pas une recommandation universelle ; miroir de confiance et vérification des digests.

Fenêtre de terminal
uci show dockerd
docker info | grep -E 'Docker Root Dir|Storage Driver'
df -h /opt
  • /opt/docker sur disque réel, SSD USB ou NVMe, pas sur un petit overlay ;
  • monter le stockage avant Docker ;
  • docker system df et nettoyage des images/conteneurs ;
  • pas de données sur un FS qui disparaît au redémarrage.

Ce labo a utilisé la racine de 2 Go, pas USB/SSD : E1.

Fenêtre de terminal
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

Résultats : hello-world OK, volume écrit /tmp/docker-test/hello, nginx sur 8082. Sur routeur réel : pas de ports vers WAN par défaut, attention au port 53, au réseau host et au socket/API Docker.

Après reboot, Docker démarre mais docker0 manque :

Fenêtre de terminal
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

Un nouveau conteneur échoue aussi. Récupération :

Fenêtre de terminal
/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

Après dockerd restart, docker0 existe et le nouveau conteneur fonctionne. Pas prouvé : --restart unless-stopped survit sans intervention ; ce n’était pas le cas.

Conséquences : --restart ne remplace pas la vérification de docker0 ; l’ordre de démarrage est spécifique ; pour la fiabilité après coupure, tester un vrai redémarrage et surveiller.

Non testés : AdGuard Home (53/host), Home Assistant (USB/host), NAS (disques/droits), téléchargements (I/O/VPN). Une app à la fois.

Symptôme Vérifier Cause fréquente
docker: not found paquet/PATH seul dockerd ; docker manque
dockerd ne démarre pas logread, disque, config data root/kmod/port
timeout de pull registre/miroir/DNS Hub bloqué ; miroir HS
docker0 absent après reboot ip link, ordre des services dockerd avant réseau/bridge
veth Device does not exist docker0, restart dockerd bridge/namespace obsolète
port inaccessible docker ps, firewall non publié ; WAN/zone
OOM free, docker stats RAM insuffisante
disque plein df, docker system df images/logs
  1. Arrêter l’app/le conteneur ; garder le routeur accessible.
  2. Vérifier docker0 ; redémarrer dockerd si absent.
  3. Lire docker ps -a et l’erreur.
  4. Remonter le stockage avant Docker.
  5. Pas de prune aveugle en production.
  6. Si inutile : dockerd stop; dockerd disable.
  • OpenWrt 25.12.6 x86 VM 200 ; Docker 29.6.1 ; containerd/runc.
  • Miroir docker.m.daocloud.io ; hello-world OK.
  • Volume Alpine et nginx 8082 OK.
  • Reboot : docker0 absent ; conteneurs échouent avec veth Device does not exist.
  • dockerd restart : docker0 revient ; nouveau nginx sur 8082 OK.
  • Non testé : USB/SSD, AGH/HA/NAS, routeur réel, exposition firewall, auto-start des conteneurs.

E2 plateforme seulement ; apps/stockage E1. Pas de relecteur indépendant. Docker est une grande surface d’attaque ; ne pas exposer le démon ni les ports inutiles.

Sources

Router.Homes

Notes indépendantes sur OpenWrt. Chaque page précise le firmware, l’appareil, le gestionnaire de paquets et le retour arrière.

Icônes : Solar by 480 Design, CC BY 4.0