Zigbee2MQTT -- программный мост между Zigbee-устройствами и MQTT-брокером. Он позволяет управлять датчиками, выключателями и лампами без проприетарных шлюзов и облаков. Поддерживает более 3 000 устройств, работает локально, интегрируется с Home Assistant и любой другой системой через MQTT. В этом руководстве -- полная инструкция: от выбора координатора до решения проблем.

Что такое Zigbee2MQTT

Zigbee2MQTT (Z2M) -- это open-source проект, который превращает обычный USB-координатор в полноценный Zigbee-шлюз. Он принимает данные от Zigbee-устройств (датчиков, выключателей, ламп, реле) и транслирует их в MQTT-сообщения. А MQTT -- универсальный протокол, который понимают Home Assistant, Node-RED, OpenHAB и любая другая система автоматизации.

Проще говоря: Zigbee2MQTT заменяет проприетарные шлюзы производителей. Вместо отдельных хабов Aqara, IKEA, Philips Hue, Tuya -- один USB-стик и одна программа. Все устройства разных производителей -- в одной системе, без облаков, без привязки к вендору.

Зачем нужен Zigbee2MQTT

  • Уход от облаков. Проприетарные шлюзы (Aqara Hub, IKEA DIRIGERA, Philips Hue Bridge) отправляют данные на серверы производителя. Zigbee2MQTT работает полностью локально -- ваши данные не покидают квартиру
  • Единый интерфейс. Датчик Aqara, лампа IKEA и реле Sonoff -- всё управляется через одну систему. Не нужно пять разных приложений на телефоне
  • 3 000+ устройств. Zigbee2MQTT поддерживает устройства от 400+ производителей. Это самая широкая база совместимости среди всех Zigbee-решений
  • Независимость. Производитель может закрыть облако или обанкротиться -- ваши устройства продолжат работать через Zigbee2MQTT
  • Гибкость. Полный контроль над Zigbee-сетью через конфигурационный файл: частота опроса, кластеры, параметры репортинга

Как это работает: архитектура

Zigbee-устройство отправляет сигнал по радио (2.4 ГГц) на координатор (USB-стик). Zigbee2MQTT получает данные, преобразует их и публикует в MQTT-брокер (Mosquitto). Home Assistant подписывается на MQTT-топики и получает состояния в реальном времени. Обратная связь -- аналогично: HA отправляет команду в MQTT, Z2M передаёт её устройству. Задержка -- менее 100 миллисекунд.

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

Что нужно для начала

Для запуска Zigbee2MQTT нужны три вещи: координатор, сервер и (опционально) Home Assistant.

1. Zigbee-координатор

Координатор -- это «антенна», через которую Zigbee2MQTT общается с устройствами. Физически -- USB-стик или Ethernet-модуль с Zigbee-радио.

Sonoff ZBDongle-E (рекомендация для большинства) -- USB-стик на чипе Silicon Labs EFR32MG21. Стоит 1 500-2 000 рублей. Поддерживает до 200 устройств, стабильный, компактный. Подключается в USB-порт сервера. Оптимальный вариант для квартиры площадью до 100 м².

SLZB-06 (для больших помещений и продвинутых пользователей) -- координатор с Ethernet и PoE. Стоит 4 000-5 000 рублей. Подключается к роутеру по кабелю, а не по USB. Главное преимущество -- его можно разместить в центре квартиры (например, на шкафу в коридоре), отдельно от сервера. Это даёт лучшее покрытие Zigbee-сети. Питание -- по PoE или через USB-C.

Не покупайте устаревшие координаторы: Стики на чипе CC2531 (Texas Instruments) -- устаревшие, медленные, нестабильные при количестве устройств более 15-20. Если видите CC2531 в продаже -- это не экономия, а проблемы. Только EFR32MG21 (Silicon Labs) или CC2652 (Texas Instruments, новое поколение).

2. Сервер

