Платформа автоматизации умного дома с открытым исходным кодом: работает локально и ставит во главу угла контроль и приватность, часто — на Raspberry Pi или локальном сервере.
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
Следуйте руководству по началу работы в официальной документации
Что важно знать
- Проект распространяется по лицензии 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 обновляется ежедневно.
Похожие проекты
Система на основе конфигураций, которая превращает микроконтроллеры ESP32, ESP8266, BK72xx и RP2040 в умные устройства для управления через Home Assistant и другие системы автоматизации дома.
Контроллер зарядки электромобилей и система управления энергией дома с открытым исходным кодом: оптимизирует зарядку через wallbox с учетом солнечной генерации и данных батареи, работает локально без облачных сервисов.
Официальная интеграция Xiaomi для управления IoT-устройствами Xiaomi в Home Assistant через Xiaomi Cloud или локальный шлюз центрального хаба Xiaomi.
Платформа для интеграции домашнего видеонаблюдения и NVR с собственным хостингом, умными детекциями и трансляцией с камер в HomeKit, Google Home и Alexa.
Библиотека Python и CLI-инструмент miiocli для управления устройствами умного дома Xiaomi по протоколам miIO и MIoT.