Установка MQTT брокера Mosquitto для Home Assistant

Введение

MQTT — это лёгкий протокол обмена сообщениями, который позволяет устройствам обмениваться данными через брокер. В экосистеме Home Assistant брокер MQTT — это центральное звено, обеспечивающее связь между датчиками, устройствами и системой автоматизации. Даже если вы не используете MQTT напрямую, он часто нужен для работы интеграций вроде Zigbee2MQTT, Tasmota или Shelly.

Подробнее о месте брокера в архитектуре системы можно прочитать в статье Подключение Zigbee-устройств к Home Assistant: обзор способов. Подробнее о подключении MQTT интеграции можно прочитать в статье Как установить и настроить MQTT‑интеграцию в Home Assistant.

Что такое Mosquitto

Eclipse Mosquitto — популярный брокер MQTT с открытым исходным кодом. Он лёгкий, надёжный и подходит для работы на устройствах с ограниченными ресурсами, таких как Raspberry Pi или мини‑сервер Home Assistant. Брокер выполняет роль посредника: принимает сообщения от устройств и передаёт их всем подписанным клиентам.

Установка Mosquitto в Home Assistant

Mosquitto можно установить как дополнение (add-on) напрямую из интерфейса Home Assistant OS или Supervised версии.

• Перейдите в Настройки → Аддоны → Магазин дополнений
• В поиске найдите Mosquitto broker
• Нажмите Установить и дождитесь завершения установки
• Откройте вкладку Конфигурация и оставьте стандартные параметры
• Нажмите Запустить и включите автозапуск при старте системы

Проверка работы брокера

После установки и запуска откройте журнал Mosquitto. Важные строки, которые подтверждают успешный запуск:

mosquitto version 2.0.22 starting
Opening ipv4 listen socket on port 1883
mosquitto version 2.0.22 running

Если они есть — брокер запустился корректно, порты открыты и готов к приёму подключений.

Проверка соединения

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

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

mosquitto_sub -h localhost -t test/topic

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

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

Если сообщение появится в консоли — брокер работает корректно и принимает подключения.

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

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