Как мигрировать Zigbee‑сеть на новый донгл и сохранить устройства

Перенести Zigbee‑сеть на новый координатор без перепривязки устройств можно, если вы переносите параметры самой сети (ключ, PAN ID/Extended PAN ID, канал и служебные счётчики) через backup/restore. Тогда устройства “узнают” сеть и со временем переподключатся сами.

Оглавление

Когда перенос получится без переподключения

Бесшовная миграция обычно возможна, если выполняются условия:

  • Вы остаетесь в том же ПО (например, ZHA → ZHA, Zigbee2MQTT → Zigbee2MQTT).
  • Ваш старый координатор жив, либо у вас есть его бэкап сети.
  • Вы не запускаете одновременно два координатора с одной и той же сетью (одинаковые параметры/IEEE) в одном радиусе.

Если включить рядом старый и новый координаторы с клонированной сетью, получите “двойника” в эфире: плавающие отваливания, проблемы с добавлением устройств и нестабильную маршрутизацию.

Подготовка: что сохранить перед миграцией

Перед заменой донгла сделайте две вещи: сохраните сеть и сохраните базу вашего ПО.

1) Параметры Zigbee‑сети (то, что избавляет от перепривязки):

  • network key (ключ шифрования)
  • PAN ID и Extended PAN ID
  • channel
  • счётчики/служебные данные (важно для корректной работы после восстановления)
  • иногда — IEEE‑адрес координатора (часть устройств ориентируется на него)

2) Данные приложения (чтобы не “сломать” логику и имена):

  • список устройств, friendly name
  • группы/сцены/биндинги (зависит от ПО)
  • внутренняя БД (Zigbee2MQTT, ZHA, deCONZ)

Практический чек‑лист:

  1. Остановите Zigbee‑сервис (ZHA/Zigbee2MQTT/deCONZ) перед любыми действиями с USB.
  2. Сделайте бэкап системы (для Home Assistant — полный backup).
  3. Скопируйте файлы/бэкапы Zigbee‑интеграции в отдельное место.
  4. Подключайте координатор через USB‑удлинитель и держите подальше от USB 3.0/SSD/роутера Wi‑Fi (помехи в 2.4 ГГц — частая причина “мистических” проблем).

Пошагово: ZHA, Zigbee2MQTT, deCONZ/Phoscon

Ниже — рабочая схема “остановить → сохранить → заменить → восстановить → подождать”.

Home Assistant ZHA

  1. Остановите ZHA (или выключите хост, если так проще и безопаснее).
  2. В интерфейсе ZHA откройте настройки сети и выберите миграцию/восстановление (в разных версиях это может называться “миграция адаптера” или “резервное копирование/восстановление сети”).
  3. Подключите новый адаптер и восстановите сеть из бэкапа.
  4. Если появится опция перезаписать IEEE‑адрес на новом донгле — включайте её только если вы точно понимаете, что делаете (и старый координатор больше никогда не будет включён рядом).

Если часть устройств “молчит”, сначала перезагрузите питание роутеров (розетки/реле), а уже потом “будите” батарейные датчики — так сеть поднимется быстрее.

Zigbee2MQTT

Минимум, который нужно сохранить из data‑директории Zigbee2MQTT:

  • coordinator_backup.json (слепок Zigbee‑сети)
  • database.db (список устройств/настройки)
  • configuration.yaml

Шаги:

  1. Остановите Zigbee2MQTT.
  2. Скопируйте всю data‑директорию (на практике это надежнее, чем выбирать файлы вручную).
  3. Подключите новый координатор.
  4. В configuration.yaml обновите:
    • serial: port: (новый путь к устройству)
    • при необходимости serial: adapter: (если меняется драйвер/стек)
  5. Запустите Zigbee2MQTT и проверьте логи: важно, чтобы restore сети применился без ошибок.

Если ваш тип адаптера/стека не поддерживает полноценный restore, сеть может подняться “частично”: часть устройств вернётся сама, а часть придётся переподключать точечно.

deCONZ/Phoscon (ConBee/RaspBee)

  1. Сделайте backup в Phoscon/deCONZ и сохраните файл.
  2. Остановите сервис/выключите хост.
  3. Замените координатор.
  4. Поднимите систему и выполните restore из backup.
  5. Дайте сети время: роутерам нужно несколько минут, батарейным — дольше.

Какой способ выбрать (коротко)

ПлатформаЧто обязательно сохранитьШанс переноса без перепривязки
ZHAbackup сети + backup Home AssistantВысокий
Zigbee2MQTTcoordinator_backup.json + database.db + configuration.yamlОт среднего до высокого (зависит от адаптера)
deCONZ/Phosconbackup Phoscon/deCONZВысокий в рамках экосистемы deCONZ

После переноса: как “оживить” mesh

Нормально, если сразу после restore часть устройств “в офлайне”. Дайте сети время и действуйте по порядку:

  1. Подождите 10–30 минут (у mesh есть собственные тайминги).
  2. Переподайте питание всем роутерам (розетки/реле) — они формируют каркас сети.
  3. “Разбудите” батарейные устройства (кнопка/открыть крышку/сработка датчика) — чтобы они заново обменялись ключами и маршрутами.
  4. Если сеть стала нестабильной: вынесите донгл на USB‑удлинителе дальше от источников помех и смените порт/кабель.

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

  • Запустили два координатора с одной сетью одновременно (или оставили старый подключенным).
  • Восстановили “сеть”, но забыли про БД приложения: пропали имена, группы, автоматизации “поехали”.
  • Поменяли канал/ключ “заодно” при миграции — и получили массовый отвал (канал лучше менять отдельно и осознанно).
  • Ожидают, что всё поднимется мгновенно: батарейные устройства могут вернуться только после пробуждения.
  • Подключили донгл вплотную к USB 3.0/SSD — и ловят помехи на 2.4 ГГц.

FAQ

Нужно ли перепривязывать устройства после backup/restore?
Обычно нет: при корректном переносе параметров сети устройства постепенно переподключаются. Исключения бывают при смене стека/несовместимом restore или если потеряны ключи сети.

Сколько времени занимает восстановление?
Роутеры часто возвращаются за минуты, батарейные — от 10 минут до часа (зависит от устройства и частоты пробуждения).

Можно ли перенести Zigbee‑сеть на другой тип донгла?
Иногда да, но это самый рискованный сценарий: разные стеки по-разному поддерживают перенос служебных данных. Планируйте, что часть устройств может потребовать ручного переподключения.

Что делать, если старый координатор умер и бэкапа нет?
Чаще всего придётся создать новую Zigbee‑сеть и переподключить устройства. Чтобы ускорить процесс, начните с роутеров рядом с координатором, затем добавляйте конечные устройства.