如果您安装了二进制包，则代理应该已经自动启动。如果没有，可以从基本配置开始：

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处理用户名/密码的实用程序，以及对代理可用的配置文件选项的描述。

可以在https://mosquitto.org/api/找到详细的客户端库 API 文档

从源头构建

要从源代码构建，推荐给最终用户的途径是从https://mosquitto.org/download/下载档案。

在 Windows 和 Mac 上，用于cmake构建。在其他平台上，只需运行make 即可构建。对于 Windows，另请参阅README-windows.md。

如果您从 git 存储库构建，那么文档将不会被构建。用于make binary跳过构建手册页，或 docbook-xsl在 Debian/Ubuntu 系统上安装。

建立依赖关系

• c-ares（基于 Debian 的系统上的 libc-ares-dev）——仅当使用make WITH_SRV=yes
• cJSON - 用于客户端 JSON 输出支持。make WITH_CJSON=no使用CMake 检测到自动禁用。
• libwebsockets (libwebsockets-dev) - 启用make WITH_WEBSOCKETS=yes
• 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 构建时，可以使用用于启用/禁用功能的等效选项。

链接

有关 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/ 。