Настройка Zigbee2MQTT Home Assistant
Настраиваем интеграцию zigbee2mqtt в Home Assistant
Zigbee2MQTT – это дополнение, которое позволяет убрать сторонние Zigbee хабы. И подключать устройства через одни мост. Преимуществом является быстрая настройка и управление устройствами из одного места.
Если вы используете Docker, то воспользуйтесь другим руководством — Docker Zigbee2MQTT.
Поиск и определение адаптера
После подключения необходимо узнать, на каком порту появилось устройство. Для этого перейдем в терминал и выполним команду, узнать как установить терминал в Home Assistant:
ls -l /dev/serial/by-id
У нас появляется весь список подключенных к нашему серверу устройств. Так как все операции проходят на тестовом стенде то и устройство только одно: Sonoff Zigbee Dongle-E Plus
usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20220715153021-if00 -> ../../ttyACM0
Если у вы не обнаружили адаптер, то необходимо будет скачать драйвера для вашей операционной системы. Как правило производитель выкладывает их на своем официальном сайте. В основном проблема встречается на Windows и Mac OS. У Linux и Unix систем поддержка устройств идет «из коробки».
Установка Mosquitto Broker Home Assistant
Далее нам необходим сам MQTT брокер. Который будет принимать и отсылать информацию между устройствами сети.
- Переходим в «Настройки»
- Далее «Дополнения»
- В левом нижнем углу будет кнопка «Магазин дополнений», нажимаем на нее
- В поиске вбиваем «Mosquitto broker»
- Заходим в карточку и нажимаем «Установить»
- После установки запускаем аддон и ставил галочку Watchdog
Необходимо будет установить логин и пароль для MQTT брокера. В конфигурации дополнения
- username: myuser
password: mypassword
Далее заходим в список наших интеграций и Home Assistant сам предложить нам донастроить MQTT. Просто нажимаем настроить и все. Вводить ничего никуда не нужно.
Установка Zigbee2MQTT Home Assistant
Zigbee2MQTT не входит в перечень стандартных дополнений, для его установки потребуется подключение из стороннего хранилища.
- Повторяем первые 3 пункта из установки Mosquitto Broker
- На странице магазина дополнений нажимаем на три точки в левом верхнем углу и переходим в «Репозитории»
- Вставляем ссылку
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt - Нажимаем «добавить»
- Перезагружаем HA
После этого возвращаемся в магазин и у нас появляется 3 новых дополнения.
- Zigbee2MQTT — актуальная, стабильная версия.
- Zigbee2MQTT Edge — бета версия, в которой есть новый функционал. Но она не гарантирует стабильную работу системы.
- Zigbee2MQTT Proxy — служит как прокси для внешнего Zigbee2MQTT. Единственный смысл — это добавление на боковую панель Home Assistant уже настроенного экземпляра.
Нас интересует первый, устанавливаем его, не забыв проставить галочку Watchdog.
После чего переходим в конфигурацию Zigbee2MQTT.
mqtt:
base_topic: zigbee2mqtt
server: mqtt://core-mosquitto:1883
user: myuser
password: mypassword
serial
adapter: ezsp
port: >-
/dev/serial/by-id/...
Вместо трех точек в графе порт вписываем свой стик, который искали в самом первом пункте. Если у вас такой же стик zigbee 3.0 usb dongle, то дополнительно указываем адаптер.
Должно получиться так
На этом все, теперь переходим в меню Zigbee2MQTT и добавляем необходимые устройства.
Обсуждение
Денися бессилен, все перепробовал, не запускается Z2M. Исходные данные: HAOS OS 17.0, Dongle-M (Lan).
Mosquitto broker:
services-up: info: copying legacy longrun nginx (no readiness notification)
17:36:04 INFO: Starting NGINX for authentication handling…
s6-rc: info: service legacy-services successfully started
17:36:05 INFO: Starting mosquitto MQTT broker…
2026-02-03 17:36:05: Warning: Mosquitto should not be run as root/administrator.
2026-02-03 17:36:05: mosquitto version 2.0.22 starting
2026-02-03 17:36:05: Config loaded from /etc/mosquitto/mosquitto.conf.
2026-02-03 17:36:05: Loading plugin: /usr/share/mosquitto/go-auth.so
2026-02-03 17:36:05: ├── Username/password checking enabled.
2026-02-03 17:36:05: ├── TLS-PSK checking enabled.
2026-02-03 17:36:05: └── Extended authentication not enabled.
2026-02-03 17:36:05: Opening ipv4 listen socket on port 1883.
2026-02-03 17:36:05: Opening ipv6 listen socket on port 1883.
2026-02-03 17:36:05: Opening websockets listen socket on port 1884.
2026-02-03 17:36:05: mosquitto version 2.0.22 running
2026-02-03 17:36:05: New connection from ::1:59190 on port 1883.
2026-02-03 17:36:05: Client disconnected due to protocol error.
17:36:06 INFO: Successfully send discovery information to Home Assistant.
17:36:06 INFO: Successfully send service information to the Supervisor.
2026-02-03 17:36:52: New connection from 172.30.32.1:47481 on port 1883.
2026-02-03 17:36:52: New client connected from 172.30.32.1:47481 as 0EUZHEhADl91jWhgrSPvrw (p2, c1, k60, u’mqtt’).
Zigbee2MQTT:
2026-02-03 17:43:59 info: zh:ember:uart:ash: ======== ASH stopped ========
2026-02-03 17:43:59 error: zh:ember:uart:ash: Failed to init port with error AggregateError
2026-02-03 17:43:59 error: z2m: Error while starting zigbee-herdsman
2026-02-03 17:43:59 error: z2m: Failed to start zigbee-herdsman
2026-02-03 17:43:59 error: z2m: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start_crashes-runtime.html for possible solutions
2026-02-03 17:43:59 error: z2m: Exiting…
2026-02-03 17:43:59 error: z2m: Error: Failed to start EZSP layer with status=HOST_FATAL_ERROR.
at EmberAdapter.initEzsp (/app/node_modules/.pnpm/zigbee-herdsman@9.0.2/node_modules/zigbee-herdsman/src/adapter/ember/adapter/emberAdapter.ts:666:19)
at processTicksAndRejections (node:internal/process/task_queues:105:5)
at EmberAdapter.start (/app/node_modules/.pnpm/zigbee-herdsman@9.0.2/node_modules/zigbee-herdsman/src/adapter/ember/adapter/emberAdapter.ts:1538:24)
at Controller.start (/app/node_modules/.pnpm/zigbee-herdsman@9.0.2/node_modules/zigbee-herdsman/src/controller/controller.ts:143:29)
at Zigbee.start (/app/lib/zigbee.ts:70:27)
at Controller.start (/app/lib/controller.ts:101:13)
at start (/app/index.js:149:5)
17:44:34 INFO: Preparing to start…
17:44:34 INFO: Socat not enabled
17:44:34 INFO: Starting Zigbee2MQTT…
Starting Zigbee2MQTT without watchdog.
Onboarding page is available at http://0.0.0.0:8099/
AleksЗдравствуйте! Подскажите, настроил Z2MQTT, добавил два датчика (открытие двери, датчик температуры (влажности..). Хочу написать автоматизацию, чтобы при открытии двери приходило сообщение в телеграм (раньше так было у меня). При созданиии автоматизации в перечне устройств нет моих датчиков. Установил node-red ( там тоже датчиков не видно), куда копать??? Спасибо
АлексейБольшое спасибо, но можно по подробнее что за галка
АндрейПопробуй снять галку rtst/true
АлексейДоброе время суток, у меня Home Assistant OC на ПК. Адаптер: Sonof модель: ZBDongle-E. Прошит до 8 версии. Устанавливаю Zigbee2MQTT согласно инструкции. адаптер устанавливал как ezsp так ember. Выдаёт ошибку: 12:46:59 INFO: Preparing to start…
12:46:59 INFO: Socat not enabled
12:46:59 INFO: Starting Zigbee2MQTT…
Starting Zigbee2MQTT without watchdog.
Onboarding page is available at http://0.0.0.0:8099/
если можете подскажите как исправить
ЭдуардВам удалось решить эту проблему?
ЕвгенийОшибка сохранилась
Не помогло(
Alexander Pushkarevпопробуйте указать adapter: ember
ЕвгенийДОброй ночи
Помогите плиз? не могу запустить после всех настроек 2MQTT
Конфигурация:
adapter: ezsp
port: >-
/dev/serial/by-id/usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_2ac6d1270174ef11997cdb1e313510fd-if00-port0
Логи:
02:32:14 INFO: Preparing to start…
02:32:14 INFO: Socat not enabled
02:32:15 INFO: Starting Zigbee2MQTT…
Starting Zigbee2MQTT without watchdog.
Onboarding page is available at http://0.0.0.0:8099/
02:34:59 INFO: Preparing to start…
02:35:00 INFO: Socat not enabled
02:35:00 INFO: Starting Zigbee2MQTT…
Starting Zigbee2MQTT without watchdog.
Onboarding page is available at http://0.0.0.0:8099/
2025-07-05 02:37:06 info: z2m: Logging to console, file (filename: log.log)
2025-07-05 02:37:06 info: z2m: Starting Zigbee2MQTT version 2.5.1 (commit #unknown)
2025-07-05 02:37:06 info: z2m: Starting zigbee-herdsman (4.3.1)
2025-07-05 02:37:06 warning: zh:ezsp: ‘ezsp’ driver is deprecated and will only remain to provide support for older firmware (pre 7.4.x). Migration to ’ember’ is recommended. If using Zigbee2MQTT see https://github.com/Koenkk/zigbee2mqtt/discussions/21462
2025-07-05 02:37:16 error: zh:ezsp:uart: –> Error: Error: {“sequence”:-1} after 10000ms
2025-07-05 02:37:16 error: zh:ezsp:ezsp: Connection attempt 1 error: Error: Failure to connect
2025-07-05 02:37:56 error: zh:ezsp:uart: –> Error: Error: {“sequence”:-1} after 10000ms
2025-07-05 02:37:56 error: zh:ezsp:ezsp: Connection attempt 2 error: Error: Failure to connect
02:38:17 INFO: Preparing to start…
02:38:17 INFO: Socat not enabled
02:38:17 INFO: Starting Zigbee2MQTT…
Starting Zigbee2MQTT without watchdog.
Onboarding page is available at http://0.0.0.0:8099/
СергейПосле обнаружения устройств на панели Zigbee2MQTT пытаюсь сделать автоматизацию, не могу выбрать обнаруженные устройства, как создавать автоматизации с обнаруженными устройствами?