Zigbee2MQTT -- программа, которая работает 24/7. Варианты сервера:

  • Мини-ПК с Home Assistant OS -- Beelink/Trigkey на Intel N100, 8 ГБ RAM, SSD 128 ГБ. И HA, и Z2M на одном устройстве. Цена: 12 000-18 000 ₽
  • Raspberry Pi 4/5 -- бюджетный вариант для экспериментов (6 000-10 000 ₽), но SD-карта ненадёжна
  • NAS (Synology, QNAP) -- если уже есть, Z2M запускается в Docker. С USB-координатором бывают сложности -- лучше Ethernet SLZB-06
  • Любой Linux-компьютер -- Z2M потребляет 50-100 МБ RAM, нагрузка на CPU околонулевая

3. Home Assistant (опционально)

Z2M работает и без HA -- у него есть собственный веб-интерфейс. Но для автоматизаций, дашбордов и голосового управления нужен Home Assistant. В 95% случаев Z2M используют в связке с HA.

4. MQTT-брокер

Посредник между Z2M и Home Assistant. Самый популярный -- Mosquitto. Устанавливается как аддон в HA за пару кликов или через Docker.

Минимальный набор для старта: Sonoff ZBDongle-E (1 500 ₽) + мини-ПК с Home Assistant (12 000 ₽) + пара Zigbee-устройств для теста (датчик Aqara -- 700 ₽, умная розетка -- 900 ₽). Итого -- от 15 000 ₽ за полностью локальную систему без облаков.

Zigbee2MQTT vs ZHA

В Home Assistant есть два способа работать с Zigbee-устройствами: встроенная интеграция ZHA (Zigbee Home Automation) и внешний проект Zigbee2MQTT. Оба варианта рабочие. Разница -- в деталях.

Параметр Zigbee2MQTT ZHA
Поддержка устройств 3 000+ от 400+ производителей ~2 500 устройств
Скорость добавления новых Быстро (сообщество активно) Медленнее (ждёт релиза HA)
Стабильность (50+ устройств) Высокая Средняя (бывают зависания)
Обновления Независимые, в любое время Привязаны к обновлениям HA
Веб-интерфейс Свой (порт 8080), удобный Через интерфейс HA
OTA-обновления прошивок Да, из коробки Ограниченно
Группы и binding Полная поддержка, удобный UI Есть, но настройка сложнее
Сложность установки Средняя (нужен MQTT-брокер) Простая (встроен в HA)

ZHA -- хороший выбор для систем до 20 устройств без желания разбираться с MQTT. Zigbee2MQTT -- лучший выбор при 20+ устройствах, когда нужна максимальная совместимость, OTA-обновления и независимость от обновлений HA (перезагрузка HA не ломает Zigbee-сеть).

Наш выбор: Во всех проектах при ремонте мы используем Zigbee2MQTT. Стабильность при большом количестве устройств, быстрая поддержка новых девайсов и независимость от обновлений Home Assistant -- критически важно для коммерческих инсталляций.

Установка Zigbee2MQTT

Три способа установки -- от самого простого до продвинутого. Выбирайте в зависимости от вашей платформы.

Вариант 1: Аддон для Home Assistant (самый простой)

Если у вас Home Assistant OS или Home Assistant Supervised -- это самый быстрый способ. Zigbee2MQTT устанавливается как аддон (дополнение) прямо из интерфейса HA. Не нужно трогать терминал, Docker или конфигурационные файлы.

Шаг 1: Установите MQTT-брокер Mosquitto

  1. Откройте Home Assistant: Settings -- Add-ons -- Add-on Store
  2. Найдите Mosquitto broker в списке Official add-ons
  3. Нажмите Install, дождитесь установки
  4. Включите Start on boot и нажмите Start

Mosquitto автоматически интегрируется с Home Assistant. Отдельно настраивать логин/пароль не нужно -- HA использует свои учётные данные.

Шаг 2: Добавьте репозиторий Zigbee2MQTT

  1. Перейдите в Settings -- Add-ons -- Add-on Store
  2. Нажмите на три точки в правом верхнем углу -- Repositories
  3. Вставьте URL: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
  4. Нажмите Add -- репозиторий появится в списке

