Docker en OpenWrt: instalación, almacenamiento, red y recuperación tras reinicio
Estado: E2 para la plataforma Docker en VM. AdGuard Home, Home Assistant, NAS, USB/SSD y reinicio en router real son E1. No ejecutes Docker en un router de 16 MB/128 MB solo porque el paquete exista.
¿Tiene sentido Docker aquí?
Sección titulada «¿Tiene sentido Docker aquí?»Docker necesita RAM (la VM tenía 512 MB), almacenamiento (la raíz se amplió a 2 GB), un data root escribible (/opt/docker), firewall para puertos publicados y un plan para docker0/veth tras reiniciar.
Instalación
Sección titulada «Instalación»apk updateapk add dockerd docker/etc/init.d/dockerd enable/etc/init.d/dockerd startdocker infoSe instaló Docker 29.6.1 en OpenWrt 25.12.6. El paquete trae containerd, runc, kmods y un dockerd grande; revisa espacio.
Espejo de registro (según región)
Sección titulada «Espejo de registro (según región)»Docker Hub dio timeout; un espejo funcionó:
uci add_list dockerd.globals.registry_mirrors='https://docker.m.daocloud.io'uci commit dockerd/etc/init.d/dockerd restartNo es una recomendación universal; usa un espejo de confianza y verifica digests.
Almacenamiento
Sección titulada «Almacenamiento»uci show dockerddocker info | grep -E 'Docker Root Dir|Storage Driver'df -h /opt/opt/dockeren disco real, SSD USB o NVMe, no en overlay pequeño;- monta el almacenamiento antes de Docker;
- revisa
docker system dfy limpia imágenes/containers; - no pongas datos en un FS que desaparece al reiniciar.
Este laboratorio usó la raíz de 2 GB, no USB/SSD: E1.
Red y puertos
Sección titulada «Red y puertos»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:8082Resultados: hello-world corrió, el volumen escribió /tmp/docker-test/hello, nginx sirvió en 8082. En un router real no publiques puertos a WAN por defecto, cuidado con el puerto 53, host networking y el socket/API de Docker.
El fallo de reinicio que importa
Sección titulada «El fallo de reinicio que importa»Tras reboot, Docker arrancó pero faltaba docker0:
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 contenedor nuevo también falló. Recuperación:
/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:8082Tras reiniciar dockerd, docker0 existía y el contenedor nuevo funcionó. No se demostró que --restart unless-stopped sobreviva sin intervención; no lo hizo.
Implicaciones: --restart no sustituye comprobar docker0; el arreglo de orden de arranque es específico del equipo; para fiabilidad tras corte hay que probar un reinicio real y monitorear.
Aplicaciones (E1)
Sección titulada «Aplicaciones (E1)»No probadas: AdGuard Home (53/host), Home Assistant (USB/host), NAS (discos/permisos), descargas (I/O/VPN). Una aplicación a la vez.
Matriz de fallos
Sección titulada «Matriz de fallos»| Síntoma | Revisar | Causa común |
|---|---|---|
docker: not found |
paquete/PATH | solo dockerd; falta docker |
| dockerd no arranca | logread, disco, config | data root/kmod/puerto |
| timeout al pull | registro/espejo/DNS | Hub bloqueado; espejo caído |
| falta docker0 tras reboot | ip link, orden de servicios | dockerd antes de red/bridge |
| veth Device does not exist | docker0, reiniciar dockerd | bridge/namespace obsoleto |
| puerto inaccesible | docker ps, firewall | no publicado; WAN/zone |
| OOM | free, docker stats | poca RAM |
| disco lleno | df, docker system df | imágenes/logs |
Recuperación
Sección titulada «Recuperación»- Para app/contenedor; mantén acceso al router.
- Comprueba
docker0; reinicia dockerd si falta. - Revisa
docker ps -ay el error. - Si falta almacenamiento, monta antes de Docker.
- No hagas prune a ciegas en producción.
- Si no es necesario:
dockerd stop; dockerd disable.
E2 (2026-10-26)
Sección titulada «E2 (2026-10-26)»- OpenWrt 25.12.6 x86 VM 200; Docker 29.6.1; containerd/runc.
- Espejo
docker.m.daocloud.io; hello-world OK. - Volumen Alpine y nginx 8082 OK.
- Reboot: falta docker0; contenedores fallan con veth Device does not exist.
dockerd restart: docker0 vuelve; nginx nuevo en 8082 OK.- Sin USB/SSD, AGH/HA/NAS, router real, exposición de firewall ni autoarranque de contenedores.
Fuentes y revisión
Sección titulada «Fuentes y revisión»E2 solo de plataforma; apps/almacenamiento E1. Sin revisor independiente. Docker es una superficie de ataque grande; no expongas el daemon ni puertos innecesarios.
Fuentes
Notas independientes sobre OpenWrt. Cada página indica el firmware, el dispositivo, el gestor de paquetes y la vía de retorno.
Iconos: Solar by 480 Design, CC BY 4.0