【MQTT】mosquitto 的 “下载、交叉编译、使用” 详细教程，手把手搭建一个MQTT Broker

😁博客主页😁：🚀https://blog.csdn.net/wkd_007🚀
🤑博客内容🤑：🍭嵌入式开发、Linux、C语言、C++、数据结构、音视频🍭
⏰发布时间⏰：2024-05-11 00:26:45

本文未经允许，不得转发！！！

---

🎄一、概述

本文介绍如何使用 mosquitto 搭建一个 MQTT Broker。

Eclipse Mosquitto是一个开源（EPL/EDL许可）消息代理，它实现了MQTT协议版本 5.0、3.1.1和3.1。Mosquito 是轻量级的，适用于从低功耗单板计算机到全服务器的所有设备。

MQTT协议提供了一种使用发布/订阅模型执行消息传递的轻量级方法。这使得它适用于物联网消息传递，例如使用低功率传感器或移动设备，如手机、嵌入式计算机或微控制器。

Mosquitto项目还提供了一个用于实现MQTT客户端的C库，以及非常流行的Mosquitto_pub和Mosquitto_sub命令行MQTT客户端。

Mosquito是Eclipse基金会的一部分，是iot.Eclipse.org项目。开发由Cedalo推动。

关于 的更多内容，可以参考其官网：https://mosquitto.org/

---

🎄二、mosquitto 的下载

mosquitto 的下载地址：https://mosquitto.org/download/

如果不想下载最新版本的，也可以在其GitHub路径去下载：https://github.com/eclipse/mosquitto/tags

本文是直接在官网下载的，下载的版本是：mosquitto-2.0.18.tar.gz。

---

🎄三、mosquitto 的交叉编译

在编译 mosquitto-2.0.18.tar.gz 之前需要先编译其依赖库：openssl库 和 cJSON库。

✨3.1 openssl 的下载、交叉编译

本文下载的是 openssl-OpenSSL_1_1_1g.tar.gz，
下载地址：https://codeload.github.com/openssl/openssl/tar.gz/refs/tags/OpenSSL_1_1_1g
为什么使用这么旧的版本，因为这个我之前编译过，而且使用没问题。

编译步骤：

• 1、解压缩

  tar zxf openssl-OpenSSL_1_1_1g.tar.gz
  

• 2、进入目录，并配置输出目录和交叉编译器, (linux-generic32表示是32位操作系统,个别文章加了这个选项就不用去掉 -m64，我这里行不通)

  cd openssl-OpenSSL_1_1_1g/
  ./config no-asm shared no-async --prefix=`pwd`/ssl_result  --cross-compile-prefix=aarch64-mix210-linux-
  

• 3、执行下面命令，删除Makefile文件的 -m64，

  sed -i 's/-m64//' Makefile
  

  执行后，可以避免出现这个编译错误：aarch64-mix210-linux-gcc: error: unrecognized command line option '-m64'

• 4、编译、安装

  make && make install
  

成功编译后，在openssl-OpenSSL_1_1_1g/目录会生成一个ssl_result目录，可以看到里面生成的库：

---

✨3.2 cJSON 的下载、交叉编译

cJSON库是C语言编写的，用来解析JSON信息的库，本文使用的是 cJSON-1.7.17.tar.gz。
下载地址：https://codeload.github.com/DaveGamble/cJSON/tar.gz/refs/tags/v1.7.17
cJSON 的编译很简单，可以使用下面shell脚本编译，将下面shell脚本保存成cJSON_install.sh，与下载的cJSON-1.7.17.tar.gz放在同一目录，直接执行cJSON_install.sh编译即可：

#! /bin/sh

export CJSON_VER=cJSON-1.7.17
CROSSS_COMPILE_TOOL=aarch64-mix210-linux-

# 1.解压缩
rm ${CJSON_VER} -rf
tar zxf ${CJSON_VER}.tar.gz

# 2.编译
cd ${CJSON_VER}

# 2.1 修改安装目录路径
sed -i '/PREFIX ?= /a PREFIX ?= $(PWD)\/..\/${CJSON_VER}_result' Makefile
sed -i '/PREFIX ?= \/usr\/local/d' Makefile

make CC=${CROSSS_COMPILE_TOOL}gcc
make install
cd ..

编译过程图：

---

✨3.3 mosquitto 交叉编译

编译步骤：

• 1、解压缩、进入源码目录：

  tar zxf mosquitto-2.0.18.tar.gz
  cd mosquitto-2.0.18
  

• 2、修改config.mk，指定依赖库的头文件路径、库路径，并且指定安装目。
  在 config.mk 的 146 行，在ARCH:=$(shell uname -p)语句下面添加下面语句：

  # 指定ssl库、cJSON库的头文件和库文件
  CFLAGS += -I/home/samba/01_libCompile/013_mqtt/MQTT_Broker/result_dir/ssl_result/include -I/home/samba/01_libCompile/013_mqtt/MQTT_Broker/result_dir/cJSON-1.7.17_result/include
  LDFLAGS+= -L/home/samba/01_libCompile/013_mqtt/MQTT_Broker/result_dir/ssl_result/lib -L/home/samba/01_libCompile/013_mqtt/MQTT_Broker/result_dir/cJSON1.7.17_result/lib -lssl -lcrypto -dl
  
  # 指定安装目录
  DESTDIR=/home/samba/01_libCompile/013_mqtt/MQTT_Broker/result_dir/mosquitto-2.0.18_result
  

  没有添加上面语句，或者添加不正确的话，会报编译错误：../config.h:61:12: fatal error: openssl/opensslconf.h: No such file or directory
  注意：
  1、指定的路径必须使用绝对路径，因为这个config.mk可能被其他层级的Makefile包括，不使用绝对路径会出错。
  2、-lssl -lcrypto -dl这几个选项也要加，不然链接时可能会报错。
  3、DESTDIR目录一定要指定，不然make install的时候可能会安装到根目录去。