Шаг 3: Установите Zigbee2MQTT

  1. Обновите страницу Add-on Store (потяните вниз или нажмите F5)
  2. В разделе Zigbee2MQTT найдите аддон и нажмите Install
  3. После установки перейдите на вкладку Configuration
  4. Укажите порт координатора (обычно определяется автоматически)
  5. Включите Start on boot и Watchdog
  6. Нажмите Start

Шаг 4: Проверьте работу

  1. Перейдите на вкладку Log в аддоне Zigbee2MQTT
  2. Убедитесь, что нет ошибок -- в логе должно быть «Zigbee2MQTT started!»
  3. В боковом меню HA появится пункт Zigbee2MQTT -- это веб-интерфейс Z2M

Готово. Установка занимает 5-10 минут.

Вариант 2: Docker (для Linux, NAS)

Если Home Assistant работает в Docker (не HA OS), или вы хотите запустить Z2M на отдельном сервере -- используйте Docker-контейнер. Этот вариант подходит для Linux-серверов, Synology, QNAP.

Подготовка: Docker и Docker Compose установлены, Mosquitto запущен, координатор подключён по USB. Определите порт координатора: ls -la /dev/serial/by-id/. Создайте docker-compose.yml:

services: zigbee2mqtt: image: koenkk/zigbee2mqtt restart: unless-stopped volumes: - ./zigbee2mqtt-data:/app/data - /run/udev:/run/udev:ro ports: - 8080:8080 environment: - TZ=Asia/Novosibirsk devices: - /dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_xxx:/dev/ttyACM0

Замените путь к устройству на свой. Запустите: docker compose up -d. Веб-интерфейс: http://IP-сервера:8080. Для Ethernet-координатора SLZB-06 вместо блока devices укажите в configuration.yaml: serial: port: tcp://IP-координатора:6638.

Вариант 3: Нативная установка (для продвинутых)

Установка напрямую на Linux без Docker. Нужен Node.js 18+. Клонируете репозиторий с GitHub, устанавливаете зависимости (npm ci), настраиваете configuration.yaml, запускаете (npm start) и настраиваете systemd-сервис для автозапуска.

Рекомендация: Если вы не знаете, что такое systemd -- выбирайте вариант 1 (аддон) или 2 (Docker). Нативная установка требует навыков Linux-администрирования.

Настройка Zigbee2MQTT

Вся конфигурация Zigbee2MQTT хранится в одном файле -- configuration.yaml. При установке аддоном он находится в /config/zigbee2mqtt/configuration.yaml, при Docker -- в папке, которую вы примонтировали.

Минимальная конфигурация

mqtt: base_topic: zigbee2mqtt server: mqtt://localhost serial: port: /dev/ttyACM0 # или tcp://192.168.1.100:6638 для SLZB-06 frontend: port: 8080 homeassistant: true permit_join: false # включается через веб-интерфейс по необходимости

Рекомендуемые дополнительные настройки

# Расширенные настройки advanced: network_key: GENERATE channel: 11 log_level: info last_seen: ISO_8601 transmit_power: 20 # Отслеживание доступности устройств availability: true # OTA-обновления прошивок ota: update_check_interval: 1440 disable_automatic_update_check: false

Настройка MQTT-брокера Mosquitto

Аддон Mosquitto в Home Assistant -- никакой дополнительной настройки не нужно, Z2M подключается автоматически. При Docker-установке Mosquitto запускается отдельным контейнером (образ eclipse-mosquitto:2, порт 1883).

Выбор канала Zigbee

Zigbee работает на частоте 2.4 ГГц -- той же, что и Wi-Fi. Рекомендуемые каналы: 11 (по умолчанию), 15, 20, 25 -- они меньше всего пересекаются с типичными Wi-Fi каналами (1, 6, 11).

Совет: Не меняйте канал Zigbee после добавления устройств -- потребуется перепривязка всех. Выберите канал при первоначальной настройке. Если сомневаетесь -- оставляйте 11.

Первый запуск

Веб-интерфейс Z2M: в боковом меню HA (аддон) или http://IP-сервера:8080 (Docker). Показывает список устройств, карту Zigbee-сети, логи, настройки, OTA-обновления. Отсюда включается режим сопряжения для добавления первого устройства.

