Eclipse Mosquitto

Mosquitto 是 MQTT 协议 5.0、3.1.1 和 3.1 版本服务器的开源实现。它还包含一个 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 项目信息可在以下位置获取：

• 主 homepage：https://mosquitto.org/
• 查找现有 bug 或提交新 bug：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'

文档

代理、客户端和客户端库 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 可跳过手册页的构建，或者在 Debian/Ubuntu 系统上安装 docbook-xsl。

构建依赖项

• c-ares（基于 Debian 的系统上为 libc-ares-dev）——仅在使用 make WITH_SRV=yes 编译时需要
• cJSON——dynsec 插件、代理控制插件以及客户端 JSON 输出支持所必需。
• libwebsockets（libwebsockets-dev）——使用 make WITH_WEBSOCKETS=lws 启用
• openssl（基于 Debian 的系统上为 libssl-dev）——使用 make WITH_TLS=no 禁用
• pthreads——用于客户端库线程支持。这是支持 mosquitto_loop_start() 和 mosquitto_loop_stop() 函数所必需的。如果编译时不支持 pthread，则不能保证库是线程安全的。
• uthash / utlist——提供了这些头文件的捆绑版本，使用 make WITH_BUNDLED_DEPS=no 可禁用其使用
• xsltproc（基于 Debian 的系统上为 xsltproc 和 docbook-xsl）——仅在从 git 源代码构建时需要——使用 make WITH_DOCS=no 禁用

使用 CMake 构建时，也提供了用于启用/禁用功能的等效选项。

致谢

Mosquitto 由 Roger Light roger@atchoo.org 编写