Zigbee в Home Assistant: Zigbee2MQTT или ZHA — установка, настройка, каналы

Zigbee2MQTT и встроенная интеграция ZHA — два способа подключить Zigbee-устройства к Home Assistant: датчики, реле, кнопки, лампы. У нас в доме работают обе одновременно: две независимые Zigbee-сети на одном Home Assistant, 90 устройств. Ниже — чем Zigbee2MQTT отличается от ZHA, как установить и настроить Zigbee2MQTT, какой координатор выбрать, как развести каналы Zigbee и Wi-Fi и почему карте сети нельзя верить на слово.

Zigbee в Home Assistant: два пути

Zigbee-устройства не подключаются к Wi-Fi. Им нужен координатор — USB-донгл или сетевой шлюз, который создаёт Zigbee-сеть, — и программа, которая переводит язык Zigbee в понятные Home Assistant устройства и сущности. Таких программ две:

Короткий совет: для старта и нескольких устройств хватит ZHA — меньше движущихся частей. Zigbee2MQTT удобнее, когда устройств много, хочется видеть и настраивать каждое в подробностях или когда Zigbee-сеть должна жить независимо от Home Assistant.

Наш кейс: две сети на одном Home Assistant

Так сложилось исторически, и оказалось удобно — сбой одной сети не кладёт всю автоматику дома:

Как поставить сам Home Assistant — в статье установка Home Assistant. Версии: Home Assistant Core 2026.9.4, Zigbee2MQTT 2.14.2. Две сети на разных каналах не мешают друг другу — главное, чтобы им не мешал Wi-Fi, об этом ниже.

Установка Zigbee2MQTT

Если Home Assistant установлен как Home Assistant OS, проще всего поставить Zigbee2MQTT как приложение из магазина Apps (раньше они назывались дополнениями). По документации Zigbee2MQTT, оно работает только на 64-битном железе, а Raspberry Pi нужен не ниже четвёртого — на третьем возможна нестабильная работа. Порядок такой:

1. Установите MQTT-брокер — приложение Mosquitto broker — и запустите его.
2. Добавьте в магазин Apps репозиторий Zigbee2MQTT (адрес указан в документации) и установите приложение.
3. Укажите в настройках, где координатор: путь к USB-донглу или сетевой адрес шлюза, и тип адаптера.
4. Запустите приложение и откройте веб-интерфейс — дальше устройства добавляются кнопкой «Разрешить подключение».

Zigbee2MQTT ставится и без Home Assistant OS — в Docker или прямо в Linux, инструкции есть в той же документации. Про Docker на сервере — в статье Docker Compose для начинающих.

Настройка Zigbee2MQTT: наш конфиг

Наш configuration.yaml (ключи сети и пароли скрыты):

homeassistant:
  enabled: true
permit_join: false
advanced:
  network_key: <скрыто>
  pan_id: <скрыто>
  ext_pan_id: <скрыто>
  log_level: warning
  transmit_power: 20
  channel: 11
  network_cache: true
mqtt:
  server: mqtt://core-mosquitto:1883
  user: <скрыто>
  password: <скрыто>
  keepalive: 60
  version: 4
  base_topic: zigbee2mqtt
serial:
  port: tcp://<адрес_шлюза>:6638
  adapter: zstack
frontend:
  enabled: true
  port: 8099

На что обратить внимание:

• homeassistant: enabled: true — устройства сами появляются в Home Assistant через MQTT;
• permit_join: false — подключение новых устройств закрыто, открываем только на время сопряжения;
• serial.port: tcp://…:6638 — так подключается сетевой координатор; для USB-донгла здесь будет путь вроде /dev/ttyUSB0;
• network_key — ключ шифрования сети. Его нельзя публиковать и нельзя терять: по документации, смена ключа требует заново подключить все устройства. Храните копию конфига в резервной копии.

Координатор Zigbee: USB или Ethernet

