linux下的mosquitto服务安装及使用（避坑指南）

Mosquitto是一个开源的MQTT消息代理服务器。MQTT是一个轻量级的、基于发布/订阅模式的消息传输协议。 mosquitto的安装使用比较简单，可以方便的来进行一些测试。

mosquitto介绍

Mosquitto的特点：

1. 轻量级：Mosquitto是一个轻量级的MQTT代理服务器，它的设计目标是提供高效、快速和可靠的消息传递，适用于各种规模的应用。

2. 容易部署：Mosquitto的安装和部署非常简单，可以在多个平台上运行，包括Linux、Windows、macOS等。

3. 安全性：Mosquitto支持基于TLS/SSL的加密通信，可以保护消息的安全性和机密性。同时，它还支持基于用户名和密码的身份验证，以及访问控制列表（ACL）来限制访问权限。

4. 可扩展性：Mosquitto支持多个客户端连接和多个主题的订阅，可以满足大规模应用的需求。

Ubuntu下的安装

方式一：源码安装

下载mosquitto

官网：https://mosquitto.org/

源码地址：https://mosquitto.org/files/source/mosquitto-2.0.9.tar.gz

优点是可以任意指定需要的版本。但就是稍麻烦些，需要自己编译使用。若需要添加进服务，则也需要自己来配置。

cd /home/test
wget --no-check-certificate https://mosquitto.org/files/source/https://mosquitto.org/files/source/mosquitto-2.0.9.tar.gz

// 编译、安装
cd mosquitto-2.0.9
make
sudo make install

方式二：直接安装

优点是简单方便，只是版本不能由你自由选，不过版本应该也不会太旧，Ubuntu18下默认应该是2.0以上的版本。

sudo apt-get install mosquitto

以上默认只安装了mosquitto的服务，不带测试客户端工具mosquitto_sub和mosquitto_pub。如果需要，则可以安装：

sudo apt-get install mosquitto-clients

服务管理

service --status-all

它将显示 Ubuntu 上的完整服务列表。如过系统是 Ubuntu 18.04、Ubuntu 20.04 和 Ubuntu 22.04 版本或以上版本，建议使用Systemd systemctl 实用程序启动、停止或重新启动服务。较早的版本则可以使用 service 命令启动/停止/重启服务。

service 是一种较旧的服务管理命令，用于与 System V init 系统兼容的 Linux 发行版。它可以启动、停止、重启或查询系统服务的状态。使用 sudo service 命令时，你需要指定服务的名称，例如 sudo service apache2 stop 将停止 Apache 服务器。 sudo systemctl 是一个较新的服务管理命令，用于与 Systemd 系统兼容的 Linux 发行版，如最新版本的 Ubuntu、Fedora 和 CentOS。它提供了更多的功能和灵活性。

还有一种方式，可以使用 /etc/init.d 目录中的初始化脚本启动、停止或重新启动服务。该目录实际上包含用于不同服务的各种脚本。如使用：

/etc/init.d/mosquitto  start

自从 Ubuntu 切换到 Systemd 后，不推荐使用初始化脚本。

systemctl 启动 mosquitto 服务：

sudo systemctl stop mosquitto

停止mosquitto 服务：

sudo systemctl start mosquitto

要重新启动 mosquitto 服务：

sudo systemctl restart mosquitto

检查 mosquitto 服务状态：

sudo systemctl status mosquitto

避坑指南

安装成功并启动后，发现外网并不能成功访问到，防火墙也放行了1883端口，但是仍然无法访问到1883端口，为什么会连不上Linux上的mosquitto服务器？

原因是Ubuntu上的mosquitto服务默认是 local only mode，当使用sudo service mosquitto start,再使用sudo service mosquitto status是查看不到当前服务器是运行在哪种模式，当使用mosquitto -v这个命令时可以看到下图现象：

在这里插入图片描述

还有个更简单的方法，排查此类问题。就是查看linux系统下开放了哪些端口，端口的使用情况。

使用netstat命令，如：

netstat -ntpl

127.0.0.1 是IPv4环回地址，也称为本地回环地址。它指向本地主机的网络接口，用于在本地主机上访问自己的服务和应用程序。这类地址开头的服务只能本机访问。0.0.0.0 是通配符地址，表示任意主机。当服务绑定到 0.0.0.0 时，它将监听所有可用的网络接口上的传入连接，意味着可以从任意地址访问该服务。在Linux下， ::: 和 ::1 是IPv6环回地址的两种表示形式，用于代表本地主机。

解决办法

直接修改/etc/mosquitto目录下的mosquitto.conf文件，开放端口和允许访问的地址即可。

# 设置允许匿名连接,如果禁止匿名连接，则需要配置账号、密码连接
allow_anonymous true

# mqtt 协议配置，分为ipv4和ipv6两种，当前可以只配置启用一种
listener 1883 0.0.0.0
socket_domain ipv4
protocol mqtt

测试使用

订阅消息

# 无密码
mosquitto_sub -t test1
# 有密码
mosquitto_sub -u yang -P abc123 -t test1

发布消息

# 无密码
mosquitto_pub -t test1 -m "发布的内容"
# 有密码
mosquitto_pub -u yang -P abc123 -t test1 -m "发布的内容"

mqtt客户端下载

在windows下，常用的mqtt客户端工具为MQTTX。

工具下载地址：

MQTTX 下载

https://github.com/emqx/MQTTX/releases/latest

密码配置

默认安装的mosquitto未启用密码，如果正式使用最好是启用密码验证。

配置mosquitto账号密码：

# 使用-c 参数会导致清空密码文件，重新插入用户
mosquitto_passwd -c pwfile.example 用户名

# 不使用-c 表示追加用户，不影响旧用户
mosquitto_passwd  pwfile.example 用户名

经过以上配置，在linux下默认会在/etc/mosquitto/目录下生成密码的配置文件 pwfile.example。也可以指定要生成的pwfile文件路径，使用以下形式：

mosquitto_passwd /etc/mosquitto/pwfile.example 用户名

修改/etc/mosquitto目录下的mosquitto.conf文件，启用密码。

# 设置是否允许匿名连接，如果禁止匿名连接，则需要配置账号、密码连接
allow_anonymous true

# 密码文件路径，禁止匿名连接配置，允许匿名则不用配置
password_file /etc/mosquitto/pwfile.example

# mqtt 协议配置，分为ipv4和ipv6两种，当前可以只配置启用一种
listener 1883 0.0.0.0
socket_domain ipv4
protocol mqtt

# ipv6
listener 1883 ::
socket_domain ipv6
protocol mqtt

# webscoket 协议配置，如果有的话需要配置，分为ipv4和ipv6两种，当前可以只配置启用一种
listener 1884 0.0.0.0
protocol websockets
socket_domain ipv4

listener 1884 ::
protocol websockets
socket_domain ipv4

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

最后，重启mosquitto服务，配置文件的修改才能生效。