Как безопасно и правильно мигрировать Zigbee‑устройства

Коротко: в большинстве случаев при переходе между разными интеграциями (ZHA, Zigbee2MQTT, deCONZ) потребуется перепривязать устройства; исключение — перенос внутри одной интеграции (например, ZHA → ZHA) с использованием бэкапа контроллера. Ниже — что делать подготовительно, пошаговые сценарии и проверенный план отката.

Оглавление {{TOC_AUTOMATIC}}

Что важно знать и подготовка

  • Zigbee‑устройства завязаны на параметры сети: PAN ID, channel, network key и на привязку к конкретному координатору. При изменении хотя бы одного из них большинство устройств выполняет повторное присоединение или требует ручного сопряжения.
  • Перед началом сделайте полный snapshot Home Assistant и экспорт файлов интеграции: для ZHA — backup/экспорт сети и файлы zigbee.db, для Zigbee2MQTT — devices.yaml и database.db, для deCONZ — экспорт сети, если доступен.
  • Отключите по возможности все лишние mains‑устройства (розетки/лампы‑ретрансляторы), чтобы контролировать процесс присоединения; при перепривязке включайте их первыми.
  • Подготовьте физический доступ к батарейным устройствам: новые батареи, инструкции по «пробуждению» (удержание кнопки, извлечение батареи и т.д.).

Перед миграцией пронумеруйте или сфотографируйте устройства и их местоположение — это упростит проверку и повторное добавление.

Пошаговые сценарии миграции

1) ZHA → тот же ZHA на другом адаптере (рекомендованный путь)

Когда применимо: вы меняете USB‑радиомодуль, но остаётесь в ZHA. Шаги:

  1. В ZHA сделайте Manual Backup сети через UI (Network Settings) и сохраните файл.
  2. Сохраните snapshot Home Assistant и копию zigbee.db/.storage файлов.
  3. Установите новый адаптер, добавьте интеграцию ZHA и выберите Restore Backup, укажите ранее сохранённый файл.
  4. Перезагрузите Home Assistant, проверьте статусы устройств и выполните интервью/проверку сенсоров по необходимости.
    Ограничения: поддерживаются не все чипы; некоторые метаданные (имена, кастомные настройки) могут не восстановиться.

2) deCONZ → ZHA

Когда применимо: хотите перейти из deCONZ в ZHA. Шаги:

  1. Экспортируйте бэкап deCONZ (если есть) и снимите snapshot HA.
  2. Установите ZHA и выполните рекомендуемые операции миграции: попытка восстановления сетевых параметров, затем последовательная проверка устройств.
  3. Батарейные устройства, скорее всего, придётся "разбудить" вручную и повторно провести интервью.
    Ограничения: не всё переносится автоматически — имена, некоторые настройки и отдельные устройства требуют ручной донастройки.

3) Zigbee2MQTT ↔ ZHA (и обратно)

Реальность: универсальной «безболезненной» миграции обычно нет. Варианты:

  • Ручная перепривязка: самый надёжный метод — удалить устройства из старой интеграции и поочерёдно добавить их в новую, начиная с mains‑маркеров.
  • Скрипты конвертации: существуют инструменты, которые пытаются конвертировать базы (генерировать devices.yaml, database.db и т.п.). Это рискованно — используйте только после полного бэкапа и тестирования в изолированной среде.
    Рекомендация: если у вас большое количество устройств и вы не готовы к риску, планируйте ночной/поэтапный перенос с ручной перепривязкой.

Автоматические конверторы баз данных могут повредить текущую сеть. Всегда делайте snapshot и копию всех файлов перед экспериментом.

Валидация, восстановление и проверка после миграции

  • Не удаляйте старую интеграцию, пока не убедитесь, что новая работает корректно.
  • Проверяйте в первую очередь mains‑устройства (ретрансляторы) — они обеспечивают маршрутизацию. Затем проверяйте сенсоры и батарейные устройства.
  • Если часть устройств не отвечает: проверьте параметры сети (channel, PAN ID, network key). При совпадении параметров возможно secure rejoin; если они отличаются — потребуется перепривязка.
  • План отката: восстановите snapshot Home Assistant, затем старую интеграцию и проверяйте устройства по одному.

Частые ошибки

  • Попытка менять адаптер и одновременно мигрировать между разными экосистемами — слишком много переменных.
  • Недостаточная подготовка: отсутствие snapshot или копии файлов zigbee.db перед экспериментом.
  • Отключение mains‑маршрутизаторов во время интервью, что приводит к долгому или неудачному завершению процесса.
  • Игнорирование батарейных устройств — они не "проснутся" сами и будут считаться отсутствующими.

FAQ

  • Нужно ли менять network key/канал при миграции?
    Обычно менять не нужно, если вы пытаетесь выполнить secure rejoin или восстановление сети; при полном переходе между системами чаще создают новую сеть с новым ключом и перепривязывают устройства.
  • Можно ли автоматически перенести все имена и automations?
    Часто — нет. Некоторые метаданные теряются; экспорт/импорт automations и ручная проверка имён обязательны.
  • Что быстрее: конвертация базы или перепривязка вручную?
    Конвертация быстрее, но рискованна; перепривязка медленнее, но надёжнее и предсказуемее.

Если хотите, подготовлю персональный чек‑лист под вашу конфигурацию — укажите текущую и целевую интеграцию, модель адаптера и перечень ключевых устройств.