Repolode
Koenkk

Koenkk/zigbee2mqtt

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

Open source альтернатива:Philips Hue Bridge

Звёзды
15,755
Форки
2,029
Открытые issues
487
Последний коммит
3 дня назад

Что это?

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

Проект написан на TypeScript и работает как сервис на хосте с поддерживаемым адаптером Zigbee. Он состоит из трёх уровней: zigbee-herdsman отвечает за взаимодействие с адаптером, zigbee-herdsman-converters сопоставляет модели устройств с их кластерами Zigbee, а сам Zigbee2MQTT преобразует сообщения между Zigbee и MQTT. В проект входят веб-интерфейсы для мониторинга и настройки.

Сведения о поддерживаемых устройствах собраны в опубликованном списке совместимого оборудования, а поддержку новых устройств можно добавить, написав код конвертера. В документации описаны официальные интеграции с Home Assistant, Homey, Domoticz, Gladys Assistant и ioBroker.

Ключевые возможности

  • 01Управляет устройствами Zigbee, публикуя сообщения в MQTT-топики и подписываясь на них.
  • 02Работает без фирменного моста или шлюза Zigbee от производителя.
  • 03Включает веб-интерфейсы для мониторинга и настройки сети.
  • 04Поддерживает общедоступный список устройств от множества производителей.
  • 05Предлагает документированные интеграции с Home Assistant, Homey, Domoticz и другими системами.

Сценарии использования

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

Быстрый старт

  1. 1

    Следуйте руководству по началу работы в официальной документации

Что важно знать

  • Проект распространяется по лицензии GPL-3.0 — лицензии с авторским левом, которая требует выпускать производные работы с открытым исходным кодом на тех же условиях.
  • Поддерживаются не все устройства Zigbee, поэтому для устройств, которых нет в списке, может потребоваться добавить поддержку.

Темы

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

Что такое zigbee2mqtt?
Мост для подключения устройств умного дома Zigbee к MQTT, чтобы они работали без фирменного хаба или шлюза производителя. Zigbee2MQTT напрямую взаимодействует с адаптером координатора Zigbee и публикует события и состояние устройств через MQTT. Пользователи могут управлять Zigbee-светильниками, датчиками, выключателями и другими устройствами через MQTT-топики, подключая оборудование Zigbee к любой системе домашней автоматизации с поддержкой MQTT.
zigbee2mqtt можно использовать бесплатно? Какая у него лицензия?
zigbee2mqtt распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
zigbee2mqtt всё ещё поддерживается?
Активно поддерживается. Последний коммит в zigbee2mqtt — 21 окт. 2026 г..
Для чего можно использовать zigbee2mqtt?
Настройка локального умного дома без облачных хабов производителей. Передача показаний датчиков Zigbee в существующую систему автоматизации на базе MQTT. Подключение к Home Assistant и похожим платформам Zigbee-устройств, которые не поддерживаются производителем.
Как установить zigbee2mqtt?
Следуйте руководству по началу работы в официальной документации
Где скачать zigbee2mqtt?
Исходный код и инструкции по установке — на GitHub: https://github.com/Koenkk/zigbee2mqtt

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Платформа автоматизации умного дома с открытым исходным кодом: работает локально и ставит во главу угла контроль и приватность, часто — на Raspberry Pi или локальном сервере.

91,7 тыс.+28 за неделю39 тыс.PythonApache-2.0Обновлён 19 часов назад

Система на основе конфигураций, которая превращает микроконтроллеры ESP32, ESP8266, BK72xx и RP2040 в умные устройства для управления через Home Assistant и другие системы автоматизации дома.

11,9 тыс.5,7 тыс.C++OtherОбновлён 19 часов назад

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

7,4 тыс.+4 за неделю1,6 тыс.GoMITОбновлён 20 часов назад