Продвинутый

Eclipse Mosquitto: Open Source MQTT Broker Setup

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

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

Eclipse Mosquitto: Open Source MQTT Broker Setup

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

Обзор Eclipse Mosquitto и его возможности

### Что такое MQTT и зачем нужен Mosquitto

MQTT — это лёгкий протокол обмена сообщениями по шине публикаций‑подписки. Он работает поверх TCP, использует минимальный объём заголовков (2 байта) и позволяет клиентам отправлять (публиковать) данные без необходимости знать о получателях. За счёт этого протокола подходят для устройств с ограниченными ресурсами: микроконтроллеры, Raspberry Pi, умные датчики и т.п.

Для домашней лаборатории типичный сценарий выглядит так: несколько датчиков в разных комнатах публикуют параметры (температуру, влажность) на топик home/sensors/+/temperature. Брокер Mosquitto принимает эти сообщения и рассылает их подписанным клиентам, например, Plex для визуализации или к скрипту, который делает автоматический бэкап фотографий.

Пример установки Mosquitto на Ubuntu 22.04

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

После установки сервис запускается автоматически и слушает порт 1883:

bash
sudo systemctl status mosquitto

Публикация тестового сообщения

bash
mosquitto_pub -t "home/test" -m "hello, world"

Подписка и просмотр полученного сообщения

bash
mosquitto_sub -t "home/test"

Если в вашей сети есть удалённые клиенты, достаточно открыть порт 1883 в фаерволе и, при необходимости, добавить авторизацию через файл /etc/mosquitto/conf.d/password.file. Подробнее о настройке – в [Eclipse Mosquitto: настройка open source MQTT‑брокера].


### Ключевые особенности брокера

ОсобенностьЧто даётПример конфигурации
Поддержка MQTT 5.0 и 3.1.1Новые возможности (например, Shared Subscription) и обратная совместимостьprotocol_version mqtt5 в файле mosquitto.conf
ПersistenceСохранение сообщений и подписок при перезапуске брокераpersistence true<br>persistence_location /var/lib/mosquitto
ACL (Access Control List)Точная настройка прав per‑user/per‑topicФайл acl.conf:<br>user anton<br>topic readwrite home/sensors/+/temperature
TLS/SSLЗащищённый канал для удалённых клиентовlistener 8883<br>certfile /etc/mosquitto/certs/server.crt<br>keyfile /etc/mosquitto/certs/server.key<br>require_certificate false
BridgeПеренаправление сообщений между разными брокерамиbridge_address mqtt.example.com:1883<br>bridge_username bridge_user<br>bridge_password bridge_pass
WebSocketsДоступ из браузеров и мобильных приложенийwebsocket_port 8083<br>websocket_path /mqtt
QoS 0/1/2Три уровня доставки: «не гарантировано», «по крайней мере один раз», «точно один раз»При публикации: mosquitto_pub -t topic -m payload -q 1
Retained messagesСообщение сохраняется в брокере и сразу доставляется новым подписчикамmosquitto_pub -t home/status -m "online" -r
Last Will and Testament (LWT)Уведомление о неожиданном отключении клиентаПри подключении: mosquitto_sub -t home/sensors/+/LWT -Qo 1 -Will "offline"

Пример включения persistence и ACL

/etc/mosquitto/conf.d/persistence.conf

conf
persistence true
persistence_location /var/lib/mosquitto

/etc/mosquitto/conf.d/acl.conf

conf
acl_file /etc/mosquitto/acl.conf

/etc/mosquitto/acl.conf

conf
user anton
topic readwrite home/sensors/+/temperature
user guest
topic readwrite #

Запуск Mosquitto в Docker (для быстрого прототипа)

bash
docker run -d \
  --name mosquitto \
  -p 1883:1883 -p 9001:9001 \
  -v /path/to/config:/mosquitto/config \
  -v /path/to/data:/mosquitto/data \
  eclipse-mosquitto:2

Mosquitto — это проверенный, открытый брокер, который легко вписывается в любую домашнюю лабораторию и при необходимости масштабируется до продакшена. Его гибкая конфигурация, поддержка современных протокольных версий и богатый набор функций делают его надёжным основанием для любых IoT‑проектов.

Установка и базовая конфигурация

Eclipse Mosquitto: настройка open source MQTT‑брокера

Установка через пакетный менеджер

Во-первых, в большинстве дистрибутивов Linux Mosquitto доступен в официальных репозиториях.
Для Debian и Ubuntu удобно использовать apt:

bash
sudo apt update
sudo apt install mosquitto mosquitto-clients

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

bash
sudo systemctl status mosquitto

Для Alpine Linux команда выглядит так:

bash
sudo apk add mosquitto mosquitto-clients
sudo rc-service mosquitto start

