Eclipse Mosquitto: открытый MQTT-брокер с утилитами и клиентской библиотекой

Eclipse Mosquitto: открытый MQTT-брокер с утилитами и клиентской библиотекой

Источник, README репозитория Eclipse Mosquitto на GitHub, а не анонс релиза: ни новой версии, ни изменений там не описано. Это описание давно существующего проекта, которое обсуждают на Hacker News.

Mosquitto, открытая реализация сервера (брокера) протокола MQTT версий 5.0, 3.1.1 и 3.1. Кроме брокера в проект входят клиентская библиотека на C и C++, утилиты mosquitto_pub, mosquitto_rr и mosquitto_sub для публикации и подписки, а также приложения mosquitto_ctrl, mosquitto_signal и mosquitto_passwd, которые помогают администрировать брокер. В README даны ссылки на стандарты MQTT v3.1.1 и v5.0, домашнюю страницу проекта, трекер ошибок и публичный тестовый сервер test.mosquitto.org.

Быстрый старт устроен просто. Если брокер установлен из бинарного пакета, он, как сказано в README, должен был запуститься автоматически; иначе его запускают командой mosquitto с минимальной конфигурацией. Затем в одном терминале подписываются на тему командой mosquitto_sub -t 'test/topic' -v, а в другом публикуют сообщение командой mosquitto_pub -t 'test/topic' -m 'hello world'. В таком режиме брокер допускает анонимный доступ без аутентификации, но только с локального компьютера, поэтому годится лишь для первичной проверки.

Чтобы к брокеру подключались клиенты с других компьютеров, нужен файл конфигурации. Из бинарного пакета он, скорее всего, уже лежит где-то вроде /etc/mosquitto/mosquitto.conf; при сборке из исходников конфигурацию пишут сами и запускают mosquitto -c /path/to/mosquitto.conf. В конфигурации задают listener (точку приёма подключений) и выбирают способ аутентификации; README прямо не советует держать брокер с анонимным доступом, когда он доступен публично. Для этого упоминаются доступные методы аутентификации и плагин dynamic security. Документация к брокеру, клиентам и API библиотеки собрана в man-страницах на mosquitto.org/man, а подробное описание API, на mosquitto.org/api.

Сборка. Конечным пользователям рекомендуют брать архив со страницы загрузки. На Windows и Mac собирают через cmake, на остальных платформах достаточно make. При сборке из git-репозитория документация заранее не построена: для пропуска man-страниц есть цель make binary, либо нужно установить docbook-xsl (на Debian/Ubuntu).

Зависимости. Обязательна только cJSON. Остальные необязательны: c-ares (включается WITH_SRV=yes), libedit для интерактивной оболочки mosquitto_ctrl (отключается WITH_EDITLINE=no), libmicrohttpd для HTTP API брокера (WITH_HTTP_API=no), openssl (WITH_TLS=no), sqlite3 для сохранения данных брокера (WITH_SQLITE=no), встроенные заголовки uthash и utlist (WITH_BUNDLED_DEPS=no), xsltproc нужен только при сборке из git (WITH_DOCS=no). Отдельно: pthreads нужны для потоков в клиентской библиотеке, без них не гарантируется потокобезопасность, и функции mosquitto_loop_start() и mosquitto_loop_stop() не поддерживаются. Аналогичные опции есть и в сборке через CMake, где можно также включать и отключать сборку отдельных плагинов.

Установить Mosquitto можно и через менеджер зависимостей vcpkg (клонировать репозиторий vcpkg, выполнить bootstrap, integrate install и vcpkg install mosquitto). Порт в vcpkg, по словам README, поддерживают сотрудники Microsoft и участники сообщества. Автор Mosquitto, Roger Light; README добавляет, что другие люди из сообщества внесли существенный вклад как кодом, так и иной помощью.

Ключевые факты

  • Mosquitto, открытая реализация сервера протокола MQTT версий 5.0, 3.1.1 и 3.1; источник, README репозитория, а не анонс нового релиза.
  • В комплекте клиентская библиотека на C и C++, утилиты mosquitto_pub, mosquitto_rr, mosquitto_sub и административные mosquitto_ctrl, mosquitto_signal, mosquitto_passwd.
  • Брокер без конфигурации пускает анонимных клиентов только с локального компьютера; для подключений с других машин нужен файл конфигурации, а анонимный доступ в публичной сети README не советует.
  • Сборка: cmake на Windows и Mac, make на остальных платформах; обязательна только зависимость cJSON, остальное отключается флагами вроде WITH_TLS=no и WITH_SQLITE=no.
  • Установка возможна из бинарных пакетов, из исходников или через vcpkg; автор, Roger Light, к проекту присоединились участники сообщества.

Почему это важно

Новости здесь нет: это README давно существующего проекта, который снова обсуждают на Hacker News. Ценность материала в том, что на одной странице показано, из чего состоит Mosquitto: брокер MQTT трёх версий протокола (5.0, 3.1.1 и 3.1), клиентская библиотека и утилиты для проверки и администрирования. Тем, кто выбирает сервер MQTT, это быстрый обзор состава и порога входа.

Кому это важно

Разработчикам и администраторам, которым нужен собственный брокер MQTT или клиентская библиотека на C/C++. Также тем, кто собирает проект из исходников и хочет понять, какие зависимости обязательны, а какие можно отключить, и тем, кто хочет быстро проверить обмен сообщениями через консольные утилиты или публичный тестовый сервер test.mosquitto.org.

Как это применить

Самый короткий путь из README: установить бинарный пакет (список платформ на mosquitto.org/download), при необходимости запустить командой mosquitto, подписаться через mosquitto_sub -t 'test/topic' -v и отправить сообщение через mosquitto_pub -t 'test/topic' -m 'hello world'. Для подключений с других компьютеров создайте файл конфигурации, задайте listener и способ аутентификации, затем запустите mosquitto -c /path/to/mosquitto.conf. Для сборки из исходников используйте cmake (Windows, Mac) или make (остальные платформы); альтернатива, vcpkg install mosquitto.

Можно ли доверять

Источник, README самого проекта, поэтому он описывает устройство и порядок работы, но не оценивает качество. В нём нет данных о производительности, числе пользователей или сравнении с другими брокерами, нет версии релиза и списка изменений, а в видимом тексте не названа лицензия. Утверждения о составе, флагах сборки и поведении без конфигурации, слова самих авторов проекта.

Риски и подводные камни

Главное предупреждение из README: брокер с анонимным доступом не стоит выставлять в публичную сеть; запуск без конфигурации годится только для начальной проверки. Если клиентскую библиотеку собрать без pthreads, потокобезопасность не гарантируется, а mosquitto_loop_start() и mosquitto_loop_stop() работать не будут. При сборке из git-репозитория документация не построена заранее: нужен docbook-xsl или make binary. Версию порта в vcpkg README предлагает проверять самому: если она устарела, нужно создать issue или pull request в репозитории vcpkg.