Как восстановить Zigbee‑сеть после замены координатора

Чтобы не перепривязывать устройства, нужно перенести на новый координатор те же параметры сети и ключи (а также базу устройств в вашем ПО). Если новый донгл создаст «новую сеть», большинство датчиков и ламп останутся в старой и уйдут в Unavailable.

Оглавление

Что нужно сохранить, чтобы сеть считалась «той же»

Критично совпадение параметров Zigbee‑сети:

  • PAN ID и Extended PAN ID
  • Channel (канал)
  • Network Key (сетевой ключ)
  • часто важно: IEEE/EUI64 адрес координатора (если стек/ПО позволяет «перенести» его логически)

Отдельно сохраняется «прикладной слой» вашей системы: список устройств, имена, группы, биндинги, маршруты/соседи (часто пересобираются), настройки публикации в MQTT и т. п. Поэтому одного «бэкапа сервера» бывает недостаточно — часть данных живёт в файлах приложения, а часть записана в радио‑модуле координатора.

Чек‑лист перед заменой координатора

  1. Сделайте бэкап именно Zigbee‑сети (через функцию backup/restore в вашем ПО).
  2. Сохраните папку данных приложения (на случай отката).
  3. Остановите сервис Zigbee перед заменой донгла, чтобы он не успел создать новую сеть.
  4. Не включайте старый и новый координаторы одновременно, если есть риск одинаковых сетевых параметров/IEEE.
  5. Если меняете место донгла — используйте USB‑удлинитель и держите его подальше от помех (USB 3.0, роутеры Wi‑Fi, мини‑ПК с плотной компоновкой).

Восстановление в ZHA (Home Assistant)

Оптимальный путь — встроенная миграция адаптера:

  1. Откройте интеграцию ZHA → настройки сети/адаптера.
  2. Запустите мастер миграции на новый координатор (обычно он сам создаст бэкап).
  3. Если мастер предлагает перезаписать IEEE новым значением «как у старого» — делайте это только если понимаете цель: так сеть чаще переносится «бесшовно».

Если вы перенесли/подменили IEEE под старый координатор, не подключайте старый донгл в той же среде: два координатора с одинаковым IEEE — частая причина странных отвалов и «двоения» сети.

Восстановление в Zigbee2MQTT

Здесь успех сильнее зависит от адаптера/стека: у одних backup/restore работает стабильно, у других — частично.

Минимум, что стоит сохранить перед заменой:

  • configuration.yaml
  • database.db (список устройств и параметры)
  • coordinator_backup.json (если создаётся)
  • при необходимости — прочие файлы из папки data/

Базовый сценарий миграции:

  1. Обновите Zigbee2MQTT до актуальной версии и остановите его.
  2. Отключите старый координатор, подключите новый.
  3. В configuration.yaml поменяйте только serial.port (путь к порту).
  4. Запустите Zigbee2MQTT и проверьте логи: важно, чтобы он восстановил существующую сеть, а не создал новую.

Если видите ошибку несоответствия конфигурации/адаптера (в духе adapter mismatch), обычно это означает, что параметры сети в файлах и в координаторе «разъехались». Самый безопасный шаг — вернуться к консистентному бэкапу, а не удалять файлы наугад.

Восстановление в deCONZ/Phoscon

Используйте встроенный механизм Backup/Restore:

  1. Сделайте бэкап в интерфейсе шлюза и сохраните файл.
  2. Полностью остановите сервис/контейнер, замените донгл.
  3. Запустите deCONZ/Phoscon и выполните Restore из сохранённого файла.
  4. Дайте сети время пересобраться (маршруты обычно перестраиваются сами).

Что делать после restore, если часть устройств не в сети

  1. Подождите 10–30 минут: многие устройства делают rejoin не сразу.
  2. Начинайте с роутеров (розетки/реле/лампы): кратко обесточьте их на 5–10 секунд. Это часто «поднимает» за ними батарейные датчики.
  3. Разбудите батарейные: нажмите сервисную кнопку/откройте крышку/сделайте действие, которое вызывает передачу.
  4. Не меняйте одновременно всё: координатор + место + канал. Канал — отдельная операция.

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

  • Запустили сервис с новым донглом без restore → создалась новая сеть.
  • Держали рядом два координатора (или два экземпляра Zigbee‑сервиса) → конфликты и «плавающие» отказы.
  • Удалили database.db/coordinator_backup.json, надеясь «починить» запуск → фактически откатились к сценарию новой сети.
  • Поставили координатор вплотную к источникам помех → сеть «вроде есть», но устройства массово отваливаются.

FAQ

Можно ли перенести сеть между ZHA и Zigbee2MQTT одним бэкапом?
Обычно нет: даже если сетевые ключи совпадут, «база устройств» и логика управления различаются. Реалистичный вариант — переносить именно сетевые параметры и затем доводить устройства/группы вручную.

Почему устройства видны в списке, но Unavailable?
Чаще всего они ещё не сделали rejoin, либо «сломалась» маршрутизация. Начните с перезапуска/обесточивания роутеров и пробуждения батарейных.

Какой самый надёжный план, если сомневаюсь в backup/restore?
Поднять новую сеть на новом координаторе и переподключать устройства заново (сначала роутеры), параллельно восстанавливая автоматизации. Это дольше, но предсказуемо.