Migrar de coordinador Zigbee USB a SLZB-06 en Zigbee2MQTT sin volver a emparejar

Última revisión: 31/08/2026 · Tiempo estimado: 40-60 minutos · Dificultad: media

Si tu coordinador Zigbee cuelga de un puerto USB del servidor, el ruido eléctrico, el cable y la posición del equipo condicionan la red. El SLZB-06 de SMLight se conecta por Ethernet y se coloca donde la cobertura manda. El cambio no obliga a volver a emparejar todos los dispositivos, siempre que el chip del coordinador nuevo use el mismo stack que el viejo. Aquí está el proceso exacto.

La migración no toca los dispositivos: cambia únicamente el equipo que coordina la red.

Qué cambia y qué no

Cambias el coordinador, no la red. Los mismos sensores, bombillas y nombres de entidad siguen existiendo. Lo que se conserva es la clave de red si restauras el backup; por eso el paso 1 no se salta.

Compatibilidad real de stacks

La pista más importante viene de ProgramarFácil (junio de 2026): el Dongle E usa adapter: ember, y el Dongle P o el SLZB-06/06U usan adapter: zstack. Si cambias de un stack a otro, la migración directa no está soportada de forma oficial por Zigbee2MQTT y toca volver a emparejar.

Compatibilidad según el coordinador actual
Coordinador actual	Adapter en Z2M	¿Se puede migrar a SLZB-06?
Sonoff Dongle P	zstack	Sí, restaurando backup
SLZB-06 / 06U	zstack	Sí, es el mismo stack
Sonoff Dongle E	ember	No de forma directa; hay que reparar

Paso 1: haz backup de Zigbee2MQTT

En la interfaz de Zigbee2MQTT, entra en Settings → Maintenance y usa la opción Backup. Guarda el archivo generado en un sitio que no esté dentro del propio servidor que vas a tocar. Un backup de red Zigbee vale para restaurar en el nuevo coordinador solo si se mantiene el mismo stack.

Paso 2: prepara el SLZB-06

Sigue el manual del fabricante para conectar el SLZB-06 a la red y acceder a su interfaz web. Déjale una IP fija desde el DHCP del router; si cambia mañana, Zigbee2MQTT pierde el puerto serie y la red deja de funcionar hasta que corrijas la IP.

Confirma en la interfaz del SLZB-06 que el modo es Zigbee Coordinator y que el firmware del chip es el que corresponde a tu modelo. La IP y el puerto que vas a usar aparecen en la misma página.

Paso 3: cambia el serial en configuration.yaml

Sustituye el serial antiguo por la conexión TCP del nuevo coordinador. Este es el bloque completo que deja una instalación típica de Home Assistant con MQTT ya funcionando:

homeassistant: true
permit_join: false
mqtt:
  server: mqtt://core-mosquitto:1883
  user: mqtt-user
  password: 'cambia-esta'
serial:
  port: tcp://192.168.1.50:6638
  adapter: zstack
advanced:
  log_level: info

Cambia 192.168.1.50 por la IP real del SLZB-06. No dejes permit_join: true salvo durante una reparación puntual.

Paso 4: restaura el backup

Con el nuevo serial en marcha, vuelve a Settings → Maintenance y restaura el backup del paso 1. Si la restauración acaba sin error, la red completa vuelve a verse con los mismos nombres y entidades. No desenchufes el dongle viejo todavía.

Paso 5: verifica antes de retirar el dongle viejo

Prueba dos o tres dispositivos de batería y otros dos de alimentación constante. En la página de dispositivos de Zigbee2MQTT tienen que aparecer conectados con el nuevo coordinador. Deja pasar unas horas, revisa el log de Zigbee2MQTT y solo entonces retira el dongle USB anterior.

Errores que se repiten

Adapter equivocado: pegar adapter: ember cuando el chip es zstack, o al revés, impide arrancar Z2M. Revisa el chip de tu modelo.
IP dinámica: funciona hoy y muere mañana. Reserva la dirección en el router.
Puerto cerrado: si Zigbee2MQTT no conecta y el log muestra timeouts, comprueba que el puerto 6638 no esté filtrado por firewall en la red local.
Cambio de stack: intentar migrar de ember a zstack con un backup no es soportado; es mejor asumir el re-pairing.
Dejar permit_join abierto: cualquier dispositivo Zigbee cercano puede intentar unirse. Ciérralo al terminar.

Actualización relevante del ecosistema: Zigbee2MQTT 2.13.0 (agosto de 2026) elimina el soporte de Node.js 20 en instalaciones sobre metal desnudo. Si corres Z2M fuera de un add-on de Home Assistant, actualiza Node.js a 24 o 26 antes de tocar el coordinador.

Fuentes consultadas

Cambios de esta revisión: primera publicación (31/08/2026).