ZHA или Zigbee2MQTT: что выбрать для Home Assistant и как перейти без хаоса

Если коротко: ZHA стоит оставить, если сеть уже работает и вам хватает возможностей устройств. Zigbee2MQTT имеет смысл выбирать, когда нужны более подробные настройки, прозрачная диагностика и поддержка редких функций конкретных датчиков. Переезжать только потому, что «в интернете советуют Zigbee2MQTT», — плохая причина.

У этого сравнения есть неприятная, но важная часть: переход между ZHA и Zigbee2MQTT — не обычное обновление. В большинстве домашних конфигураций устройства придётся сбросить и подключить заново. Ниже разберём, как принять решение и пережить миграцию без ночи, проведённой среди мигающих лампочек.

ZHA и Zigbee2MQTT — в чём разница

Оба решения превращают USB-координатор в центр локальной Zigbee-сети и передают устройства в Home Assistant. Облако производителя при этом не требуется.

ZHA встроена в Home Assistant. Координатор добавляется из интерфейса, устройства и автоматизации живут в одной системе, а отдельный MQTT-брокер не нужен. Для нестандартных устройств используются так называемые quirks — обработчики особенностей конкретных моделей.

Zigbee2MQTT — отдельное приложение, которое общается с Home Assistant через MQTT. У него свой веб-интерфейс, подробная карта сети, гибкие параметры устройств и большая база конвертеров. За эту свободу приходится платить ещё одним сервисом, который нужно обновлять и резервировать.

Кому лучше остаться на ZHA

Не трогайте работающую сеть, если:

• все устройства определились правильно;
• датчики передают нужные значения;
• лампы и реле не отваливаются;
• вас устраивают группы, привязки и обновления прошивок;
• MQTT больше нигде не используется и добавлять его ради одного Zigbee нет желания.

ZHA — не «облегчённая версия» Zigbee2MQTT. Это самостоятельная реализация с автоматическими резервными копиями Zigbee-сети и переносом между поддерживаемыми координаторами внутри ZHA. Если задача — заменить старый USB-донгл на новый, сначала изучите встроенную миграцию ZHA: возможно, менять всю платформу вообще не нужно.

Когда Zigbee2MQTT действительно полезнее

Переход оправдан, когда есть конкретная причина:

• устройство подключается, но часть функций в ZHA недоступна;
• нужны параметры, которые видны в базе Zigbee2MQTT, но не создаются в ZHA;
• хочется видеть LQI, маршруты, события интервью и подробные журналы в одном месте;
• нужны внешние конвертеры для редкого или нового устройства;
• MQTT уже является частью умного дома;
• вы сознательно хотите отделить Zigbee-сеть от жизненного цикла Home Assistant.

Перед миграцией найдите точную модель каждого проблемного устройства в списке поддерживаемых устройств Zigbee2MQTT. Само наличие бренда в списке ничего не гарантирует: у двух внешне одинаковых датчиков могут быть разные manufacturer ID и набор функций.

Можно ли перейти без повторного подключения устройств

Надёжный ответ — рассчитывайте на перепривязку.

Официальная документация Zigbee2MQTT прямо указывает: устройство может состоять только в одной Zigbee-сети, а при переносе в другую сеть его требуется сбросить и подключить заново. Резервная копия ZHA предназначена для восстановления ZHA или переноса на другой координатор внутри ZHA. Это не универсальный файл импорта в Zigbee2MQTT.

В сети встречаются экспериментальные сценарии с переносом параметров координатора. Они зависят от чипа, прошивки, формата резервной копии и версии стека. Для домашней системы, где от Zigbee зависят свет, отопление или датчики протечки, строить план на таком трюке я бы не стал.

Два безопасных сценария миграции

Вариант 1. Второй координатор и перенос по комнатам

Это самый спокойный путь. ZHA продолжает работать на старом координаторе, а Zigbee2MQTT поднимается на новом. Затем устройства переносятся небольшими группами.