Добавление устройств

Устройства добавляются через режим сопряжения (permit join). По умолчанию он выключен -- для безопасности. Общий принцип: откройте веб-интерфейс Z2M, нажмите «Permit join (All)» (включится на 254 секунды), переведите устройство в режим сопряжения, оно появится в списке через 10-60 секунд.

Как добавить датчик Aqara

Датчики температуры, движения, открытия двери

  1. Включите Permit join в Zigbee2MQTT
  2. Найдите на датчике кнопку сброса (маленькая, утопленная, нужна скрепка)
  3. Зажмите кнопку на 5 секунд -- светодиод мигнёт 3 раза
  4. Отпустите кнопку -- датчик начнёт поиск сети
  5. Через 10-30 секунд устройство появится в Zigbee2MQTT

Если не подключается: поднесите датчик ближе к координатору (в пределах 2-3 метров). После успешной привязки можно перенести в нужное место -- mesh-сеть обеспечит связь через промежуточные устройства.

Как добавить реле Sonoff

Sonoff ZBMINI, ZBMINI-L2, SNZB-01

  1. Включите Permit join в Zigbee2MQTT
  2. Подайте питание на реле (подключите к сети 220В)
  3. Зажмите кнопку на реле на 5 секунд -- светодиод начнёт мигать
  4. Устройство автоматически найдёт сеть и подключится

Реле Sonoff -- устройства с постоянным питанием, они работают как Zigbee-роутеры, усиливая сигнал для соседних устройств. Чем больше реле в квартире -- тем стабильнее mesh-сеть.

Как добавить лампу IKEA

IKEA TRADFRI лампы и пульты

  1. Включите Permit join в Zigbee2MQTT
  2. Лампа: выключите, затем включите лампу 6 раз подряд (с интервалом ~1 секунда). После шестого включения лампа мигнёт -- она в режиме сопряжения
  3. Пульт STYRBAR / RODRET: откройте крышку батарейного отсека, зажмите кнопку сброса на 5 секунд
  4. Устройство появится в Zigbee2MQTT через 10-30 секунд

Переименование и организация

После добавления устройства получают имена вроде 0x00158d000abcdef. Переименуйте их: в веб-интерфейсе Z2M кликните на устройство, вкладка Settings, измените Friendly name. Рекомендуем систему тип_комната: motion_corridor, door_entrance, temp_bathroom, light_kitchen. Это упростит автоматизации в Home Assistant.

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

Интеграция с Home Assistant

Zigbee2MQTT и Home Assistant связываются через MQTT. Настройка -- минимальная: включите параметр homeassistant: true в configuration.yaml (он включён по умолчанию), и все устройства автоматически появятся в HA.

MQTT-интеграция в Home Assistant

Подключение

  1. В Home Assistant: Settings -- Devices & Services -- Add Integration
  2. Найдите MQTT
  3. Если Mosquitto установлен как аддон -- HA обнаружит его автоматически, нажмите Submit
  4. Если Mosquitto на отдельном сервере -- укажите IP, порт (1883), логин и пароль

После подключения MQTT-интеграции все устройства из Zigbee2MQTT автоматически появятся в HA через механизм MQTT auto-discovery.

Auto-discovery

Z2M публикует конфигурационные MQTT-сообщения в топик homeassistant/. HA их читает и автоматически создаёт entities для каждого устройства: sensor.temp_bedroom_temperature, switch.switch_kitchen, binary_sensor.motion_hallway_occupancy, light.light_livingroom. Все entities сразу готовы: дашборд, автоматизации, история.

Дашборд и автоматизации

Устройства из Z2M сразу доступны для дашбордов HA: кнопки для выключателей, графики температуры датчиков, статус батареи и качество связи (LQI). Примеры автоматизаций:

  • Свет по движению: датчик (Z2M) фиксирует присутствие -- HA включает свет через реле (Z2M), задержка менее 200 мс
  • Уведомление о протечке: датчик Aqara (Z2M) -- HA отправляет push и перекрывает воду
  • Климат: датчик температуры (Z2M) ниже 21 -- HA включает тёплый пол
  • Binding: беспроводной выключатель управляет лампой напрямую через Zigbee, даже при выключенном сервере
