MQTT的学习之Mosquitto简要教程（安装&使用）

原创已于 2023-03-01 22:25:31 修改 · 8.6k 阅读

27 ·

CC 4.0 BY-SA版权

文章标签：

#学习 #linux #网络

于 2017-07-30 22:27:02 首次发布

消息中间件专栏收录该内容

3 篇文章

订阅专栏

本文详细介绍Mosquitto MQTT代理服务器的安装与配置过程，包括源码安装、依赖包安装及参数配置等，并解决了安装过程中可能遇到的问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Mosquitto是一个实现了MQTT3.1协议的代理服务器，由MQTT协议创始人之一的Andy Stanford-Clark开发，它为我们提供了非常棒的轻量级数据交换的解决方案。本文的主旨在于记录Mosquitto服务的安装和使用，以备日后查阅。

获取&安装

在Linux系统上安装Mosquitto，本人建议大家使用源码安装模式，最新的源码可从 Index of /files/source/ 地址中获取。解压之后，我们可以在源码目录里面找到主要的配置文件config.mk，其中包含了所有Mosquitto的安装选项，详细的参数说明如下：

# 是否支持tcpd/libwrap功能.
#WITH_WRAP:=yes

# 是否开启SSL/TLS支持
#WITH_TLS:=yes

# 是否开启TLS/PSK支持
#WITH_TLS_PSK:=yes

# Comment out to disable client client threading support.
#WITH_THREADING:=yes

# 是否使用严格的协议版本（老版本兼容会有点问题）
#WITH_STRICT_PROTOCOL:=yes

# 是否开启桥接模式
#WITH_BRIDGE:=yes

# 是否开启持久化功能
#WITH_PERSISTENCE:=yes

# 是否监控运行状态
#WITH_MEMORY_TRACKING:=yes

这里需要注意的是，默认情况下Mosquitto的安装需要OpenSSL的支持；如果不需要SSL，则需要关闭config.mk里面的某些与SSL功能有关的选项（WITH_TLS、WITH_TLS_PSK）。接着，就是运行make install进行安装，完成之后会在系统命令行里发现mosquitto、mosquitto_passwd、mosquitto_pub和mosquitto_sub四个工具（截图如下），分别用于启动代理、管理密码、发布消息和订阅消息。

实战项目中，没有安全监测是不可能的，因此我模拟真实环境，直接去安装了OpenSSL。

编译与安装 OpenSSL

prefix 是安装目录，openssldir 是配置文件目录，另外建议安装两次，shared 作用是生成动态连接库。linux版的OpenSSL下载地址为：https://www.openssl.org/source/，我所使用的是openssl-1.1.0f.tar.gz版本，并且将mosquitto-1.4.14.tar.gz提前也上传至该目录下并解压，后面会使用。

1、上传下载好的压缩包，并解压：

2、在/home/tool下创建文件夹openssl作为安装路径，在openssl下创建files文件夹；然后，cd到openssl-1.1.0f文件夹下：

3、执行命令

1、  ./config --prefix=/home/tool/openssl --openssldir=/home/tool/openssl/files

2、  make && make install

3、  ./config shared --prefix=/home/tool/openssl --openssldir=/home/tool/openssl/files

4、 make clean　　

5、 make && make  install

至此，openssl安装完毕，我以为现在可以安装mosquitto了，结果在安装的过程中会报各种各样的错误，因为mosquitto还需要依赖很多其他的报，具体错误我就不一一说出来了，因为解决这些问题我就花了差不多2个小时，下面直接把安装的命令列出来，大家对这一一执行就行了。

安装其他依赖包：

yum install gcc gcc-c++ libstdc++-devel 

yum install openssl-devel -y

yum install c-ares-devel -y

yum install uuid-devel -y

yum install libuuid-devel -y

因为我是安装好以后才开始整理文档的，有可能会丢一些依赖包，敬请谅解！

安装mosquitto：

1、切换到/home/tool/sourceDir/mosquitto-1.4.14目录下

2、make && make install

3、安装完以后切换到 /etc 目录下查看：

4、切换到 /etc/mosquitto目录下，执行

5、mosquitto参数详细说明：

# =================================================================
# General configuration
# =================================================================

# 客户端心跳的间隔时间
#retry_interval 20

# 系统状态的刷新时间
#sys_interval 10

# 系统资源的回收时间，0表示尽快处理
#store_clean_interval 10

# 服务进程的PID
#pid_file /var/run/mosquitto.pid

# 服务进程的系统用户
#user mosquitto

# 客户端心跳消息的最大并发数
#max_inflight_messages 10

# 客户端心跳消息缓存队列
#max_queued_messages 100

# 用于设置客户端长连接的过期时间，默认永不过期
#persistent_client_expiration

# =================================================================
# Default listener
# =================================================================

