Продвинутый

Eclipse Mosquitto: настройка и использование MQTT-брокера

Алексей Кузнецов
Алексей Кузнецов
Системный администратор17 ноября 2026 г.9 мин чтения

Обзор Eclipse Mosquitto – открытого MQTT-брокера, его установка, конфигурация и типичные сценарии применения в IoT и локальных сетях, и рекомендации по безоп...

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

После установки сервис запускается автоматически, но стоит проверить его статус:

bash
sudo systemctl status mosquitto

Если нужно включить автозапуск вручную:

bash
sudo 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

Добавление пользователей

Создайте файл паролей и добавьте запись:

bash
sudo touch /etc/mosquitto/passwd
sudo mosquitto_passwd -c /etc/mosquitto/passwd user1
# При запросе введите пароль

Для добавления дополнительных пользователей без перезаписи флага -c:

bash
sudo mosquitto_passwd /etc/mosquitto/passwd user2

Пример полной конфигурации с TLS

conf
listener 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

После изменения конфигурации перезапустите сервис:

bash
sudo systemctl restart mosquitto

Проверьте, что брокер слушает нужные порты:

bash
sudo 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:

bash
mosquitto_pub -h localhost -t "home/room1/temperature" -m "23.5" -q 1

Здесь -h задаёт адрес брокера, -t — тему, -m — payload, -q — уровень качества.

Публикация и подписка

Клиент публикует сообщение, указывая тему и payload. Брокер принимает сообщение, проверяет подписки и рассылает его всем подписчикам этой темы. Подписчик же регистрирует интерес к теме и получает все сообщения, опубликованные в ней.

Пример подписки на тот же поток температуры:

bash
mosquitto_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):

bash
sudo apt update
sudo apt install -y mosquitto mosquitto-clients

После установки брокер запускается автоматически, но для работы с аутентификацией лучше создать файл паролей:

bash
sudo mosquitto_passwd -c /etc/mosquitto/passwd alice

В конфигурационном файле /etc/mosquitto/mosquitto.conf добавляем:

conf
allow_anonymous false
password_file /etc/mosquitto/passwd

Перезапускаем сервис:

bash
sudo systemctl restart mosquitto

Пример подключения из Raspberry Pi (домашний сервер именуется vinni-pukh):

bash
mosquitto_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):

yaml
version: "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):

conf
allow_anonymous false
password_file /mosquitto/passwd
listener 1883

Пример публикации из контейнера order (используем mosquitto_pub):

bash
docker exec -it order mosquitto_pub \
  -h mosquitto -t "order/create" -m '{"order_id": 42, "product": "book"}' \
  -u order_user -P <password>

Подписка в сервисе payment:

python
import 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      # клиентская аутентификация не обязательна

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

bash
mosquitto_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 для распределения входящих соединений:

cfg
frontend 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). Регулярный мониторинг помогает быстро обнаружить отклонения в работе брокера.

Поделиться:TelegramX / TwitterVK

Читайте также