В CentOS 7 и выше предпочтительнее yum или dnf:

bash
sudo yum install mosquitto mosquitto-clients   # или
sudo dnf install mosquitto mosquitto-clients
sudo systemctl enable mosquitto
sudo systemctl start mosquitto

Проверка работоспособности – подключение клиентом mosquitto_sub к локальному брокеру:

bash
mosquitto_sub -t "test/topic"

В другом терминале публикуем сообщение:

bash
mosquitto_pub -t "test/topic" -m "hello world"

Если сообщение появилось в подписчике, установка прошла успешно.

Настройка конфигурационного файла mosquitto.conf

Основной файл конфигурации – /etc/mosquitto/mosquitto.conf.
Он содержит список включаемых файлов и параметры по умолчанию. Для базовой настройки достаточно задать слушающий порт и указать файл паролей.

Пример минимального mosquitto.conf:

conf
# Порт, на котором брокер будет принимать подключения
listener 1883

# Путь к файлу с пользователями и паролями (создаётся командой mosquitto_passwd)
password_file /etc/mosquitto/passwd

# Разрешаем анонимное подключение (по умолчанию включено)
allow_anonymous true

# Логи – куда писать сообщения брокера
log_dest file /var/log/mosquitto/mosquitto.log

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

bash
sudo systemctl restart mosquitto

Создание пользователя и пароля:

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

Команда запросит пароль, после чего в файле /etc/mosquitto/passwd появится запись alice:password.
Для добавления других пользователей используйте без -c:

bash
sudo mosquitto_passwd /etc/mosquitto/passwd bob

Если требуется TLS‑шифрование, достаточно добавить строки:

conf
listener 8883
certfile /etc/mosquitto/certs/server.crt
keyfile /etc/mosquitto/certs/server.key
require_certificate false

Но для домашней лаборатории обычно достаточно plain‑text на локальном сети.

Справедливая настройка – это гарантия предсказуемости работы брокера. Поэтому рекомендуется хранить конфиги в системе контроля версий, а изменения проверять через diff.

Если нужны более детальные примеры и рекомендации по Tuning, см. полную статью о настройке Eclipse Mosquitto: настройка open source MQTT‑брокера.

Практические сценарии использования

Домашний IoT и домашняя лаборатория

Во-первых, Mosquitto удобно использовать в небольших сетях, где несколько датчиков, контроллеров и мобильных приложений общаются по MQTT.
Для простого развертывания на домашнем сервере (домашний сервер — это ваш физический или виртуальный хост в домашней сети) достаточно установить пакет и включить сервис systemd.

bash
sudo apt update && sudo apt install mosquitto mosquitto-clients
sudo systemctl enable --now mosquitto

После установки файл конфигурации находится в /etc/mosquitto/mosquitto.conf.
Минимальная конфигурация выглядит так:

conf
listener 1883
allow_anonymous true
# password_file /etc/mosquitto/passwd   # раскомментировать при использовании авторизации

Если требуется авторизация, создайте файл паролей:

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

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

bash
sudo systemctl restart mosquitto

Пример работы

Публикация температуры с Raspberry Pi:

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

Подписка с другого устройства (например, с ноутбука):

bash
mosquitto_sub -h localhost -t "home/room1/temperature"

Таким образом, в домашней лаборатории можно быстро собрать систему мониторинга без дополнительных сервисов.

Если понадобится более гибкая сеть тем, используйте Docker Compose. Ниже пример docker-compose.yml для Mosquitto:

yaml
version: "3.8"
services:
  mosquitto:
    image: eclipse-mosquitto:2
    ports:
      - "1883:1883"
    volumes:
      - ./mosquitto.conf:/mosquitto/config/mosquitto.conf:ro

Поместите свой mosquitto.conf в каталог рядом с docker-compose.yml и запустите:

bash
docker compose up -d

Интеграция с Kubernetes и Docker Compose

С практической точки зрения удобно использовать Mosquitto в контейнере, особенно когда инфраструктура уже построена на Kubernetes (k3s, Rancher, обычный кластер).

Docker Compose

Для локального теста можно запустить брокер в контейнере, как показано выше. Это удобно, когда нужно быстро проверить работу MQTT‑клиентов без установки Mosquitto на хост.

Kubernetes

В Kubernetes Mosquitto обычно разворачивают через Helm‑чарт или как отдельный Deployment с ConfigMap‑ом конфигурации. Пример манифеста Deployment и Service:

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: mosquitto
spec:
  replicas: 1
  selector:
    matchLabels:
      app: mosquitto
  template:
    metadata:
      labels:
        app: mosquitto
    spec:
      containers:
        - name: mosquitto
          image: eclipse-mosquitto:2
          ports:
            - containerPort: 1883
          volumeMounts:
            - name: config
              mountPath: /mosquitto/config
      volumes:
        - name: config
          configMap:
            name: mosquitto-config
