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
bashsudo apt update
sudo apt install -y mosquitto mosquitto-clients
После установки сервис запускается автоматически и слушает порт 1883:
bashsudo systemctl status mosquitto
Публикация тестового сообщения
bashmosquitto_pub -t "home/test" -m "hello, world"
Подписка и просмотр полученного сообщения
bashmosquitto_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
confpersistence true persistence_location /var/lib/mosquitto
/etc/mosquitto/conf.d/acl.conf
confacl_file /etc/mosquitto/acl.conf
/etc/mosquitto/acl.conf
confuser anton topic readwrite home/sensors/+/temperature user guest topic readwrite #
Запуск Mosquitto в Docker (для быстрого прототипа)
bashdocker 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:
bashsudo apt update
sudo apt install mosquitto mosquitto-clients
После установки сервис запускается автоматически, но стоит проверить его статус:
bashsudo systemctl status mosquitto
Для Alpine Linux команда выглядит так:
bashsudo apk add mosquitto mosquitto-clients
sudo rc-service mosquitto start
В CentOS 7 и выше предпочтительнее yum или dnf:
bashsudo yum install mosquitto mosquitto-clients # или
sudo dnf install mosquitto mosquitto-clients
sudo systemctl enable mosquitto
sudo systemctl start mosquitto
Проверка работоспособности – подключение клиентом mosquitto_sub к локальному брокеру:
bashmosquitto_sub -t "test/topic"
В другом терминале публикуем сообщение:
bashmosquitto_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
После изменения конфигурации перезапустите сервис:
bashsudo systemctl restart mosquitto
Создание пользователя и пароля:
bashsudo mosquitto_passwd -c /etc/mosquitto/passwd alice
Команда запросит пароль, после чего в файле /etc/mosquitto/passwd появится запись alice:password.
Для добавления других пользователей используйте без -c:
bashsudo mosquitto_passwd /etc/mosquitto/passwd bob
Если требуется TLS‑шифрование, достаточно добавить строки:
conflistener 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.
bashsudo apt update && sudo apt install mosquitto mosquitto-clients
sudo systemctl enable --now mosquitto
После установки файл конфигурации находится в /etc/mosquitto/mosquitto.conf.
Минимальная конфигурация выглядит так:
conflistener 1883 allow_anonymous true # password_file /etc/mosquitto/passwd # раскомментировать при использовании авторизации
Если требуется авторизация, создайте файл паролей:
bashsudo mosquitto_passwd -c /etc/mosquitto/passwd alice
и раскомментируйте строку password_file. После изменения конфигурации перезапустите сервис:
bashsudo systemctl restart mosquitto
Пример работы
Публикация температуры с Raspberry Pi:
bashmosquitto_pub -h localhost -t "home/room1/temperature" -m "23.5"
Подписка с другого устройства (например, с ноутбука):
bashmosquitto_sub -h localhost -t "home/room1/temperature"
Таким образом, в домашней лаборатории можно быстро собрать систему мониторинга без дополнительных сервисов.
Если понадобится более гибкая сеть тем, используйте Docker Compose. Ниже пример docker-compose.yml для Mosquitto:
yamlversion: "3.8"
services:
mosquitto:
image: eclipse-mosquitto:2
ports:
- "1883:1883"
volumes:
- ./mosquitto.conf:/mosquitto/config/mosquitto.conf:ro
Поместите свой mosquitto.conf в каталог рядом с docker-compose.yml и запустите:
bashdocker compose up -d
Интеграция с Kubernetes и Docker Compose
С практической точки зрения удобно использовать Mosquitto в контейнере, особенно когда инфраструктура уже построена на Kubernetes (k3s, Rancher, обычный кластер).
Docker Compose
Для локального теста можно запустить брокер в контейнере, как показано выше. Это удобно, когда нужно быстро проверить работу MQTT‑клиентов без установки Mosquitto на хост.
Kubernetes
В Kubernetes Mosquitto обычно разворачивают через Helm‑чарт или как отдельный Deployment с ConfigMap‑ом конфигурации. Пример манифеста Deployment и Service:
yamlapiVersion: 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):
yamlapiVersion: v1
kind: ConfigMap
metadata:
name: mosquitto-config
data:
mosquitto.conf: |
listener 1883
allow_anonymous true
# password_file /mosquitto/config/passwd # при необходимости
Примените манифесты:
bashkubectl 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
После изменения конфигурации перезапускаем сервис:
bashsystemctl 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" в отдельном терминале. Логи покажут попытки подключения, ошибки аутентификации и другие события.