Практика: в наших проектах при ремонте связка Zigbee2MQTT + Home Assistant управляет 30-80 Zigbee-устройствами в квартире: датчики движения, температуры, протечки, открытия дверей, беспроводные выключатели, умные розетки. Всё работает стабильно и локально.

Полезные функции Zigbee2MQTT

OTA-обновления прошивок

OTA (Over-The-Air) -- обновление прошивки устройства по воздуху. Z2M поддерживает OTA для IKEA, Sonoff, Legrand, Salus и других. Обновления исправляют баги, улучшают стабильность mesh-сети и закрывают уязвимости безопасности.

В веб-интерфейсе Z2M перейдите на вкладку OTA -- устройства с доступными обновлениями будут отмечены. Нажмите Update, процесс занимает 5-30 минут.

Внимание: Не отключайте питание устройства во время OTA-обновления. Прерванное обновление может «окирпичить» устройство.

Zigbee-группы

Группа -- набор устройств, получающих команду одновременно на уровне Zigbee-протокола. Группа «Свет гостиная» из 4 ламп -- одна команда, все включаются синхронно (при управлении по отдельности через HA будет задержка 50-100 мс между лампами).

Создание: вкладка Groups в Z2M, Add group, добавьте устройства. Группа появится в Home Assistant как отдельная entity.

Binding (прямая привязка)

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

Типичные сценарии: выключатель IKEA STYRBAR + лампа IKEA, кнопка Aqara + реле Sonoff, выключатель + группа ламп. Настройка: в Z2M откройте устройство-источник, вкладка Bind, выберите приёмник и кластер (on/off, level control).

Важно: Binding работает не со всеми устройствами -- оба должны поддерживать нужные кластеры. Проверяйте совместимость на zigbee2mqtt.io.

Touchlink

Touchlink -- способ сбросить Zigbee-устройство без физической кнопки. Полезно, когда устройство привязано к старому шлюзу. Z2M отправляет Touchlink Factory Reset, устройство сбрасывается к заводским настройкам. Работает с Philips Hue, IKEA TRADFRI. Координатор нужно поднести к устройству (10-20 см).

Карта сети

Z2M рисует карту Zigbee-mesh-сети: координатор, роутеры (устройства с питанием от сети), конечные устройства (датчики на батарейках), связи и качество сигнала (LQI). Карта помогает диагностировать проблемы: если датчик отваливается -- возможно, между ним и координатором нет роутеров. Добавьте умную розетку в промежуточную комнату.

Решение проблем

Координатор не определяется

Симптом: Z2M не запускается, в логах «Error: Failed to connect to the adapter».

  • Проверьте порт. Используйте путь через /dev/serial/by-id/ -- он стабильнее, чем /dev/ttyACM0 (номер меняется после перезагрузки)
  • Проброс USB в Docker. Убедитесь, что USB проброшено через devices в docker-compose.yml
  • Конфликт порта. Если запущен ZHA -- он блокирует порт. Остановите конкурирующие сервисы
  • USB-удлинитель. Удлинитель 0.5-1 м значительно улучшает стабильность (убирает помехи от компьютера)
  • Перепрошивка координатора. Обновите прошивку -- инструкции в документации Z2M

Устройство не подключается

  • Расстояние. Поднесите устройство к координатору (1-2 метра) на время сопряжения
  • Сброс. Factory reset перед подключением: зажать кнопку на 5-10 секунд
  • Старая привязка. Устройство привязано к другому шлюзу -- нужен полный сброс. Для ламп -- Touchlink
  • Совместимость. Проверьте модель на zigbee2mqtt.io/supported-devices
  • Канал. Старые Xiaomi работают не на всех каналах. Попробуйте 11 или 15