# 服务绑定的IP地址
#bind_address

# 服务绑定的端口号
#port 1883

# 允许的最大连接数，-1表示没有限制
#max_connections -1

# cafile：CA证书文件
# capath：CA证书目录
# certfile：PEM证书文件
# keyfile：PEM密钥文件
#cafile
#capath
#certfile
#keyfile

# 必须提供证书以保证数据安全性
#require_certificate false

# 若require_certificate值为true，use_identity_as_username也必须为true
#use_identity_as_username false

# 启用PSK（Pre-shared-key）支持
#psk_hint

# SSL/TSL加密算法，可以使用“openssl ciphers”命令获取
# as the output of that command.
#ciphers

# =================================================================
# Persistence
# =================================================================

# 消息自动保存的间隔时间
#autosave_interval 1800

# 消息自动保存功能的开关
#autosave_on_changes false

# 持久化功能的开关
persistence true

# 持久化DB文件
#persistence_file mosquitto.db

# 持久化DB文件目录
#persistence_location /var/lib/mosquitto/

# =================================================================
# Logging
# =================================================================

# 4种日志模式：stdout、stderr、syslog、topic
# none 则表示不记日志，此配置可以提升些许性能
log_dest none

# 选择日志的级别（可设置多项）
#log_type error
#log_type warning
#log_type notice
#log_type information

# 是否记录客户端连接信息
#connection_messages true

# 是否记录日志时间
#log_timestamp true

# =================================================================
# Security
# =================================================================

# 客户端ID的前缀限制，可用于保证安全性
#clientid_prefixes

# 允许匿名用户
#allow_anonymous true

# 用户/密码文件，默认格式：username:password
#password_file

# PSK格式密码文件，默认格式：identity:key
#psk_file

# pattern write sensor/%u/data
# ACL权限配置，常用语法如下：
# 用户限制：user <username>
# 话题限制：topic [read|write] <topic>
# 正则限制：pattern write sensor/%u/data
#acl_file

# =================================================================
# Bridges
# =================================================================

# 允许服务之间使用“桥接”模式（可用于分布式部署）
#connection <name>
#address <host>[:<port>]
#topic <topic> [[[out | in | both] qos-level] local-prefix remote-prefix]

# 设置桥接的客户端ID
#clientid

# 桥接断开时，是否清除远程服务器中的消息
#cleansession false

# 是否发布桥接的状态信息
#notifications true

# 设置桥接模式下，消息将会发布到的话题地址
# $SYS/broker/connection/<clientid>/state
#notification_topic

# 设置桥接的keepalive数值
#keepalive_interval 60

# 桥接模式，目前有三种：automatic、lazy、once
#start_type automatic

# 桥接模式automatic的超时时间
#restart_timeout 30

# 桥接模式lazy的超时时间
#idle_timeout 60

# 桥接客户端的用户名
#username

# 桥接客户端的密码
#password

# bridge_cafile：桥接客户端的CA证书文件
# bridge_capath：桥接客户端的CA证书目录
# bridge_certfile：桥接客户端的PEM证书文件
# bridge_keyfile：桥接客户端的PEM密钥文件
#bridge_cafile
#bridge_capath
#bridge_certfile
#bridge_keyfile

5、启动mosquitto服务：

mosquitto -c /etc/mosquitto/mosquitto.conf

6、查看端口：

7、至此，mosquitto安装，启动完毕！

补充问题：

1、在启动过程中报错：

 Error: Invalid user 'mosquitto'.

解决方法：

2、重启Mosquitto

笔者在网上找了很多资料都没有提起怎样重启服务器，并且在官网上也没有相应命令提示。

所以我们使用Liunx终止进程命令，强行退出。

先kill掉，再重启：

[root@localhost ~]# ps -A | grep mosquitto
21674 ?        00:02:38 mosquitto
[root@localhost ~]# kill -9 21674

编译过程中问题：

1. ssh.h找不到。我之前安装了openssl，为什么还会报这个错误呢，因为我安装好了以后并没有配置环境变量下面的命令是安装开发环境，执行此命令，上面的openssl就可以不安装了

yum install openssl-devel

2.ares.h找不到

yum install c-ares-devel

3.#include <uuid/uuid.h> 找不到文件解决方法：

yum install e2fsprogs-devel
yum install uuid-devel
yum install libuuid-devel

调测问题：

1、报错./mosquitto_sub: error while loading shared libraries: libmosquitto.so.1: cannot open shared object file: No such file or directory

解决：执行以下命令：

sudo ln -s /usr/local/lib/libmosquitto.so.1 /usr/lib/libmosquitto.so.1

ldconfig

调测步骤：

1、先开启一个客户端，模拟broker

2、再开启一个客户端，模拟订阅

3、最后开启一个客户端，模拟发布

4、订阅界面可以实时收到发布消息