mosquitto

Затмение Комар

Mosquitto — это реализация сервера с открытым исходным кодом для версий 5.0, 3.1.1 и 3.1 протокола MQTT. Он также включает клиентскую библиотеку C и C++, а также утилиты mosquitto_pub и mosquitto_sub для публикации и подписки.

Ссылки

Дополнительные сведения о MQTT см. по следующим ссылкам:

• Страница сообщества: http://mqtt.org/
• Стандарт MQTT v3.1.1: https://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html.
• Стандарт MQTT v5.0: https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html.

Информацию о проекте Mosquitto можно получить по следующим адресам:

• Основная домашняя страница: https://mosquitto.org/.
• Найдите существующие ошибки или отправьте новую: https://github.com/eclipse/mosquitto/issues.
• Репозиторий исходного кода: https://github.com/eclipse/mosquitto.

Существует также общедоступный тестовый сервер, доступный по адресу https://test.mosquitto.org/.

Установка

См. https://mosquitto.org/download/ для получения подробной информации об установке двоичных файлов для различных платформ.

Быстрый старт

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

 mosquitto

Затем используйте mosquitto_sub , чтобы подписаться на тему:

 mosquitto_sub -t 'test/topic' -v

И опубликовать сообщение:

 mosquitto_pub -t 'test/topic' -m 'hello world'

Обратите внимание, что запуск брокера таким образом обеспечивает анонимный/неаутентифицированный доступ, но только с локального компьютера, поэтому он действительно полезен только для первоначального тестирования.

Если вы хотите, чтобы клиенты с другого компьютера подключались, вам потребуется предоставить файл конфигурации. Если вы установили из двоичного пакета, у вас, вероятно, уже есть файл конфигурации где-то вроде /etc/mosquitto/mosquitto.conf . Если вы скомпилировали исходный код, вы можете написать свой файл конфигурации, а затем запустить его как mosquitto -c /path/to/mosquitto.conf .

Чтобы запустить файл конфигурации, вы определяете прослушиватель и вам нужно будет подумать о том, какая аутентификация вам требуется. Не рекомендуется использовать ваш брокер с анонимным доступом, когда он общедоступен.

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

Документация

Документацию по брокеру, клиентам и API клиентской библиотеки можно найти на страницах руководства, доступных в Интернете по адресу https://mosquitto.org/man/. Также есть страницы с введением в возможности MQTT, утилитой mosquitto_passwd для работы с именами пользователей и паролями и описанием параметров файла конфигурации, доступных для брокера.

Подробную документацию по API клиентской библиотеки можно найти по адресу https://mosquitto.org/api/.

Сборка из исходников

Для сборки из исходного кода конечным пользователям рекомендуется загрузить архив с https://mosquitto.org/download/.

В Windows и Mac для сборки используйте cmake . На других платформах просто запустите make для сборки. Для Windows см. также README-windows.md .

Если вы выполняете сборку из репозитория git, документация еще не будет собрана. Используйте make binary , чтобы пропустить создание страниц руководства, или установите docbook-xsl в системах Debian/Ubuntu.

Создание зависимостей

• c-ares (libc-ares-dev в системах на базе Debian) — только при компиляции с make WITH_SRV=yes
• cJSON — для поддержки вывода клиентом JSON. Отключите с помощью команды make WITH_CJSON=no обнаружено с помощью CMake.
• libwebsockets (libwebsockets-dev) — включить с помощью make WITH_WEBSOCKETS=yes
• openssl (libssl-dev в системах на базе Debian) — отключите с помощью команды make WITH_TLS=no
• pthreads — для поддержки потоков клиентской библиотеки. Это необходимо для поддержки функций mosquitto_loop_start() и mosquitto_loop_stop() . Если библиотека скомпилирована без поддержки pthread, потокобезопасность библиотеки не гарантируется.
• uthash / utlist — предоставляются связанные версии этих заголовков, отключите их использование с помощью make WITH_BUNDLED_DEPS=no
• xsltproc (xsltproc и docbook-xsl в системах на базе Debian) — необходим только при сборке из исходных кодов git — отключите с помощью команды make WITH_DOCS=no

Эквивалентные параметры включения/отключения функций доступны при использовании сборки CMake.

Кредиты

«Москитто» написал Роджер Лайт [email protected].