Плюсы: старую сеть не нужно выключать целиком, можно остановиться после любой комнаты. Минусы: понадобится второй координатор, а каждое перенесённое устройство всё равно покидает ZHA.

Если пойдёте этим путём, пригодится отдельный материал про второй координатор Zigbee2MQTT.

Вариант 2. Тот же координатор и одно окно обслуживания

Сначала полностью останавливается ZHA, затем тот же адаптер передаётся Zigbee2MQTT. Одновременно использовать координатор в двух приложениях нельзя.

Этот путь дешевле, но умный дом частично не работает, пока устройства не подключены заново. Для сети из десятков датчиков выделите несколько часов и заранее приготовьте инструкции по сбросу каждой модели.

План перехода с ZHA на Zigbee2MQTT

1. Проведите инвентаризацию

Составьте таблицу: помещение, имя устройства, модель, тип питания, текущие entity_id и автоматизации. Сделайте снимки экранов важных настроек. Особенно отметьте устройства-роутеры: розетки, реле и лампы с постоянным питанием.

2. Создайте две резервные копии

Сделайте полный бэкап Home Assistant и ручную резервную копию Zigbee-сети в настройках ZHA. Скопируйте полный бэкап на другой компьютер или NAS. Резервная копия нужна для отката, а не для прямого импорта устройств в Zigbee2MQTT.

Подробный разбор есть в статье про бэкап и восстановление Home Assistant.

3. Подготовьте MQTT и Zigbee2MQTT

Проверьте, что MQTT-брокер запущен, интеграция MQTT видна в Home Assistant, а выбранный координатор поддерживается. Для первого знакомства используйте руководство Zigbee2MQTT + Home Assistant. Если выбираете популярный USB-донгл, отдельно сверьтесь с настройкой Sonoff Zigbee 3.0 USB Dongle Plus.

4. Переносите сначала роутеры

Начните с питаемых от сети устройств рядом с координатором и постепенно двигайтесь к краям дома. Так новая mesh-сеть получит «скелет», через который смогут подключаться батарейные датчики.

Не открывайте разрешение на подключение для всей сети надолго. Включайте его на короткое время и сразу задавайте понятное имя принятому устройству.

5. Сохраняйте старые идентификаторы

До включения автоматизаций переименуйте устройство и его сущности так, чтобы важные entity_id совпадали со старыми. Затем проверьте сценарии, дашборды, группы, уведомления и голосовое управление. Одно устройство лучше проверить полностью, чем быстро добавить десять и потом искать, какое из них стало sensor_temperature_7.

6. Дайте mesh-сети успокоиться

После переноса не делайте выводы по первой минуте. Питаемые роутеры должны построить маршруты, а батарейные устройства — проснуться и отметиться в сети. Проверьте отсутствующие устройства через несколько часов и на следующий день.

Что часто ломают при переезде

• Запускают ZHA и Zigbee2MQTT одновременно с одним USB-адаптером.
• Сбрасывают все датчики до создания списка имён и entity_id.
• Начинают с дальних батарейных устройств, пока в новой сети ещё нет роутеров.
• Удаляют ZHA сразу после первого успешного подключения.
• Считают высокий LQI гарантией идеальной связи и игнорируют расположение роутеров.
• Забывают проверить автоматизации, в которых используются device_id, а не только entity_id.

Что выбрать в итоге

Выбирайте ZHA, если нужен простой локальный Zigbee без отдельной инфраструктуры и текущие устройства работают как надо.

Выбирайте Zigbee2MQTT, если вы уже знаете, какой функции не хватает, хотите более подробную диагностику или используете модели, лучше раскрывающиеся через конвертеры Zigbee2MQTT.

Не мигрируйте ради самого процесса. Если сеть стабильна, лучший апгрейд часто состоит не в смене программы, а в правильном расположении координатора, USB-удлинителе и нескольких надёжных роутерах.

Официальная документация

Перед началом проверьте актуальные ограничения в документации ZHA, FAQ Zigbee2MQTT и списке поддерживаемых адаптеров. Особенно внимательно прочитайте примечания к своему чипу координатора: поддержка резервных копий различается.