Zigbee en Home Assistant: coordinador en red separada o VLAN

Publicado el 26-10-2026

Cuando Home Assistant corre en una VLAN IoT o en un servidor separado y el coordinador Zigbee está en otra máquina o segmento de red, los dispositivos Zigbee no llegan a HA de forma automática [1][2]. Esta guía explica las tres opciones para resolver esa separación y detalla el paso a paso de la más habitual: Zigbee2MQTT publicando en un broker MQTT accesible entre redes [2][3].

Para quién es y para quién no

Es para ti si ya tienes Home Assistant funcionando y quieres añadir una red Zigbee cuyo coordinador está en un equipo distinto al que corre HA, o si tienes una instalación con VLANs separadas para IoT y domótica [1][2].

No es para ti en estos casos:

Las tres opciones

Opción A: conectar el coordinador USB directamente al servidor HA

La más sencilla. Si el ZBDongle-E está conectado por USB al mismo equipo que HA, aparece como /dev/ttyUSB0 (o similar) y tanto ZHA como Zigbee2MQTT lo usan sin configuración de red [1][2]. Usa un alargador USB 2.0 de al menos 1 m para reducir interferencias del equipo.

Cuándo NO es posible: cuando el coordinador tiene que estar físicamente lejos del servidor HA (por ejemplo, para mejorar la cobertura de la malla Zigbee) o cuando corre en una Raspberry Pi diferente [2].

Opción B: Zigbee2MQTT en máquina remota + broker MQTT (recomendada para VLANs)

Zigbee2MQTT publica todos los eventos Zigbee en un broker MQTT. HA se conecta al broker por TCP. La red Zigbee vive en la máquina con el coordinador; HA solo necesita alcanzar el broker [2][3].

Este enfoque funciona aunque HA y el coordinador estén en VLANs distintas, siempre que el firewall permita el puerto MQTT (1883 por defecto, o 8883 con TLS) desde la VLAN de HA a la VLAN donde corre el broker [3].

Opción C: ZHA con coordinador remoto vía TCP

ZHA puede conectarse a un coordinador remoto a través de un socket TCP. El software ser2net (o el modo TCP integrado en el ZBBridge Pro) expone el coordinador como un puerto TCP que ZHA usa como si fuera un puerto serie local [1][4]. Requiere acceso TCP desde HA al puerto del coordinador remoto.

Paso a paso: opción B (Zigbee2MQTT + MQTT entre VLANs)

1. Verificar que Zigbee2MQTT publica en el broker correcto

En el fichero configuration.yaml de Zigbee2MQTT (habitualmente en /opt/zigbee2mqtt/data/configuration.yaml):

mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://<IP-del-broker>
  port: 1883

Cambia <IP-del-broker> por la IP o nombre DNS del broker MQTT que HA pueda alcanzar. Reinicia Zigbee2MQTT y comprueba en sus logs que se conecta al broker sin errores [2].

2. Configurar reglas de firewall entre VLANs

Desde la interfaz de tu router o firewall (pfSense, OPNsense, Unifi, etc.), añade una regla que permita:

Si el broker está en el mismo equipo que Zigbee2MQTT, la regla apunta a esa IP. Si el broker está en un equipo separado (por ejemplo, un servidor Mosquitto), la regla apunta a ese servidor [3].

3. Añadir la integración MQTT en Home Assistant

  1. En HA: Configuración → Dispositivos e integraciones → Añadir integración → busca MQTT.
  2. Introduce la IP del broker y el puerto (1883 o 8883).
  3. Si el broker requiere usuario y contraseña, introdúcelos aquí.
  4. HA confirma la conexión; si falla, revisa las reglas de firewall del paso anterior [3].

4. Activar el autodescubrimiento de Zigbee2MQTT

En configuration.yaml de Zigbee2MQTT, verifica que el autodescubrimiento está activo:

homeassistant:
  enabled: true
  discovery_topic: homeassistant
  status_topic: homeassistant/status

Con esto habilitado, cada dispositivo Zigbee aparecer automáticamente en HA en cuanto Zigbee2MQTT lo ve unirse a la red [2][3].

5. Comprobar en HA

Ve a Configuración → Dispositivos e integraciones → MQTT → deberías ver los dispositivos Zigbee ya disponibles. Si un dispositivo no aparece, ve a Desarrollador → MQTT → escucha el topic zigbee2mqtt/# para confirmar que los mensajes llegan [3].

Opción C en detalle: ZHA con ZBBridge Pro remoto

El SONOFF ZBBridge Pro tiene Ethernet y puede actuar como coordinador TCP sin ser2net adicional. Una vez configurado con ZHA en HA:

  1. En los ajustes del ZBBridge Pro, activa el modo Serial over TCP (o verifica la IP y el puerto en la app eWeLink o en la web de administración del bridge).
  2. En HA: Configuración → Dispositivos e integraciones → Zigbee Home Automation → Añadir coordinador → selecciona Enter manually → elige tipo Serial over TCP → introduce tcp://<IP-del-bridge>:<puerto> [1][4].
  3. Añade la regla de firewall: HA necesita alcanzar la IP del ZBBridge Pro en el puerto TCP configurado (por defecto varía según firmware; consulta la documentación de SONOFF) [1].

Troubleshooting

Dispositivos que no aparecen en HA tras configurar MQTT:

ZHA: error "Unable to connect to coordinator":

Dispositivos que se conectan pero no responden:

Compatibilidad

Preguntas frecuentes

¿El ZBDongle-E funciona en red sin ser2net?

No de forma nativa. El ZBDongle-E es un dongle USB; para usarlo en red necesitas ser2net u otro software que exponga el puerto serie por TCP. Si quieres un coordinador con red integrada, el ZBBridge Pro es la alternativa directa [2][4].

¿Necesito abrir puertos en el router para que esto funcione?

No si HA y el broker MQTT están dentro de la misma red local (aunque en VLANs distintas). Solo necesitas reglas de firewall internas entre VLANs, no redireccionamiento de puertos desde internet [3].

¿Puedo tener Zigbee2MQTT y ZHA a la vez?

No en el mismo coordinador al mismo tiempo. Solo un software puede controlar el coordinador. Si quieres ambas integraciones, necesitas dos coordinadores distintos [1][2].

¿Funciona con Home Assistant OS, Supervised o Container?

Las tres opciones de esta guía funcionan en cualquier variante de HA. En HA OS, Zigbee2MQTT y Mosquitto están disponibles como add-ons oficiales. En Container o Supervised, los instalas de forma independiente [2][3].

Fuentes

  1. Home Assistant, ZHA — https://www.home-assistant.io/integrations/zha/ (2026-10-26)
  2. Zigbee2MQTT, guía de instalación — https://www.zigbee2mqtt.io/guide/installation/ (2026-10-26)
  3. Home Assistant, integración MQTT — https://www.home-assistant.io/integrations/mqtt/ (2026-10-26)
  4. SONOFF, ZBBridge Pro — https://sonoff.tech/product/gateway-and-sensors/zbbridge-pro/ (2026-10-26)

Este artículo se ha elaborado con inteligencia artificial y puede contener errores. Si ves alguno, escríbenos a info@comfortek.es y lo corregimos.