---
apiVersion: v1
kind: Service
metadata:
  name: mosquitto
spec:
  selector:
    app: mosquitto
  ports:
    - protocol: TCP
      port: 1883
      targetPort: 1883
  type: ClusterIP

Конфигурационный ConfigMap (mosquitto-config.yaml):

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: mosquitto-config
data:
  mosquitto.conf: |
    listener 1883
    allow_anonymous true
    # password_file /mosquitto/config/passwd   # при необходимости

Примените манифесты:

bash
kubectl apply -f mosquitto-config.yaml
kubectl apply -f deployment.yaml

После запуска брокер будет доступен внутри кластера по имени mosquitto и порту 1883. Для внешнего доступа можно добавить Ingress‑или LoadBalancer‑сервис.

Связь с другими материалами
Подробнее о базовой настройке open source MQTT‑брокера см. в статье Eclipse Mosquitto: настройка open source MQTT‑брокера.

Таким образом, Mosquitto легко вписывается в как домашнюю лабораторию, так и в продакшн‑кластеры, обеспечивая предсказуемую работу и простую интеграцию с Docker Compose и Kubernetes.

Безопасность и масштабирование

Eclipse Mosquitto: настройка open source MQTT‑брокера

Настройка TLS и авторизации

TLS защищает соединение между клиентом и брокером, а авторизация исключает неавторизованный доступ. В домашней лаборатории достаточно самоподписанных сертификатов, в продакшене – сертификаты от доверенного центра.

Шаг 1. Генерация сертификатов

bash
# создаём корневой сертификат (CA)
openssl req -new -x509 -days 365 -nodes \
    -out /etc/mosquitto/certs/ca.crt \
    -keyout /etc/mosquitto/certs/ca.key \
    -subj "/C=RU/ST=Moscow/L=Moscow/O=MyLab/OU=CA/CN=mosquitto-ca"

# создаём серверный сертификат, подписанный CA
openssl req -new -nodes \
    -out /etc/mosquitto/certs/server.csr \
    -keyout /etc/mosquitto/certs/server.key \
    -subj "/C=RU/ST=Moscow/L=Moscow/O=MyLab/OU=Broker/CN=broker.example.com"

openssl x509 -req -in /etc/mosquitto/certs/server.csr \
    -CA /etc/mosquitto/certs/ca.crt -CAkey /etc/mosquitto/certs/ca.key \
    -CAcreateserial -out /etc/mosquitto/certs/server.crt -days 365

Шаг 2. Формирование файла паролей

bash
# создаём файл паролей, первый пользователь «alice» с паролем «s3cr3t»
mosquitto_passwd -c /etc/mosquitto/passwd alice
# при необходимости добавляем ещё пользователей
mosquitto_passwd /etc/mosquitto/passwd bob

Шаг 3. Конфигурация Mosquitto

ini
# /etc/mosquitto/conf.d/tls_listener.conf
listener 8883
protocol mqtt
 cafile /etc/mosquitto/certs/ca.crt
 certfile /etc/mosquitto/certs/server.crt
 keyfile /etc/mosquitto/certs/server.key
 require_certificate false          # если требуется клиентский сертификат – установить true
 password_file /etc/mosquitto/passwd
 allow_anonymous false

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

bash
systemctl restart mosquitto

Проверка

bash
# подключаемся с TLS и авторизацией
mosquitto_pub -h broker.example.com -p 8883 --cafile /etc/mosquitto/certs/ca.crt \
    --username alice --password s3cr3t -t "test/topic" -m "hello"

Если публикация прошла без ошибок, TLS и авторизация работают корректно.


Горизонтальное масштабирование и кластеризация

Один экземпляр Mosquitto хорошо справляется с небольшим трафиком, но при росте нагрузки удобно запускать несколько брокеров и распределять соединения между ними. Суть кластеризации – общая конфигурация и синхронизация сообщений через общий хранилище (например, файловый ресурс или Redis).

Вариант 1. Кластеризация через общий файловый ресурс
Для простоты можно использовать NFS или Samba‑раздел, доступный всем узлам. Каждый брокер читает один и тот же файл с ACL‑правилами и сохраняет сообщения на диск.

bash
# пример mount NFS на всех серверах
mount -t nfs server-nfs:/mosquitto_data /var/lib/mosquitto

Конфигурация (одинаковая для всех узлов, отличается только host_id):

ini
# /etc/mosquitto/conf.d/clustering.conf
cluster_name my_cluster
host_id 1                # уникальный идентификатор узла
# путь к общему хранилищу сообщений
 persistence_location /var/lib/mosquitto/messages

