mosquitto简介和使用

1、简介

一款实现了 MQTT v3.1协议的开源消息代理软件，提供轻量级的，支持可发布/可订阅的的消息推送模式，使设备对设备之间的短消息通信变得简单，比如现在应用广泛的低功耗传感器，手机、嵌入式设备，微型控制器等移动设备。

2、程序说明

1）mosquitto：代理器主程序

2）mosquitto.conf：配置文件

3）mosquitto_passwd：用户密码管理工具

4）mosquitto_pub：用于发布消息的命令行客户端

5）mosquitto_sub：用于订阅消息的命令行客户端

6）mqtt：MQTT的后台进程

7）libmosquitto：客户端编译的库文件

3、安装

同时安装服务端mosquitto和客户端mosquitto-clients

sudo apt-get install mosquitto
sudo apt-get install mosquitto-clients

4、服务器端

4.1、ubuntu管理指令

通过ubuntu管理程序命令的方式，查看mosquitto状态，启动服务器程序，关闭服务器程序等。

1）查看状态

sudo service mosquitto status

2）启动服务器

sudo service mosquitto start

3）关闭服务器

sudo service mosquitto stop

4.2、mosquitto命令

通过mosquitto程序指令启动服务器，通过杀死进程方式，关闭服务器。

1）命令格式：

mosquitto [-c config file] [ -d | --daemon ] [-p port number] [-v]

2）参数说明：

-c 启动mosquitto可以调整的参数，配置文件
-d 表示MQTT mosquitto将在后台运行。
-p 代表当前的mosquitto服务实例启动以后，其监听端口号
-v 代码调试模式（verbose）

3）启动服务器：

mosquitto -c /etc/mosquitto/mosquitto.conf -d

4）关闭服务器：

# 查看mosquitto服务进程ID
ps -aux | grep mosquitto
 
# 杀掉服务进程
# PID 为上一步查找的ID
kill -9 PID

# 杀掉后，如果进程自动启动，
# 修改mosquitto.conf文件后缀为其他名称即可。

4.3、服务器配置

1）配置用户名和密码

添加新的用户名和密码文件 

sudo mosquitto_passwd -c /etc/mosquitto/passwd username

参数说明：

-c 生成密码文件，不加-c 代表已有文件，只增加用户，第二次配置不需要输入-c

# passwd 指定密码文件
# username 指定配置的用户名
# 回车后输入两次密码完成配置

2）修改配置文件

开始修改etc/mosquitto/mosquitto.conf配置文件，增加三行（含义是：1、监听的端口；2、不允许匿名登陆；3、登陆账号信息的文件）

listener 1883
allow_anonymous false
password_file /etc/mosquitto/passwd

5、客户端

5.1、mosquitto_sub

1）订阅消息（本地服务器）：

mosquitto_sub -h localhost -t "test" -i "client1"

2）参数说明： 

-c 设定‘clean session’为无效状态，这样一直保持订阅状态，即便是已经失去连接，如果再次连接仍旧能够接收的断开期间发送的消息。
-d 打印debug信息
-h 指定要连接的域名 默认为localhost
-i 指定clientId
-I 指定clientId前缀
-k keepalive 每隔一段时间，发PING消息通知broker，仍处于连接状态。 默认为60秒。
-q 指定希望接收到QoS为什么的消息 默认QoS为0
-R 不显示陈旧的消息
-t 订阅topic
-v 打印消息
-u 指定broker访问用户
-P 指定broker访问密码（大写）
--will-payload 指定一个消息，该消息当客户端与broker意外断开连接时发出。该参数需要与--will-topic一起使用
--will-qos Will的QoS值。该参数需要与--will-topic一起使用
--will-retain 指定Will消息被当做一个retain消息（即消息被广播后，该消息被保留起来）。该参数需要与--will-topic一起使用
--will-topic 用户发送Will消息的topic

5.2、mosquitto_pub 

1）发布消息（本地服务器）：

mosquitto_pub -h localhost -t "test" -i "client2" -m "Hello World!"

2）参数说明：

-d 打印debug信息
-f 将指定文件的内容作为发送消息的内容
-h 指定要连接的域名 默认为localhost
-i 指定要给哪个clientId的用户发送消息
-I 指定给哪个clientId前缀的用户发送消息
-m 消息内容
-n 发送一个空（null）消息
-p 连接端口号（小写）
-q 指定QoS的值（0,1,2）
-t 指定topic
-u 指定broker访问用户
-P 指定broker访问密码（大写）
-V 指定MQTT协议版本
--will-payload 指定一个消息，该消息当客户端与broker意外断开连接时发出。该参数需要与--will-topic一起使用
--will-qos Will的QoS值。该参数需要与--will-topic一起使用
--will-retain 指定Will消息被当做一个retain消息（即消息被广播后，该消息被保留起来）。该参数需要与--will-topic一起使用
--will-topic 用户发送Will消息的topic