USB-донгл дешевле и проще, его можно воткнуть прямо в устройство с Home Assistant. Но и Zigbee2MQTT, и Home Assistant в документации предупреждают о помехах: в описании ZHA советуют подключать донгл через USB-удлинитель, в порт USB 2.0 и подальше от устройств USB 3.0, а Zigbee2MQTT добавляет, что уже 50 см удлинителя заметно снижают помехи, а рядом с портами USB 3 и HDMI сигнал может пропасть совсем.

Сетевой координатор подключается кабелем к роутеру и ставится в центре дома, а не там, где стоит сервер. Важная оговорка из документации Home Assistant: подключать координатор по сети можно только по проводу в локальной сети — через Wi-Fi, интернет или VPN не рекомендуется, протокол не переживает потерь пакетов и задержек.

Каналы Zigbee и Wi-Fi: как развести

Zigbee и Wi-Fi работают в одном диапазоне 2,4 ГГц и мешают друг другу. У Zigbee каналы с 11-го по 26-й шириной по 2 МГц, у Wi-Fi — с 1-го по 13-й, но каждый шириной около 20 МГц. Поэтому один канал Wi-Fi накрывает сразу несколько каналов Zigbee.

Наше правило: Zigbee — по краям диапазона (11 и 25), Wi-Fi на всех точках доступа жёстко закреплён на 6-м канале, который проходит между ними. Zigbee2MQTT в описании настроек советует каналы 11, 15, 20 или 25 — «чтобы избежать проблем» — это каналы стандарта Zigbee Light Link. ZHA по умолчанию при выборе «Smart» сама сканирует эфир и предпочитает 15, 20 или 25; документация Home Assistant советует без причины не менять канал ZHA.

Как «авто» в Wi-Fi положил Zigbee

Однажды один из повторителей Wi-Fi остался с выбором канала «авто» и в какой-то момент сам ушёл на 1-й канал. Он оказался прямо над Zigbee-каналом 11 — и сеть Zigbee2MQTT в этой части дома начала болеть:

• качество связи (LQI) у реле упало до 10, хотя соседнее устройство в той же точке держало 138;
• настройки части устройств в Home Assistant стали unknown;
• команды начали пропадать — свет включался через раз.

Лечение — зафиксировать канал Wi-Fi вручную на всех точках, включая повторители. Вывод простой: никакого «авто» в Wi-Fi, если в доме есть Zigbee. Если сеть Zigbee внезапно стала нестабильной без видимых причин, первым делом проверьте, на каком канале сейчас работают все точки Wi-Fi.

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

Почему карта сети Zigbee2MQTT «врёт»

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

Правильная проверка батарейного устройства — смотреть его собственную сущность linkquality в Home Assistant, которую оно присылает вместе с данными. Для устройств с питанием от сети — реле, розеток, ламп — карта достоверна. И ещё одна ловушка: «родитель» роутера на карте — это лишь память о том, через кого устройство когда-то вошло в сеть, а реальный маршрут сообщений идёт по таблице маршрутов и может быть совсем другим.

Итог: что выбрать

• Начинаете и устройств немного — ZHA: встроена, ставится за минуту.
• Устройств десятки, нужен контроль — Zigbee2MQTT: подробные настройки каждого устройства, своя карта сети, независимость от Home Assistant.
• В любом случае — координатор на удлинителе или по Ethernet в центре дома, Zigbee на краях диапазона, Wi-Fi на фиксированном канале.

Чтобы узнавать о севших батарейках и пропавших Zigbee-устройствах вовремя, настройте оповещения — см. статью уведомления Home Assistant.

Источники: Zigbee2MQTT: дополнение для Home Assistant, Zigbee2MQTT: настройки сети, Zigbee2MQTT: радиус и стабильность сети, Home Assistant: интеграция ZHA. Кейс — наш дом, Home Assistant 2026.9.4, Zigbee2MQTT 2.14.2. Проверено 3 октября 2026 года.