Eclipse Mosquitto: настройка и использование MQTT-брокера
Обзор Eclipse Mosquitto – открытого MQTT-брокера, его установка, конфигурация и типичные сценарии применения в IoT и локальных сетях, и рекомендации по безопасной настройке.
Установка и базовая конфигурация
Установка пакета
Для установки Mosquitto используйте пакетный менеджер вашей ОС.
Примеры для популярных дистрибутивов:
bash# Debian / Ubuntu
sudo apt update
sudo apt install mosquitto mosquitto-clients
bash# Alpine Linux
sudo apk add mosquitto
bash# CentOS / RHEL (yum)
sudo yum install mosquitto mosquitto-clients
После установки сервис запускается автоматически, но стоит проверить его статус:
bashsudo systemctl status mosquitto
Если нужно включить автозапуск вручную:
bashsudo systemctl enable mosquitto
Важно: в небольших тестовых сетях достаточно одного процесса, но в продакшене рекомендуется разместить брокер в отдельном контейнере или виртуальной машине для изоляции.
Eclipse Mosquitto: настройка open source MQTT‑брокера
Настройка mosquitto.conf
Файл конфигурации находится в /etc/mosquitto/mosquitto.conf (путь может отличаться в зависимости от дистрибутива).
Минимальная конфигурация выглядит так:
conf# Слушать на всех интерфейсах TCP‑порту 1883 listener 1883 # Разрешить анонимное подключение (по умолчанию включено) allow_anonymous true # Путь к файлу с пользователями и паролями password_file /etc/mosquitto/passwd # Логирование в syslog (можно изменить на файл) log_type all
Добавление пользователей
Создайте файл паролей и добавьте запись:
bashsudo touch /etc/mosquitto/passwd
sudo mosquitto_passwd -c /etc/mosquitto/passwd user1
# При запросе введите пароль
Для добавления дополнительных пользователей без перезаписи флага -c:
bashsudo mosquitto_passwd /etc/mosquitto/passwd user2
Пример полной конфигурации с TLS
conflistener 8883 protocol mqtt # Путь к сертификату и ключу (пример для Let's Encrypt) cafile /etc/ssl/certs/ca-certificates.crt certfile /etc/ssl/certs/mosquitto.crt keyfile /etc/ssl/private/mosquitto.key # Требуется аутентификация allow_anonymous false # Включаем TLS require_certificate false
После изменения конфигурации перезапустите сервис:
bashsudo systemctl restart mosquitto
Проверьте, что брокер слушает нужные порты:
bashsudo netstat -tuln | grep mosquitto
Если всё корректно, можно приступать к тестированию подключения из клиентского приложения (например, mosquitto_pub и mosquitto_sub).
Во‑первых, базовая настройка завершена, и брокер готов к работе в локальной сети.
С практической точки зрения, рекомендуется сразу отключить allow_anonymous true и использовать авторизацию через файл паролей или интеграцию с внешним сервисом (LDAP, OAuth).
Если мы посмотрим на типичные сценарии применения, то в домашних IoT‑устройствах достаточно простого listener на 1883 без TLS, а в продакшене — listener на 8883 с TLS и авторизацией.
Основные концепции MQTT и роль брокера
Что такое MQTT
«MQTT» — лёгкий протокол сообщений по подписке (publish/subscribe). Он работает над TCP, использует минимальный объём заголовков, что делает его подходящим для устройств с ограниченными ресурсами. Внутри брокер получает сообщения от клиентов, рассылает их по заранее определённым темам (topics). Каждый клиент может подписаться на один или несколько тем, а также публиковать сообщения в любые темы.
Во-первых, MQTT поддерживает три уровня качества доставки (QoS):
- 0 — «по крайней мере один раз» (fire‑and‑forget);
- 1 — «не менее одного раза» (гарантированная доставка, без дублирования);
- 2 — «ровно один раз» (две фазы handshake, полностью надёжно).
С практической точки зрения, если вам нужна простая передача данных с датчиков, достаточно QoS 0. Если важна точность, выбирайте QoS 1 или 2.
Пример публикации температуры с датчика, работающего на Raspberry Pi:
bashmosquitto_pub -h localhost -t "home/room1/temperature" -m "23.5" -q 1
Здесь -h задаёт адрес брокера, -t — тему, -m — payload, -q — уровень качества.
Публикация и подписка
Клиент публикует сообщение, указывая тему и payload. Брокер принимает сообщение, проверяет подписки и рассылает его всем подписчикам этой темы. Подписчик же регистрирует интерес к теме и получает все сообщения, опубликованные в ней.
Пример подписки на тот же поток температуры:
bashmosquitto_sub -h localhost -t "home/room1/temperature" -v
Опция -v выводит полученные сообщения в консоль. Если сообщение было опубликовано с флагом retain, брокер сразу отправляет его подписчикам, даже если они подписались позже.
С практической точки зрения, удобно группировать темы по иерархии, используя символ “/” как разделитель:
- home/room1/temperature
- home/room1/humidity
- home/room2/+/temperature (wildcard + — любой уровень в иерархии)
Такой подход позволяет подписаться, например, на все температуры в доме, не перечисляя каждый отдельный датчик.
Если требуется безопасная настройка, стоит включить авторизацию (username/password) и шифрование TLS. Подробности по настройке TLS вы найдёте в Eclipse Mosquitto: настройка open source MQTT‑брокера.
Типичные сценарии применения
Типичные сценарии применения
Eclipse Mosquitto: настройка open source MQTT‑брокера
IoT‑устройства
Во-первых, Mosquitto удобно использовать в домашних IoT‑проектах, где требуется быстрый обмен данными между сенсорами, контроллерами и клиентскими приложениями.
Установка (на домашнем сервере под Ubuntu 22.04):
bashsudo apt update
sudo apt install -y mosquitto mosquitto-clients
После установки брокер запускается автоматически, но для работы с аутентификацией лучше создать файл паролей:
bashsudo mosquitto_passwd -c /etc/mosquitto/passwd alice
В конфигурационном файле /etc/mosquitto/mosquitto.conf добавляем:
confallow_anonymous false password_file /etc/mosquitto/passwd
Перезапускаем сервис:
bashsudo systemctl restart mosquitto
Пример подключения из Raspberry Pi (домашний сервер именуется vinni-pukh):
bashmosquitto_sub -h vinni-pukh -t "home/+/temperature" -u alice -P <password>
Данный запрос будет получать сообщения о температуре с любых датчиков, размещённых в поддоменах home/.
Типичные сценарии:
- Сенсоры температуры/влажности публикуют данные на тему
home/kitchen/temperature. - Умный термостат подписывается на
home/+/setpointи в реальном времени корректирует работу отопления. - Бэкап скрипт публикует событие
home/backup/started, после чего несколько сервисов могут реагировать (например, запуск резервного копирования).
Обмен сообщениями в микросервисах
Во-вторых, Mosquitto хорошо подходит для взаимодействия микросервисов внутри локальной сети или в контейнере Docker.
Docker‑Compose пример (три сервиса: auth, order, payment):
yamlversion: "3.8"
services:
mosquitto:
image: eclipse-mosquitto:2
container_name: mosquitto
ports:
- "1883:1883"
volumes:
- ./mosquitto/config:/mosquitto/config
- ./mosquitto/passwd:/mosquitto/passwd
restart: unless-stopped
auth:
image: myauth:latest
depends_on:
- mosquitto
environment:
- MQTT_BROKER=mosquitto
restart: unless-stopped
order:
image: myorder:latest
depends_on:
- mosquitto
restart: unless-stopped
payment:
image: mypayment:latest
depends_on:
- mosquitto
restart: unless-stopped
Конфигурация Mosquitto (mosquitto/config/mosquitto.conf):
confallow_anonymous false password_file /mosquitto/passwd listener 1883
Пример публикации из контейнера order (используем mosquitto_pub):
bashdocker exec -it order mosquitto_pub \
-h mosquitto -t "order/create" -m '{"order_id": 42, "product": "book"}' \
-u order_user -P <password>
Подписка в сервисе payment:
pythonimport paho.mqtt.client as mqtt
def on_message(client, userdata, msg):
print("Received:", msg.payload.decode())
client = mqtt.Client()
client.username_pw_set("payment_user", "secret")
client.on_message = on_message
client.connect("mosquitto", 1883, 60)
client.subscribe("order/create")
client.loop_forever()
Таким образом, микросервис payment получает уведомление о созданном заказе и может инициировать платеж без прямого вызова API другого сервиса.
Плюсы такого подхода:
- Декомпозиция: каждый сервис работает независимо, коммуникация происходит через один общий канал.
- Отказоустойчивость: если один сервис временно недоступен, сообщения остаются в брокере до его восстановления.
- Гибкость: новые сервисы могут подключаться, просто подписавшись на нужные темы, без изменения существующей инфраструктуры.
В реальной практике я использую Mosquitto в сочетании с Prometheus и Grafana для мониторинга количества сообщений и задержек, а также настраиваю TLS (см. отдельный гайд по защите MQTT‑соединения) для передачи данных в Production‑окружении.
Безопасность и масштабирование
Eclipse Mosquitto: настройка open source MQTT‑брокера
Аутентификация и TLS
Для безопасной работы MQTT‑брокера рекомендуется отключить анонимный доступ и использовать шифрование TLS.
Сначала создайте файл паролей и отключите вход без авторизации.
bash# создаём файл паролей (пример для пользователя alice)
sudo mosquitto_passwd -c /etc/mosquitto/passwd alice
# при необходимости добавляйте других пользователей
sudo mosquitto_passwd /etc/mosquitto/passwd bob
В конфигурационном файле mosquitto.conf задаём параметры:
ini# /etc/mosquitto/mosquitto.conf
allow_anonymous false # запрещаем вход без учётных данных
password_file /etc/mosquitto/passwd
# обычный нешифрованный listener
listener 1883
# зашифрованный listener с TLS
listener 8883
protocol mqtt
tls_version tlsv1.2
cafile /etc/ssl/certs/ca.crt
certfile /etc/ssl/certs/mosquitto.crt
keyfile /etc/ssl/private/mosquitto.key
require_certificate false # клиентская аутентификация не обязательна
Проверка подключения клиентом:
bashmosquitto_sub -h localhost -p 8883 -u alice -P secret --cafile /etc/ssl/certs/ca.crt
Клиент будет шифровать трафик и проходить проверку по паролю, что обеспечивает конфиденциальность и целостность сообщений.
Распределение и кластеризация
Для повышения доступности и отказоустойчивости можно запустить несколько экземпляров Mosquitto и распределить нагрузку через балансировщик.
Каждый брокер использует общий файл паролей и сертификаты, чтобы клиенты могли подключаться к любому из узлов.
Пример конфигураций двух узлов:
ini# /etc/mosquitto/mosquitto-1.conf
allow_anonymous false
password_file /etc/mosquitto/passwd
listener 1883
ini# /etc/mosquitto/mosquitto-2.conf
allow_anonymous false
password_file /etc/mosquitto/passwd
listener 1884
Далее настраиваем HAProxy для распределения входящих соединений:
cfgfrontend mosquitto_tcp bind *:1883 mode tcp default_backend brokers backend brokers balance roundrobin server broker1 192.168.1.10:1883 check server broker2 192.168.1.11:1884 check
Таким образом, клиентские приложения подключаются к единому виртуальному IP (1883), а HAProxy автоматически передаёт запрос одному из двух брокеров. При падении одного узла балансировщик перенаправит трафик на оставшийся, обеспечивая высокий уровень доступности.
Если требуется более тесная синхронизация состояния брокеров, можно включить плагин cluster (доступен в Mosquitto 2.x). Пример минимальной конфигурации:
ini# /etc/mosquitto/mosquitto.conf
cluster_name cluster1
listener 1883
allow_anonymous false
password_file /etc/mosquitto/passwd
Плагин использует общий хранилище (например, Redis) для обмена состоянием, что позволяет брокерам принимать решения в едином контексте. Настройка плагина выходит за рамки базовой статьи, но базовая идея проста: все узлы должны иметь одинаковый cluster_name и доступ к общему хранилищу.
В результате вы получаете гибкую архитектуру: отдельные узлы могут работать в режиме «один‑на‑один» для небольших лабораторий, а при росте нагрузки добавляются новые брокеры и обновляется конфигурация балансировщика без перезапуска клиентских приложений. Это соответствует принципу предсказуемости, который Алексей считает основой надёжной инфраструктуры.
Часто задаваемые вопросы
Как обеспечить безопасное подключение к Mosquitto через TLS?
Для включения TLS требуется добавить в mosquitto.conf параметры listener 8883 (или иной порт) и указать certfile и keyfile с сертификатом и приватным ключом. После этого в клиенте следует использовать параметр --tls-version TLSv1.2 (или выше) и указать файл с корневым сертификатом. При генерации самоподписанного сертификата удобно воспользоваться openssl req -new -x509 -days 365 -nodes -out mosquitto.crt -keyout mosquitto.key. Настройка TLS делает соединение зашифрованным и предотвращает перехват данных в локальной сети.
Нужно ли отключать allow_anonymous true при использовании пользовательской аутентификации?
Если брокер обслуживает аутентифицированных пользователей, рекомендуется отключить анонимный доступ, установив allow_anonymous false. Это гарантирует, что каждый клиент будет проходит проверку пароля, а не сможет публиковать или подписываться без авторизации. При этом можно оставить allow_anonymous true только для тестовых сценариев, где безопасность не критична. Отключение анонимного доступа упрощает аудит прав и повышает предсказуемость работы брокера.
Как настроить авторизацию по IP или ACL в Mosquitto?
Для ограничения доступа по IP используйте расширение acl_file, указав путь к файлу с правилами вида pattern readwrite username. В файле можно задать acl_file /etc/mosquitto/acl.conf и в mosquitto.conf добавить acl_file. Правила позволяют разрешать или запрещать публикацию и подписку для конкретных IP‑адресов или диапазонов, а также для определённых имён пользователей. Такой подход полезен в сценариях, когда требуется изолировать отдельные устройства или группы клиентов.
Как проверить, что Mosquitto слушает нужный порт и как смотреть логи?
Проверьте статус службы командой sudo systemctl status mosquitto, а затем выполните sudo netstat -tulnp | grep 1883 (или нужный порт) для подтверждения, что процесс слушает нужный порт. Для более детального анализа используйте sudo ss -tulnp | grep mosquitto. Логи можно просматривать через journalctl -u mosquitto -f для реального времени или открыть файл, указанный в log_type (например, /var/log/mosquitto/mosquitto.log). Регулярный мониторинг помогает быстро обнаружить отклонения в работе брокера.