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.
Docker est-il adapté ?
Section intitulée « Docker est-il adapté ? »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.
Installation
Section intitulée « Installation »apk updateapk add dockerd docker/etc/init.d/dockerd enable/etc/init.d/dockerd startdocker infoDocker 29.6.1 sur OpenWrt 25.12.6. Le paquet tire containerd, runc, kmods et un gros dockerd ; vérifier l’espace.
Miroir de registre (selon région)
Section intitulée « Miroir de registre (selon région) »Docker Hub a expiré ; un miroir a fonctionné :
uci add_list dockerd.globals.registry_mirrors='https://docker.m.daocloud.io'uci commit dockerd/etc/init.d/dockerd restartPas une recommandation universelle ; miroir de confiance et vérification des digests.
Stockage
Section intitulée « Stockage »uci show dockerddocker info | grep -E 'Docker Root Dir|Storage Driver'df -h /opt/opt/dockersur disque réel, SSD USB ou NVMe, pas sur un petit overlay ;- monter le stockage avant Docker ;
docker system dfet 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.
Réseau et ports
Section intitulée « Réseau et ports »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:8082Ré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.
L’échec de redémarrage important
Section intitulée « L’échec de redémarrage important »Après reboot, Docker démarre mais docker0 manque :
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 existUn nouveau conteneur échoue aussi. Récupération :
/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:8082Aprè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.
Applications (E1)
Section intitulée « Applications (E1) »Non testés : AdGuard Home (53/host), Home Assistant (USB/host), NAS (disques/droits), téléchargements (I/O/VPN). Une app à la fois.
Matrice des pannes
Section intitulée « Matrice des pannes »| 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 |
Récupération
Section intitulée « Récupération »- Arrêter l’app/le conteneur ; garder le routeur accessible.
- Vérifier
docker0; redémarrer dockerd si absent. - Lire
docker ps -aet l’erreur. - Remonter le stockage avant Docker.
- Pas de prune aveugle en production.
- Si inutile :
dockerd stop; dockerd disable.
E2 (2026-10-26)
Section intitulée « E2 (2026-10-26) »- 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.
Sources et relecture
Section intitulée « Sources et relecture »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
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