Ir al contenido

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.

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.

Ventana de terminal
apk update
apk add dockerd docker
/etc/init.d/dockerd enable
/etc/init.d/dockerd start
docker info

Se instaló Docker 29.6.1 en OpenWrt 25.12.6. El paquete trae containerd, runc, kmods y un dockerd grande; revisa espacio.

Docker Hub dio timeout; un espejo funcionó:

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

No es una recomendación universal; usa un espejo de confianza y verifica digests.

Ventana de terminal
uci show dockerd
docker info | grep -E 'Docker Root Dir|Storage Driver'
df -h /opt
  • /opt/docker en disco real, SSD USB o NVMe, no en overlay pequeño;
  • monta el almacenamiento antes de Docker;
  • revisa docker system df y 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.

Ventana 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

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

Tras reboot, Docker arrancó pero faltaba docker0:

Ventana 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 contenedor nuevo también falló. Recuperación:

Ventana 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

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

No probadas: AdGuard Home (53/host), Home Assistant (USB/host), NAS (discos/permisos), descargas (I/O/VPN). Una aplicación a la vez.

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
  1. Para app/contenedor; mantén acceso al router.
  2. Comprueba docker0; reinicia dockerd si falta.
  3. Revisa docker ps -a y el error.
  4. Si falta almacenamiento, monta antes de Docker.
  5. No hagas prune a ciegas en producción.
  6. Si no es necesario: dockerd stop; dockerd disable.
  • 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.

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

Router.Homes

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