• Eclipse Mosquitto 是实现MQTT协议版本5.0、3.1.1和3.1的开源消息代理（经EPL / EDL许可）。
• mosquitto 是一个开源的轻量级的C实现，适合在从低功耗单板计算机到完整服务器的所有设备上使用。
• mosquitto包括服务端和客户端。
• 官网：http://mosquitto.org/

一、安装 mosquitto

# 安装 mosquitto broker
sudo apt-get install mosquitto
# 安装 mosquitto client
sudo apt-get install mosquitto-clients

二、启动 mosquitto 服务

# 开启 mosquitto 服务
service mosquitto start# 查看 mosquitto 是否启动成功
ps -ef | grep mosquitto

三、订阅主题

打开一个终端，执行以下命令：

mosquitto_sub -h localhost -t "mqtt" -v
或者
mosquitto_sub -h "192.168.0.103" -t "mqtt" -v

-h 是指定要连接的 MQTT 服务器，localhost 指本机，也可以直接使用本机的 IP。
-t 订阅主题。主题为 mqtt。
-v 打印更多的调试信息。

四、发布主题：

打开另一个终端，执行以下命令：

mosquitto_pub -h localhost -t "mqtt" -m "Hello World"

-h 是指定要连接的 MQTT 服务器，localhost 指本机，也可以直接使用本机的 IP。
-t 订阅主题。主题为 mqtt。
-m 指定消息内容，这里发送的是 Hello。

五、现象展示：

在打开的第一个终端就会收到消息mqtt Hello World。
broker

client

六、附：命令使用方法

订阅主题：

mosquitto_sub用法：

mosquitto_sub [-c] [-d] [-h hostname] [-i client_id] [-I client id prefix] [-k keepalive time] [-p port number] [-q message QoS] [--quiet] [-v] [ -u username [-Ppassword] ] [ --will-topic topic [--will-payload payload] [--will-qos qos] [--will-retain] ] -t message topic

项	描述
-c, –disable-clean-session	禁止’clean session’选项，即如果客户端断开连接，这个订阅仍然保留来接收随后到的QoS为1和2的消息，当改客户端重新连接之后，它将接收到已排在队列中的消息。建议使用此选项时，客户端id选项设为–id
-d, –debug	开启debug选项
-h, –host	说明所连接到的域名，默认是localhost
-i, –id	客户端的ID号，如果没有指定，默认是mosquitto_pub_加上客户端的进程id，不能和–id_prefix同时使用。
-I, –id-prefix	指定客户端ID的前缀，与客户端的进程ID连接组成客户端的ID，不能喝–id同时使用。
-k, –keepalive	给代理发送PING命令（目的在于告知代理该客户端连接保持且在正常工作）的间隔时间，默认是60s。
-p, –port	说明客户端连接到的端口，默认是1883。
-P, –pw	指定密码用于代理认证，使用此选项时必须有有效的用户名。
-q, –qos	指定消息的服务质量，可以为0,1,2，默认是0。
–quiet	如果指定该选项，则不会有任何错误被打印，当然，这排除了无效的用户输入所引起的错误消息。
-t, –topic	指定订阅的消息主题，允许同时订阅到多个主题。
-u, –username	指定用户名用于代理认证。
-v, –verbose	冗长地打印收到的消息。若指定该选项，打印消息时前面会打印主题名——“主题 消息内容”，否则，只打印消息内容。
–will-payload	如果指定该选项，则万一客户端意外和代理服务器断开，则该消息将被保留在服务端并发送出去，该选项必须同时用–will-topic指定主题。
–will-qos	指定Will的服务质量，默认是0.必须和选项 –will-topic同时使用。
–will-retain	如果指定该选项，则万一客户端意外断开，已被发送的消息将被当做retained消息。必须和选项 –will-topic同时使用。
–will-topic	指定客户端意外断开时，Will消息发送到的主题。

发布主题：

mosquitto_pub 用法：

mosquitto_pub [-d] [-h hostname] [-i client_id] [-I client id prefix] [-p port number] [-q message QoS] [--quiet] [-r] { -f file | -l | -m message | -n | -s} [-u username [-P password] ] [ --will-topic topic [--will-payload payload] [--will-qos qos] [--will-retain] ] -t message-topic

项	描述
-d, –debug	开启debug选项
-f, –file	把一个文件的内容做为消息的内容发送。经测试，支持txt文件，不支持doc等其他形式文件。
-h, –host	说明所连接到的域名，默认是localhost
-i, –id	客户端的ID号，如果没有指定，默认是mosquitto_pub_加上客户端的进程id，不能和–id_prefix同时使用。
-I, –id-prefix	指定客户端ID的前缀，与客户端的进程ID连接组成客户端的ID，不能和–id同时使用。
-l, –stdin-line	从总段读取输入发送消息，一行为一条消息，空白行不会被发送。
-m, –message	从命令行发送一条消息，-m后面跟发送的消息内容。
-n, –null-message	发送一条空消息。
-p, –port	连接的端口号，默认是1883。
-P, –pw	指定密码用于代理认证，使用此选项时必须有有效的用户名。
-q, –qos	指定消息的服务质量，可以为0,1,2，默认是0。
–quiet	如果指定该选项，则不会有任何错误被打印，当然，这排除了无效的用户输入所引起的错误消息。
-r, –retain	如果指定该选项，该条消息将被保留做为最后一条收到的消息。下一个订阅消息者将能至少收到该条消息。
-s, –stdin-file	从标准输入接收传输的消息内容，所有输入做为一条消息发送。
-t, –topic	指定消息所发布到哪个主题。
-u, –username	指定用户名用于代理认证。
–will-payload	如果指定该选项，则万一客户端意外和代理服务器断开，则该消息将被保留在服务端并发送出去，该选项必须同时用–will-topic指定主题。
–will-qos	指定Will的服务质量，默认是0.必须和选项 –will-topic同时使用。
–will-retain	如果指定该选项，则万一客户端意外断开，已被发送的消息将被当做retained消息。必须和选项 –will-topic同时使用。
–will-topic	指定客户端意外断开时，Will消息发送到的主题。

参考：MQTT–mosquitto使用详解、MQTT–入门