Устройство часто отваливается

  • Слабая mesh-сеть. Добавьте устройства с постоянным питанием (розетки, реле, лампы) в промежуточные комнаты -- они ретранслируют сигнал
  • Помехи Wi-Fi. Разнесите роутер и координатор минимум на 1-2 метра. Используйте USB-удлинитель
  • Батарейка. Проверьте уровень заряда в Z2M. Aqara работают 1-2 года на CR2032, дешёвые батарейки садятся раньше
  • Tuya-устройства. Дешёвые Tuya могут «забывать» сеть. Решение -- OTA-обновление или замена на Aqara / Sonoff
  • Прошивка координатора. Устаревшая прошивка вызывает потерю устройств при больших сетях (40+)

Конфликт с Wi-Fi

  • USB-удлинитель. Обязательно. Координатор на удлинителе 0.5-1 м работает значительно стабильнее
  • Разнести частоты. Wi-Fi канал 1 -- Zigbee канал 25. Wi-Fi канал 6 -- Zigbee канал 11. Wi-Fi канал 11 -- Zigbee канал 15
  • Wi-Fi 5 ГГц. Переведите устройства на 5 ГГц -- он не пересекается с Zigbee
  • Ethernet-координатор SLZB-06. Можно разместить далеко от роутера и сервера
Правило для стабильной Zigbee-сети: На каждые 5-7 конечных устройств (датчиков на батарейках) нужен хотя бы один роутер (устройство с постоянным питанием). В квартире 60-80 м² оптимально иметь 3-5 роутеров: умные розетки, реле, лампы. Они автоматически создают надёжную mesh-сеть.

Частые вопросы

Zigbee2MQTT бесплатный?

Да, полностью. Это open-source проект, код открыт на GitHub. Вы не платите ни за софт, ни за количество устройств, ни за обновления. Единственные расходы -- Zigbee-координатор (от 1 500 ₽) и сервер для работы Z2M (от 6 000 ₽ за Raspberry Pi до 15 000 ₽ за мини-ПК).

Чем Zigbee2MQTT лучше ZHA?

Больше поддерживаемых устройств (3 000+ vs ~2 500), быстрее выходит поддержка новинок, собственный веб-интерфейс, стабильнее при большом количестве устройств, поддержка OTA-обновлений прошивок, независимость от обновлений Home Assistant. ZHA проще установить (встроен в HA), но для серьёзных проектов Zigbee2MQTT надёжнее.

Какой координатор выбрать?

Для квартиры до 100 м² -- Sonoff ZBDongle-E (USB, 1 500-2 000 ₽). Для больших помещений или когда сервер стоит далеко от центра квартиры -- SLZB-06 (Ethernet, 4 000-5 000 ₽). Не покупайте устаревшие CC2531 -- они медленные и нестабильные. Подробнее о координаторах -- в статье про протокол Zigbee.

Можно ли использовать Zigbee2MQTT без Home Assistant?

Да. Z2M -- самостоятельный проект с собственным веб-интерфейсом. Он публикует данные в MQTT-брокер, а читать их может любая система: Node-RED, OpenHAB, ioBroker, Domoticz или собственный скрипт на Python. Но в связке с Home Assistant вы получаете автоматизации, дашборды, голосовое управление -- поэтому 95% пользователей используют Z2M именно с HA.

Сколько устройств можно подключить?

Один координатор поддерживает до 200 прямых подключений. Через Zigbee-роутеры (устройства с постоянным питанием) сеть расширяется практически без ограничений. В реальности домашние сети содержат 30-100 устройств -- любой современный координатор справится. На момент 2026 года Zigbee2MQTT поддерживает более 3 000 моделей от 400+ производителей.

Zigbee2MQTT работает без интернета?

Да, полностью локально. Все данные между устройствами, координатором, Z2M и Home Assistant передаются внутри вашей локальной сети. Интернет нужен только для установки, обновлений и OTA-прошивок. После настройки умный дом работает автономно.

Настроим Zigbee2MQTT при ремонте

Спроектируем Zigbee-сеть, подберём координатор и устройства, настроим Zigbee2MQTT + Home Assistant под ваши сценарии

ПОЗВОНИТЬ: +7 913 069-79-66

Или оставьте заявку на странице услуги «Умный дом»