Docker auf OpenWrt: Installation, Speicher, Netzwerk und Recovery nach Neustart
Status: E2 für die Docker-Plattform auf einer VM. AdGuard Home, Home Assistant, NAS, USB/SSD und echter Router-Neustart sind E1. Kein Docker auf 16 MB/128 MB-Routern nur weil das Paket existiert.
Passt Docker hier?
Abschnitt betitelt „Passt Docker hier?“Docker braucht RAM (VM: 512 MB), Speicher (Root auf 2 GB erweitert), ein beschreibbares Data-Root (/opt/docker), Firewall-Regeln für veröffentlichte Ports und einen Plan für docker0/veth nach Neustart.
Installation
Abschnitt betitelt „Installation“apk updateapk add dockerd docker/etc/init.d/dockerd enable/etc/init.d/dockerd startdocker infoInstalliert: Docker 29.6.1 auf OpenWrt 25.12.6. Das Paket zieht containerd, runc, kmods und ein großes dockerd; vorher Speicher prüfen.
Registry-Mirror (regional)
Abschnitt betitelt „Registry-Mirror (regional)“Docker Hub lief in eine Zeitüberschreitung; ein Mirror half:
uci add_list dockerd.globals.registry_mirrors='https://docker.m.daocloud.io'uci commit dockerd/etc/init.d/dockerd restartKeine allgemeine Empfehlung; vertrauenswürdigen Mirror nutzen und Digests prüfen.
Speicher
Abschnitt betitelt „Speicher“uci show dockerddocker info | grep -E 'Docker Root Dir|Storage Driver'df -h /opt/opt/dockerauf echter Disk, USB-SSD oder NVMe, nicht auf kleinem Overlay;- Speicher vor Docker mounten;
docker system dfprüfen und Unbenutztes löschen;- keine Daten auf ein FS, das beim Neustart verschwindet.
Dieses Labor nutzte die 2-GB-Root, nicht USB/SSD: E1.
Netzwerk und Ports
Abschnitt betitelt „Netzwerk und 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:8082Ergebnisse: hello-world lief, Volume schrieb /tmp/docker-test/hello, nginx antwortete auf 8082. Auf echtem Router keine Ports standardmäßig ins WAN, Port 53 beachten, host-Netzwerk und Docker-Socket/API nicht exponieren.
Der wichtige Neustart-Fehler
Abschnitt betitelt „Der wichtige Neustart-Fehler“Nach reboot startete Docker, aber docker0 fehlte:
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 existAuch ein neuer Container scheiterte. Recovery:
/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:8082Nach dockerd restart existierte docker0, der neue Container lief. Nicht bewiesen: --restart unless-stopped überlebt einen Neustart ohne Eingriff; tat es nicht.
Folgen: --restart ersetzt keine docker0-Prüfung; Boot-Hook/Service-Reihenfolge ist gerätespezifisch; für Stromausfall-Festigkeit echten Neustart testen und überwachen.
Anwendungen (E1)
Abschnitt betitelt „Anwendungen (E1)“Nicht getestet: AdGuard Home (53/host), Home Assistant (USB/host), NAS (Disks/Rechte), Downloads (I/O/VPN). Eine App nach der anderen.
Fehlermatrix
Abschnitt betitelt „Fehlermatrix“| Symptom | Prüfen | Häufige Ursache |
|---|---|---|
docker: not found |
Paket/PATH | nur dockerd; docker fehlt |
| dockerd startet nicht | logread, Disk, Config | Data-Root/kmod/Port |
| Pull-Timeout | Registry/Mirror/DNS | Hub blockiert; Mirror down |
| docker0 nach Reboot weg | ip link, Dienstreihenfolge | dockerd vor Netz/Bridge |
| veth Device does not exist | docker0, dockerd restart | alte Bridge/Namespace |
| Port nicht erreichbar | docker ps, Firewall | nicht veröffentlicht; WAN/Zone |
| OOM | free, docker stats | zu wenig RAM |
| Disk voll | df, docker system df | Images/Logs |
Recovery
Abschnitt betitelt „Recovery“- App/Container stoppen; Router erreichbar halten.
docker0prüfen; dockerd neu starten.docker ps -aund Fehler prüfen.- Speicher zuerst mounten.
- Kein blindes Prune auf Produktion.
- Wenn nicht nötig:
dockerd stop; dockerd disable.
E2-Lauf (2026-10-26)
Abschnitt betitelt „E2-Lauf (2026-10-26)“- OpenWrt 25.12.6 x86 VM 200; Docker 29.6.1; containerd/runc.
- Mirror
docker.m.daocloud.io; hello-world OK. - Alpine-Volume und nginx 8082 OK.
- Reboot: docker0 fehlt; Container scheitern mit veth Device does not exist.
dockerd restart: docker0 zurück; neuer nginx auf 8082 OK.- Nicht getestet: USB/SSD, AGH/HA/NAS, echter Router, Firewall-Exposition, Container-Autostart.
Quellen und Review
Abschnitt betitelt „Quellen und Review“Nur Plattform-E2; Apps/Speicher E1. Kein unabhängiger Reviewer. Docker ist große Angriffsfläche; Daemon und unnötige Ports nicht exponieren.
Quellen
Unabhängige OpenWrt-Notizen. Jede Seite nennt Firmware, Gerät, Paketmanager und den Rückweg.
Symbole: Solar by 480 Design, CC BY 4.0