树莓派+Ubuntu 20.04安装Mosquitto MQTT服务

原创已于 2024-08-24 21:24:38 修改 · 2.4k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#ubuntu #linux #树莓派 CM4 #MQTT

于 2021-12-08 10:33:52 首次发布

树莓派同时被 3 个专栏收录

42 篇文章

订阅专栏

Linux

35 篇文章

订阅专栏

MQTT

14 篇文章

订阅专栏

本文介绍如何在树莓派上安装Mosquitto MQTT服务，并通过源码编译安装实现C语言开发支持。涵盖安装步骤、本地及远程测试、配置文件设定及开机启动流程。

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

陈拓 2021/11/07-2021/11/08

1. 概述

本文我们下载最新的mosquitto 2.x源码进行编译安装。并且用源码编译安装后系统中就有了用C语言进行MQTT开发相关的头文件和库文件。

首先登录树莓派。见《在树莓派计算模块CM4上安装Ubuntu Server 20.04》https://blog.youkuaiyun.com/chentuo2000/article/details/121419415

查看操作系统版本：

2. 下载源码

2.1 官方网址

https://mosquitto.org/download/

2.2 下载源码

右击mosquitto-2.0.14.tar.gz，复制链接地址：

https://mosquitto.org/files/source/mosquitto-2.0.14.tar.gz

mkdir ~/ct

cd ~/ct

下载

wget https://mosquitto.org/files/source/mosquitto-2.0.14.tar.gz --no-check-certificate

3. 解压

tar -zxvf mosquitto-2.0.14.tar.gz

4. 编译

安装编译工具

安装全家桶build-essential（C/C++ toolchain包括make、gcc等）

sudo apt install build-essential

cd mosquitto-2.0.14

编译

make

出错，找不到openssl/opensslconf.h

安装opensslconf.h

sudo apt-get install libssl-dev

再编译

make

出错，找不到cjson/cJSON.h

安装libcjson libcjson-dev

sudo apt-get install libcjson1 libcjson-dev

再编译

make

成功。

安装

sudo make install

重新启动树莓派

sudo reboot

查看帮助

mosquitto -h

mosquitto是一个MQTT v5.0/v3.1.1/v3.1代理。

用法：

Usage: mosquitto [-c config_file] [-d] [-h] [-p port]

参数说明：

-c : 指定代理配置文件

-d : 代理启动之后进入后台运行

-h : 显示帮助

-p : 以指定的端口启动代理监听。不建议与-c选项一起使用

-v : 详细模式 - 启用所有日志类型，并在终端打印调试信息。此参数覆盖在配置文件中给出的任何日志记录选项。

更多信息见https://mosquitto.org/

5. 本地测试

下面开三个终端窗口进行测试。

5.1 启动mosquitto服务

启动mosquitto服务

先打开一个终端窗口，输入mosquitto -v

使用默认配置，以本地模式启动，只能从运行在本机上的客户端连接。如果要从远程访问，需要创建一个配置文件，我们将在后面创建这个配置文件并测试远程连接。

5.2 打开第二个终端窗口，订阅主题

订阅主题

mosquitto_sub -d -v -t test_topic

出错，原因是libmosquitto.so.1安装在/usr/local/lib/目录下，默认的库文件在目录/usr/lib/下，创建一个软链接：

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

重新订阅主题

mosquitto_sub -d -v -t test_topic

订阅主题test_topic，等待接收消息。

参数说明查看帮助：mosquitto_sub --help

-d : enable debug messages.

-v : print published messages verbosely.

-t : mqtt topic to subscribe to. May be repeated multiple times.

5.3 打开第三个终端窗口，发布内容

发布内容

mosquitto_pub -t test_topic -m "hello!"

发布主题为test_topic的消息Hello!

参数说明查看帮助：mosquitto_pub --help

-m : message payload to send.

订阅窗口显示接收到的消息

6. 设置配置文件

使用默认配置，如需修改服务器的配置信息需要修改：

上面的测试使用默认配置，只能从运行在本机上的客户端连接。如果要从远程访问，需要创建一个配置文件。

重新启动树莓派

sudo reboot

或者杀掉在后台运行的进程mosquitto服务和订阅进程：

复制mosquitto.conf

sudo cp /etc/mosquitto/mosquitto.conf.example /etc/mosquitto/mosquitto.conf

编辑/etc/mosquitto/mosquitto.conf

sudo nano /etc/mosquitto/mosquitto.conf

我们修改下面几处，去掉注释符号，修改默认值（注意和1.x旧版本不完全相同）：

user mosquitto
max_queued_messages 1000
max_packet_size 1024
allow_zero_length_clientid true
listener 1883
autosave_interval 1800
autosave_on_changes false
persistence false
persistence_file mosquitto.db
allow_anonymous false
Password_file /etc/mosquitto/passwd.conf