Zigbee2MQTT te permite controlar bombillas, sensores y enchufes Zigbee de cualquier marca desde un único punto, sin depender del hub propietario del fabricante. Solo necesitas un adaptador USB (un coordinador) y un dispositivo que ejecute el software, normalmente una Raspberry Pi o un mini PC. A partir de ahí, todos tus dispositivos hablan el mismo idioma. Esta guía de Zigbee2MQTT te explica qué es, qué necesitas y cómo ponerlo en marcha paso a paso.
Qué es Zigbee2MQTT y por qué importa
Zigbee2MQTT es un proyecto de código abierto, creado por Koen Kanters en 2018, que traduce los mensajes del protocolo Zigbee al protocolo MQTT. En la práctica, hace de puente entre tus dispositivos y tu sistema domótico (como Home Assistant o Node-RED).
El protocolo Zigbee lo mantiene la Connectivity Standards Alliance (antes Zigbee Alliance), la misma organización detrás del estándar Matter. Es una tecnología de radio de bajo consumo que funciona en la banda de 2,4 GHz y crea redes en malla: cada dispositivo enchufado actúa como repetidor y amplía el alcance.
El problema que resuelve es conocido. Compras una bombilla Philips Hue, un sensor Aqara y un enchufe Sonoff, y cada uno te pide su propio hub. Tres puentes, tres aplicaciones, tres puntos de fallo. Con Zigbee sin hub propietario, un solo coordinador gestiona los tres.
Qué necesitas para usar Zigbee sin hub propietario
El montaje es más sencillo de lo que parece. Estos son los componentes básicos:
- Un coordinador Zigbee (adaptador USB). Es la pieza clave. Modelos recomendados: Sonoff Zigbee 3.0 USB Dongle Plus (el modelo Plus usa el chip Texas Instruments CC2652P; la variante Plus E, el Silicon Labs EFR32MG21) o el SLZB-06 de SMLIGHT, que se conecta por red Ethernet o WiFi. Ver en Amazon
- Un equipo que ejecute el software. Una Raspberry Pi 4, un mini PC o cualquier máquina con Docker. Ver en Amazon
- Un broker MQTT. El estándar es Mosquitto, gratuito y ligero.
- Un cable alargador USB. Parece un detalle menor, pero alejar el coordinador del equipo reduce las interferencias del USB 3.0 y mejora muchísimo la cobertura.
Un consejo de quien lo ha montado varias veces: no escatimes en el coordinador ni en su ubicación. La mayoría de los problemas de estabilidad vienen de un adaptador pegado a un puerto USB 3.0 o a un disco SSD.
Zigbee2MQTT, Home Assistant ZHA y los hubs propietarios
Antes de instalar, conviene saber qué alternativas tienes. ZHA es la integración Zigbee nativa de Home Assistant; Zigbee2MQTT es independiente y compatible con casi cualquier sistema. Esta tabla resume las diferencias:
| Solución | Características clave | Compatibilidad | Precio orientativo | Valoración |
|---|---|---|---|---|
| Zigbee2MQTT | Soporte de más de 4.000 dispositivos, web UI propia, mapa de red, actualizaciones OTA | Home Assistant, Node-RED, Domoticz, cualquier sistema con MQTT | Gratis (software) | ★★★★★ |
| ZHA (Home Assistant) | Integración nativa, sin broker MQTT, configuración rápida | Solo Home Assistant | Gratis (software) | ★★★★☆ |
| Philips Hue Bridge | Estable y pulido, pero cerrado a su ecosistema | Limitada a dispositivos certificados Hue / Friends of Hue | En torno a 50-60 € | ★★★☆☆ |
| Aqara Hub | Sencillo, dependiente de la nube del fabricante | Principalmente dispositivos Aqara | Aproximadamente 30-60 € | ★★★☆☆ |
La gran ventaja de Zigbee sin hub propietario es la independencia: todo funciona en local, sin depender de servidores en la nube que el fabricante puede apagar. Si te preocupa que tus dispositivos hablen entre sí, te interesa nuestra guía sobre cómo evitar problemas de compatibilidad entre dispositivos domóticos.
Cómo instalar Zigbee2MQTT paso a paso
Vamos al grano. Estos son los pasos para instalar Zigbee2MQTT con Docker, el método más limpio y portable. Si usas Home Assistant OS, existe un complemento (add-on) que automatiza casi todo.
- Conecta el coordinador. Enchufa el dongle USB (con su alargador) al equipo. En Linux, identifica el puerto con el comando ls -l /dev/serial/by-id. Apunta la ruta que aparezca; la necesitarás luego.
- Instala el broker MQTT. Despliega Mosquitto, ya sea como contenedor Docker o como complemento de Home Assistant. Crea un usuario y una contraseña para asegurarlo.
- Crea el archivo de configuración. En una carpeta como /opt/zigbee2mqtt/data, edita el archivo configuration.yaml. Indica la dirección de tu broker MQTT, las credenciales y la ruta del coordinador que apuntaste antes.
- Lanza el contenedor. Arranca la imagen oficial koenkk/zigbee2mqtt con Docker o Docker Compose, montando la carpeta de datos y dando acceso al dispositivo USB.
- Abre la interfaz web. Accede a http://IP-del-equipo:8080. Verás el panel de control de Zigbee2MQTT, el mapa de red y la lista de dispositivos.
- Activa el emparejamiento. Pulsa el botón Permit join, pon tu dispositivo Zigbee en modo de vinculación (normalmente manteniendo un botón unos segundos) y espera a que aparezca. Repite con cada aparato.
- Conéctalo a tu sistema domótico. En Home Assistant, la integración MQTT detecta automáticamente los dispositivos gracias al descubrimiento MQTT discovery. Ya puedes crear automatizaciones.
Recomendación práctica: empareja primero los dispositivos enchufados a la corriente (enchufes, bombillas) y luego los de batería (sensores). Así construyes una malla sólida antes de añadir los nodos finales.
Una vez funcionando, todo queda en tu red local. Para sacarle partido, combina sensores Zigbee con automatizaciones de energía como las que vemos en nuestra guía de paneles solares y gestión inteligente de energía, o mide el consumo real de tus aparatos con enchufes inteligentes con medición de consumo.
Errores comunes al configurar Zigbee2MQTT
Estos son los tropiezos que más se repiten, según la documentación oficial y la comunidad:
- Interferencias con el WiFi. Zigbee y WiFi comparten la banda de 2,4 GHz. Si tu red Zigbee es inestable, cambia el canal de tu router o del coordinador para evitar solapamientos.
- Coordinador demasiado cerca del equipo. El ruido electromagnético del USB 3.0 degrada la señal. Usa siempre el alargador.
- Dispositivos de marca con firmware bloqueado. Algunos aparatos esperan su hub original. La lista de compatibilidad de Zigbee2MQTT te dice de antemano si el tuyo funciona.
- Pocos repetidores. Si tienes muchos sensores a batería y pocos dispositivos enchufados, la malla se debilita. Añade enchufes o bombillas Zigbee para reforzarla.
Si prefieres iluminación que funcione sin montar nada de esto, también puedes optar por bombillas inteligentes que no necesitan hub ni puente. Cada enfoque tiene su lugar.
Preguntas frecuentes
¿Es Zigbee2MQTT difícil de instalar para un principiante?
Requiere algo más de configuración inicial que un hub comercial, pero los complementos de Home Assistant simplifican mucho el proceso. Con el dongle adecuado y la guía paso a paso, una instalación básica se completa en menos de una hora.
¿Necesito Internet para que funcione Zigbee2MQTT?
No. Todo se ejecuta en local, en tu propio equipo. La conexión a Internet solo hace falta para descargar el software, actualizar dispositivos por OTA o para acceder en remoto. Tus automatizaciones siguen funcionando aunque se caiga tu conexión.
¿Qué adaptador Zigbee es mejor para empezar?
El Sonoff Zigbee 3.0 USB Dongle Plus es la opción más recomendada por relación calidad-precio y compatibilidad. Si quieres colocar el coordinador lejos del equipo, el SLZB-06 de SMLIGHT funciona por red Ethernet o WiFi.
¿Puedo mezclar dispositivos Zigbee de marcas diferentes?
Sí, y esa es la principal ventaja. Zigbee2MQTT soporta más de 4.000 dispositivos de cientos de fabricantes. Puedes combinar bombillas Philips Hue, sensores Aqara y enchufes Sonoff en la misma red sin sus hubs originales.
¿Qué diferencia hay entre Zigbee y Matter?
Zigbee es un protocolo de radio; Matter es un estándar de aplicación que puede funcionar sobre WiFi, Ethernet o Thread. Ambos los impulsa la Connectivity Standards Alliance. Por ahora, Zigbee tiene un catálogo de dispositivos mucho más amplio y maduro.
El siguiente paso
Pide hoy un Sonoff Zigbee 3.0 USB Dongle Plus con su cable alargador USB y conéctalo a la Raspberry Pi o al mini PC que ya tengas en casa. Ver en Amazon. Con ese adaptador y la guía de Zigbee2MQTT de arriba, tendrás tu primera red Zigbee independiente funcionando esta misma tarde.
Contenido elaborado por el equipo editorial de Piqture Group (piqture.cat). ¿Montas proyectos de domótica y necesitas una solución de inteligencia artificial a medida para tu empresa o una página web profesional? Podemos ayudarte.
