Cómo montar un clúster de Raspberry Pi con Docker

Última actualización: 9 de septiembre de 2026
  • Instalación y optimización de Docker y Docker Compose en placas SBC.
  • Configuración de red avanzada mediante hotspots y gestión de DNS/DHCP.
  • Implementación de orquestación de contenedores utilizando Docker Swarm.
  • Administración centralizada del clúster a través de la interfaz de Portainer.

Primer plano de una placa Raspberry Pi en una carcasa transparente, ideal para ilustrar el hardware necesario para el clúster.

¿Te has planteado alguna vez tener tu propio centro de datos en miniatura sin dejarte un dineral en hardware profesional? Pues bien, montar un clúster con Raspberry Pi y Docker es la forma más divertida y barata de meterse en el mundo de la orquestación de contenedores y el cómputo distribuido, ideal para experimentar en casa con proyectos que normalmente requerirían servidores carísimos.

La gracia de este montaje es que puedes aprovechar placas pequeñas como la Raspberry Pi o incluso otras SBC como Orange Pi o Banana Pi para crear un entorno donde las aplicaciones se repartan la carga de trabajo. Es un proyecto perfecto para aprender sobre alta disponibilidad y escalabilidad sin miedo a romper nada crítico, ya que todo ocurre en tu propia red local.

seguridad homelab open source
Related article:
Seguridad en tu homelab con herramientas open source

Preparando el terreno y el hardware

Manos ajustando una placa de microcontrolador, representando la fase de montaje y preparación del hardware DIY.

Para empezar con buen pie, lo ideal es usar versiones de sistema operativo ligeras, como Raspbian Lite o Armbian (en el caso de Orange Pi), ya que no necesitamos interfaz gráfica y queremos dedicar cada mega de RAM al procesamiento. Un truco muy útil es flashear las imágenes usando Etcher para evitar errores de escritura en las tarjetas microSD.

Si no quieres estar peleándote con monitores y teclados USB para cada placa, puedes usar un adaptador USB a Serie conectado a los pines RX y TX. Configurando el archivo config.txt en la partición de boot añadiendo enable_uart=1, podrás gestionar todo mediante una consola serial con programas como Putty en Windows o Minicom en Linux, lo cual es mucho más cómodo que andar cambiando cables HDMI.

  Error 404 Not Found: qué es, causas, impacto en tu web y cómo solucionarlo

Optimización del sistema y red

Desarrollador escribiendo código en un teclado con la pantalla mostrando scripts, perfecto para la sección de instalación de Docker.

Antes de instalar Docker, conviene dejar el sistema a punto. Es fundamental actualizar todo con sudo apt update y sudo apt upgrade -y. Para ahorrar recursos, puedes limitar la memoria dedicada al vídeo en el archivo de configuración, poniendo gpu_mem=16, así dejamos que la mayor parte de la RAM se use para los contenedores.

hardening homelab vlan
Related article:
Hardening de homelab con VLAN: guía completa de seguridad en casa

En cuanto a la red, si quieres que tu Raspberry actúe como nodo maestro y gestione a las demás, puedes sustituir el gestor dhcpcd por NetworkManager, que es mucho más robusto. Para crear una red propia para el clúster, se puede instalar dnsmasq para gestionar el DHCP y DNS, y hostapd para convertir la Pi en un punto de acceso WiFi (hotspot) donde se conecten los demás nodos.

Instalación de Docker y Docker Compose

Monitor de ordenador mostrando datos de ciberseguridad y líneas de código, útil para ilustrar la orquestación y gestión del clúster.

Instalar Docker en una Raspberry Pi 4 es pan comido porque tiene soporte oficial. El método más rápido es ejecutar el script automático de instalación mediante un comando curl que descarga y configura todo el motor de Docker. Para evitar tener que escribir sudo en cada comando, es recomendable añadir el usuario al grupo de Docker, aunque hay que tener ojo con la seguridad ya que esto da privilegios elevados.

Una vez instalado el motor, es imprescindible añadir Docker Compose, que nos permite definir aplicaciones multicontenedor mediante un archivo YAML. Se puede instalar fácilmente a través de pip, el gestor de paquetes de Python. Para comprobar que todo va viento en popa, basta con lanzar la imagen de hello-world y verificar que el contenedor se ejecuta correctamente.

  ¿Qué es Scrum y para qué sirve?

Orquestación con Docker Swarm

Entorno de trabajo tecnológico con portátil y placas de circuito sobre la mesa, evocando el concepto de 'home lab' o laboratorio casero.

Cuando ya tienes Docker en todas tus placas, llega el momento de unirlas en un clúster de Docker Swarm. Swarm es la herramienta nativa de Docker para convertir un grupo de nodos en un único recurso virtual. Solo necesitas iniciar el modo Swarm en el nodo maestro y luego unir los nodos trabajadores (workers) mediante el token de seguridad proporcionado.

Docker Swarm edge
Related article:
Docker Swarm y Portainer Edge para despliegues en el edge

Para gestionar todo este despliegue de forma visual y sin volverse loco con la terminal, es muy recomendable instalar Portainer para gestionar tus contenedores Docker. Esta herramienta nos ofrece una interfaz web donde podemos ver el estado de los servicios, los nodos activos y gestionar los contenedores con un par de clics, haciendo que la administración del clúster sea mucho más intuitiva.

Trucos avanzados y conectividad

Si te encuentras en un entorno con restricciones de red o bloqueos, puedes montar un túnel OpenVPN en el nodo maestro. Esto permite que todo el tráfico del clúster salga a internet a través de la VPN, saltándose proxies o cortafuegos. Para gestionar el tráfico entre las redes del Swarm y tu red local, herramientas como Firehol ayudan a crear reglas de iptables de forma más humana y sencilla.

Otro detalle crítico es la hora del sistema. Como las Raspberry Pi no tienen reloj de tiempo real (RTC), pierden la fecha al apagarse. Lo ideal es instalar un módulo RTC físico (como el DS3231) o configurar un servidor NTP en la red local para que todos los nodos estén sincronizados, algo vital para que los logs y los certificados de seguridad funcionen bien.

  Testing automatizado para modelos de IA: técnicas, herramientas y buenas prácticas

Configurar un ecosistema de este tipo permite transformar unas cuantas placas sencillas en una potente herramienta de aprendizaje donde se puede desplegar desde servidores web hasta sistemas de cálculo distribuido, integrando la gestión de red, la seguridad mediante túneles y la orquestación de contenedores en un solo entorno controlado.

monitor de sistema avanzado para linux
Related article:
Monitor de sistema avanzado para Linux: guía completa