Как установить и настроить MQTT-интеграцию в Home Assistant

Зачем нужна интеграция MQTT

MQTT — лёгкий протокол обмена сообщениями между устройствами. Он используется для связи Home Assistant с внешними системами: Zigbee2MQTT, ESPHome, микроконтроллерами, датчиками, реле и другими IoT‑устройствами.

Этот протокол служит универсальным транспортом, позволяя передавать данные между устройствами и сервером автоматизации независимо от производителя. Благодаря MQTT Home Assistant может получать показания датчиков, отправлять команды и строить автоматизации поверх единой системы обмена данными.

Важно понимать: MQTT‑интеграция — это клиент, который подключается к MQTT‑брокеру. Home Assistant не содержит встроенного MQTT‑брокера, поэтому он должен быть установлен отдельно (Mosquitto Add-on или внешний сервер).

Подробнее о роли MQTT в Zigbee‑инфраструктуре читайте в статье Подключение Zigbee‑устройств к Home Assistant: обзор способов.

Установка интеграции MQTT

• Откройте интерфейс Home Assistant
• Перейдите в Настройки → Устройства и службы → Добавить интеграцию
• Найдите MQTT и выберите её
• Укажите параметры подключения к вашему MQTT‑брокеру (IP‑адрес, порт, логин и пароль) или воспользуйтесь значениями по умолчанию
• После сохранения Home Assistant подключится к брокеру и начнёт принимать и отправлять MQTT‑сообщения

Проверка подключения

Проверить работу MQTT‑интеграции можно двумя способами: через интерфейс Home Assistant и через консоль.

Способ 1: через интерфейс Home Assistant

• Перейдите в Настройки → Интеграции → MQTT
• Откройте раздел Настройки MQTT
• В блоке Слушать топик подпишитесь на test/topic
• В блоке Опубликовать данные введите: Топик — test/topic, Значение — hello mqtt, затем нажмите Опубликовать
• Если сообщение появится в блоке «Слушать топик», интеграция работает корректно

Способ 2: через консоль

Если вы используете Home Assistant OS, можно подключиться к системе через дополнение SSH & Web Terminal. Если вы работаете на другой системе (например, Ubuntu), подойдёт любой MQTT‑клиент — например, утилиты из пакета mosquitto-clients.

Подписаться на топик:

mosquitto_sub -h MQTT_SERVER_IP -t test/topic

Отправить сообщение:

mosquitto_pub -h MQTT_SERVER_IP -t test/topic -m "hello mqtt"

Если в терминале появится сообщение, значит брокер работает и Home Assistant корректно подключён к MQTT.

Заключение

MQTT — один из ключевых механизмов Home Assistant. Он обеспечивает быстрый и надёжный обмен данными между устройствами. Чтобы интеграция работала, необходим MQTT‑брокер — локальный или внешний. После подключения вы сможете использовать MQTT как основу для автоматизаций, получения данных от датчиков и управления устройствами.

Полезные ссылки

• Спецификация MQTT — официальный документ о том, как устройства обмениваются сообщениями и как работает механизм подписки и публикации