Zum Inhalt springen

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.

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.

Terminal-Fenster
apk update
apk add dockerd docker
/etc/init.d/dockerd enable
/etc/init.d/dockerd start
docker info

Installiert: Docker 29.6.1 auf OpenWrt 25.12.6. Das Paket zieht containerd, runc, kmods und ein großes dockerd; vorher Speicher prüfen.

Docker Hub lief in eine Zeitüberschreitung; ein Mirror half:

Terminal-Fenster
uci add_list dockerd.globals.registry_mirrors='https://docker.m.daocloud.io'
uci commit dockerd
/etc/init.d/dockerd restart

Keine allgemeine Empfehlung; vertrauenswürdigen Mirror nutzen und Digests prüfen.

Terminal-Fenster
uci show dockerd
docker info | grep -E 'Docker Root Dir|Storage Driver'
df -h /opt
  • /opt/docker auf echter Disk, USB-SSD oder NVMe, nicht auf kleinem Overlay;
  • Speicher vor Docker mounten;
  • docker system df prü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.

Terminal-Fenster
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

Ergebnisse: 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.

Nach reboot startete Docker, aber docker0 fehlte:

Terminal-Fenster
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

Auch ein neuer Container scheiterte. Recovery:

Terminal-Fenster
/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

Nach 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.

Nicht getestet: AdGuard Home (53/host), Home Assistant (USB/host), NAS (Disks/Rechte), Downloads (I/O/VPN). Eine App nach der anderen.

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
  1. App/Container stoppen; Router erreichbar halten.
  2. docker0 prüfen; dockerd neu starten.
  3. docker ps -a und Fehler prüfen.
  4. Speicher zuerst mounten.
  5. Kein blindes Prune auf Produktion.
  6. Wenn nicht nötig: dockerd stop; dockerd disable.
  • 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.

Nur Plattform-E2; Apps/Speicher E1. Kein unabhängiger Reviewer. Docker ist große Angriffsfläche; Daemon und unnötige Ports nicht exponieren.

Quellen

Router.Homes

Unabhängige OpenWrt-Notizen. Jede Seite nennt Firmware, Gerät, Paketmanager und den Rückweg.

Symbole: Solar by 480 Design, CC BY 4.0