Вариант 2. Кластеризация через Redis
Если требуется более надёжная синхронизация, используем Redis как бекенд для сообщений. Mosquitto поддерживает плагин mosquitto-plugin-redis.

yaml
# docker‑compose.yml (часть сервиса mosquitto)
version: "3.8"
services:
  mosquitto:
    image: eclipse-mosquitto:2
    ports:
      - "1883:1883"
      - "8883:8883"
    volumes:
      - ./mosquitto.conf:/mosquitto/config/mosquitto.conf:ro
      - ./redis.conf:/mosquitto/config/redis.conf:ro
    environment:
      - REDIS_HOST=redis
    depends_on:
      - redis
  redis:
    image: redis:7-alpine
    restart: always

В redis.conf указываем параметры, а в mosquitto.conf добавляем:

ini
# /etc/mosquitto/conf.d/redis_plugin.conf
plugin_dir /usr/lib/mosquitto/
plugin_prefix mosquitto_
backend_address redis://redis:6379
backend_topic_prefix mosquitto/

После старта каждый брокер будет публиковать и подписываться на общие топики через Redis, что обеспечивает горизонтальное масштабирование.

Балансировка нагрузки
Для распределения входящих соединений удобно ставить Reverse Proxy (HAProxy или Caddy) перед несколькими экземплярами Mosquitto. Пример конфигурации HAProxy:

ini
# /etc/haproxy/haproxy.cfg
global
    log /dev/log    local0
    maxconn 2000
    daemon

defaults
    log     global
    mode    tcp
    option  tcplog
    timeout connect 5000
    timeout client  50000
    timeout server  50000

frontend mosquitto_tls
    bind *:8883
    mode tcp
    default_backend mosquitto_backends

backend mosquitto_backends
    balance roundrobin
    server broker1 10.0.0.11:8883 check
    server broker2 10.0.0.12:8883 check

Клиенты подключаются к IP‑адресу HAProxy, а запросы распределяются между двумя брокерами. При добавлении нового узла достаточно добавить его в backend.

Практические рекомендации

  • Проверка здоровья: используйте systemctl status mosquitto и mosquitto_ctrl reload_config для безотказной перезагрузки конфигурации.
  • Мониторинг: экспортируйте метрики в Prometheus (плагин mosquitto_exporter) и визуализируйте в Grafana.
  • Резервное копирование: регулярно сохраняйте файл passwd и каталог с сообщениями (если используется persistence).
  • Тестирование: перед масштабированием проведите нагрузочное тестирование (например, k6 или artillery) чтобы убедиться в предсказуемой работе кластера.

Следуя этим шагам, вы получите защищённый и масштабируемый MQTT‑брокер, который будет работать как в домашней лаборатории, так и в продакшн‑среде.

Часто задаваемые вопросы

Как установить Mosquitto на Ubuntu 22.04 и какие команды нужны?

Для установки выполните sudo apt update, затем sudo apt install -y mosquitto mosquitto-clients. После установки сервис запускается автоматически и прослушивает порт 1883, его статус можно проверить командой sudo systemctl status mosquitto. Если требуется, откройте порт в фаерволе: sudo ufw allow 1883/tcp.

Нужно ли открывать порт 1883 в фаерволе для удалённых клиентов и как это сделать?

Да, для доступа из внешних сетей необходимо открыть TCP‑порт 1883. Вufw это делается командой sudo ufw allow 1883/tcp, а в iptables — sudo iptables -A INPUT -p tcp --dport 1883 -j ACCEPT. При использовании TLS лучше открывать порт 8883 и настроить шифрование.

Как настроить авторизацию с помощью пароля и как создать файл пароля?

Создайте файл пароля командой mosquitto_passwd -c /etc/mosquitto/conf.d/password.file username, где будет запрошен пароль. Затем в конфигурационном файле добавьте allow_anonymous false и password_file /etc/mosquitto/conf.d/password.file, перезапустите сервис sudo systemctl restart mosquitto. После этого клиенты будут требовать имя пользователя и пароль.

Как включить persistence (сохранение сообщений) и какие параметры отвечают за это?

Включите persistence, задав persistence true и указав persistence_location /var/lib/mosquitto в файле mosquitto.conf. При необходимости можно установить persistence_client_expiry_delay 0 для немедленного сохранения. Убедитесь, что каталог существует и имеет права записи для пользователя mosquitto.

Как проверить, что брокер работает, и какие логи смотреть?

Проверьте статус сервиса командой sudo systemctl status mosquitto и просмотрите журнал sudo journalctl -u mosquitto -f. Для быстрой проверки подключения используйте mosquitto_sub -t "test/topic" в отдельном терминале. Логи покажут попытки подключения, ошибки аутентификации и другие события.

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

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