• 3、编译、安装

  make CC=aarch64-mix210-linux-gcc CXX=aarch64-mix210-linux-g++
  make install
  

编译完成后，可以看到如下的几个文件：

---

🎄四、mosquitto 的使用教程

✨4.1 mosquitto 部署到嵌入式开发板

我这个是交叉编译，是要部署到嵌入式开发板的，如果读者是在Ubuntu等Linux发行版系统部署的话，也可以参考，主要就是让依赖的动态库可以被找到。

将前面已编译 openssl、cJSON、mosquitto 目录放到一块，我这里是放在 mosquitto_result_dir 目录，如下：

然后将整个目录复制到嵌入式开发板。

---

✨4.2 运行 mosquitto (MQTT Broker)

在编译结果目录mosquitto-2.0.18_result/usr/local/sbin 中存在 mosquitto 的可执行文件，mosquitto 就是我们要部署的 MQTT Broker(MQTT 代理)，将它运行之后，我们就可以通过MQTT客户端进行发布/订阅了。

• 首先，设置 LD_LIBRARY_PATH 环境变量，添加依赖库的路径，执行如下语句(路径根据你自己的设置)：

  export LD_LIBRARY_PATH=/nfsroot/mosquitto_result_dir/ssl_result/lib:$LD_LIBRARY_PATH
  

• 然后，添加 mosquitto 配置文件，在当前目录新建文件mosquitto.conf，内容如下：

  # 设置 Mosquitto 服务器监听所有网络接口（通过 0.0.0.0 指定）上的 1883 端口.
  listener 1883 0.0.0.0
  
  # 设置运行 Mosquitto 服务时使用的用户为 root。
  # 这通常不是一个安全的做法，因为通常推荐使用一个权限较低的专用用户账户来运行服务以减少潜在的安全风险。
  user root
  
  # 允许匿名用户连接到 MQTT 服务器。这意味着客户端无需提供用户名和密码即可连接并发布、订阅消息。
  allow_anonymous true
  
  # 指定 Mosquitto 服务运行时生成的进程 ID 文件位置。
  #pid_file /var/run/mosquitto.pid
  
  # 开启持久化模式，意味着在服务器重启后，一些会话状态和保留消息等信息会被保存下来
  #persistence true
  
  # 设置持久化数据存储的位置，在本例中是 /tmp 目录。
  #persistence_location /tmp
  
  # 指定日志输出方式为写入文件，并设定日志文件的路径为 /tmp/mosquitto.log。
  #log_dest file /tmp/mosquitto.log
  
  # 指定包含其他配置文件的目录，当 Mosquitto 启动时，会加载此目录下的所有 .conf 结尾的文件作为附加配置。
  #include_dir /mnt/mosquitto/etc/mosquitto/conf.d/
  
  #max_inflight_messages 1024
  #max_queued_messages 5120
  #message_size_limit 2048000
  #set_tcp_nodelay true
  

• 最后，运行 mosquitto，-c 是指定 mosquitto 配置文件mosquitto.conf 的路径(根据自己的设置)：

  ./mosquitto -c /nfsroot/mosquitto_result_dir/mosquitto-2.0.18_result/usr/local/sbin/mosquitto.conf 
  

  

---

✨4.3 运行 mosquitto_sub 订阅消息

mosquitto_sub 是一个MQTT客户端，实现了订阅消息的功能，使用步骤：

• 1、在嵌入式开发板重新打开一个命令行窗口，设置 LD_LIBRARY_PATH 环境变量，具体路径看自己的目录：

  export LD_LIBRARY_PATH=/nfsroot/mosquitto_result_dir/mosquitto-2.0.18_result/usr/local/lib/:/nfsroot/mosquitto_result_dir/cJSON-1.7.17_result/lib/:$LD_LIBRARY_PATH
  

• 2、运行 mosquitto_sub 订阅消息，命令如下，-v表示打印发布的消息，-h 指定运行MQTT Broker的主机ip，-t 指定要订阅的主题(Topic)：

  ./mosquitto_sub -v -h 192.168.3.227 -t /server/fromArm
  

---

✨4.4 运行 mosquitto_pub 发布消息

mosquitto_pub 也是一个MQTT客户端，实现了发布消息的功能，使用步骤：

• 1、在嵌入式开发板重新打开一个命令行窗口，设置 LD_LIBRARY_PATH 环境变量，具体路径看自己的目录：

  export LD_LIBRARY_PATH=/nfsroot/mosquitto_result_dir/mosquitto-2.0.18_result/usr/local/lib/:/nfsroot/mosquitto_result_dir/cJSON-1.7.17_result/lib/:$LD_LIBRARY_PATH
  

• 2、运行 mosquitto_pub 发布消息，命令如下，-h 指定运行MQTT Broker的主机ip，-t 指定要发布的主题(Topic)，-m 指定要发送的消息，

  ./mosquitto_pub -h 192.168.3.227 -t /server/fromArm -m {"data":"hello world!"}
  

  也可以使用-f选项指定文件，将文件内容发布：

  ./mosquitto_pub -h 192.168.3.227 -t /server/fromArm -f 
  

下面是订阅、发布消息的过程：

---

🎄五、总结

本文介绍了 MQTT Broker 开源库 mosquitto 的下载、交叉编译、使用教程，如果想了解 mosquitto ，一定会有帮助。

如果文章有帮助的话，点赞👍、收藏⭐，支持一波，谢谢 😁😁😁

参考：
https://blog.csdn.net/weixin_45459266/article/details/136804799