ZHA или Zigbee2MQTT: что выбрать для Home Assistant

Зачем сравнивать ZHA и Zigbee2MQTT

ZHA (Zigbee Home Automation) и Zigbee2MQTT — два распространённых способа подключить Zigbee-устройства к Home Assistant. Оба работают через Zigbee-координатор (USB-стик или сетевой шлюз), но устроены по-разному: ZHA встроен в Home Assistant, а Zigbee2MQTT — отдельное приложение, общающееся с Home Assistant через MQTT. Выбор влияет на установку, поддержку устройств, обновления прошивок, диагностику и объём ручного обслуживания.

Ниже — сравнение по ключевым критериям. Абсолютного победителя нет: решение зависит от координатора, парка устройств, готовности поддерживать MQTT-брокер и уровня комфорта с ручной настройкой.

Архитектура: встроенный ZHA против внешнего Zigbee2MQTT

ZHA — интеграция внутри Home Assistant: она напрямую управляет координатором и создаёт сущности в Home Assistant. Zigbee2MQTT — самостоятельное приложение (обычно отдельный контейнер или аддон), которое держит связь с координатором и публикует состояние устройств в MQTT-брокер; Home Assistant подписывается на эти топики через MQTT-интеграцию.

Установка и первичная настройка

ZHA

1. Подключите совместимый координатор к хосту Home Assistant.
2. Добавьте интеграцию ZHA в разделе «Устройства и службы».
3. Выберите порт координатора и тип (например, EZSP, ZNP, deCONZ).
4. Запустите поиск и добавление Zigbee-устройств.

Zigbee2MQTT

1. Установите и запустите MQTT-брокер (например, Mosquitto).
2. Разверните Zigbee2MQTT (аддон или контейнер) и укажите порт координатора.
3. Задайте в конфигурации подключение к MQTT-брокеру и параметры сети.
4. Добавьте MQTT-интеграцию в Home Assistant.
5. Откройте веб-интерфейс Zigbee2MQTT и разрешите подключение новых устройств.

Поддержка устройств и координаторов

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

• Сверяйте модель устройства и производителя по официальной базе поддержки.
• Проверяйте совместимость координатора и рекомендуемую прошивку.
• Учитывайте, что «работает» может означать разный набор функций: базовое включение и расширенные параметры могут отличаться.

Интерфейс и управление в Home Assistant

В ZHA управление сосредоточено в интерфейсе Home Assistant: карточка интеграции, список устройств, добавление и удаление, настройки кластера. Zigbee2MQTT даёт отдельный веб-интерфейс с картой сети, списком устройств, журналом событий и настройками сопряжения, а в Home Assistant устройства появляются через MQTT.

OTA-обновления устройств

OTA (обновление прошивки Zigbee-устройств по воздуху) поддерживается в обоих решениях, но реализация и охват зависят от производителя устройства и наличия образов прошивок. В ZHA обновления запускаются из интерфейса Home Assistant для поддерживаемых устройств. В Zigbee2MQTT OTA-обновления управляются из веб-интерфейса и требуют, чтобы образ прошивки был доступен проекту.

Диагностика и отладка сети

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

• Проверяйте LQI у проблемных устройств и наличие маршрутов через роутеры.
• Следите за числом дочерних устройств у роутеров, чтобы не перегружать отдельные узлы.
• Используйте журналы и диагностику для поиска устройств, которые часто отваливаются.
• Учитывайте помехи: каналы Wi-Fi и Zigbee могут пересекаться.

Зависимость от MQTT-брокера

Zigbee2MQTT требует MQTT-брокер: без него связь с Home Assistant не работает. Это дополнительный компонент, который нужно установить, настроить и обслуживать, но он же даёт гибкость — к брокеру могут подключаться другие системы и приложения. ZHA не требует MQTT и не добавляет этот слой.

Миграция между ZHA и Zigbee2MQTT

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

1. Зафиксируйте текущую конфигурацию: список устройств, автоматизации, привязки сущностей.
2. Проверьте, поддерживает ли ваш координатор перенос сети в целевое решение.
3. Сделайте резервную копию Home Assistant и конфигурации Zigbee-решения.
4. Выполните перенос или повторное сопряжение устройств.
5. Обновите сущности в автоматизациях и дашбордах, проверьте работу устройств.

Требования к пользователю и сложность обслуживания

Кому подходит ZHA, а кому Zigbee2MQTT

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

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

Итоги: как выбрать без абсолютного победителя

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