Centos7-mqtt消息中间件mosquitto的安装和配置

MQTT（MQ Telemetry Transport），消息队列遥测传输协议，轻量级的发布/订阅协议， 适用于一些条件比较苛刻的环境，进行低带宽、不可靠或间歇性的通信。目前已经是物联网消息通信事实上的标准协议了。值得一提的是mqtt提供三种不同质量的消息服务：

“至多一次”：消息发布完全依赖底层 TCP/IP 网络。会发生消息丢失或重复。这一级别可用于如下情况，环境传感器数据，丢失一次读记录无所谓，因为不久后还会有第二次发送。
“至少一次”：确保消息到达，但消息重复可能会发生。
“只有一次”：确保消息到达一次。这一级别可用于如下情况，在计费系统中，消息重复或丢失会导致不正确的结果。
一直没时间搭建这个平台，前段时间到MQTT官网发现了一些很好的资源。
software · mqtt/mqtt.github.io Wiki

https://github.com/mqtt/mqtt.github.io/wiki/software?id=software

Software
·Brokers/servers

·Client libraries

·Tools and applications

·Plugins to other software

·Devices aka MQTT-enabled products that are “Things”

资源里既有基于MQTT（但不仅限于）开源消息代理中间件（Brokers/servers），又有测试客户端，看了几个代理中间件，也百度了一下，应用比较多的有ActiveMQ、Apollo、Mosquitto等。先选择一个没那么复杂的Mosquitto来尝尝鲜。
Mosquitto是一款实现了消息推送协议 MQTT v3.1 的开源消息代理软件，提供轻量级的，支持可发布/可订阅的的消息推送模式，使设备对设备之间的短消息通信变得简单，比如现在应用广泛的低功耗传感器，手机、嵌入式计算机、微型控制器等移动设备。
安装：(参考官网 http://mosquitto.org/download/)
服务器操作系统为CentOS7.0，使用最简单的yum安装

1.先加入yum源：

在/etc/yum.repos.d/目录中新建一个mosquitto.repo文件，里面写入：

[home_oojah_mqtt]
name=mqtt (CentOS_CentOS-7)
type=rpm-md
baseurl=http://download.opensuse.org/repositories/home:/oojah:/mqtt/CentOS_CentOS-7/
gpgcheck=1
gpgkey=http://download.opensuse.org/repositories/home:/oojah:/mqtt/CentOS_CentOS-7/repodata/repomd.xml.key
enabled=1
熟悉命令的可以直接下载到服务器中重命名http://download.opensuse.org/repositories/home:/oojah:/mqtt/CentOS_CentOS-7/home:oojah:mqtt.repo

不熟悉命令操作的（比如说我）就直接新建文件ftp上传吧。

2.开始安装

yum search all mosquitto
yum install mosquitto mosquitto-clients

第一步先查找一下所有关于mosquitto的模块。

显现的模块后面功能简介，这里我先安装了mosquitto mosquitto-clients两个模块用于后面的测试，以后要用上什么模块我再安装。

Mosquitto Server启动、停止
/etc/init.d/mosquitto start
【mosquitto -c /etc/mosquitto/mosquitto.conf–输出过程信息】
/etc/init.d/mosquitto stop

3.配置

安装完成之后，所有配置文件会被放置于/etc/mosquitto/目录下，

其中最重要的就是Mosquitto的配置文件，即mosquitto.conf

Place your local configuration in /etc/mosquitto/conf.d/

pid_file /var/run/mosquitto.pid
persistence true
persistence_location /var/lib/mosquitto/
#log_dest file /var/log/mosquitto/mosquitto.log
include_dir /etc/mosquitto/conf.d

自定义的配置文件是放在/etc/mosquitto/conf.d/文件夹中，文件以.conf为扩展名。详细的配置参数参考mosquitto.conf.example

=================================================================

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

话题限制：topic [read|write]

正则限制：pattern write sensor/%u/data

#acl_file

=================================================================

Bridges

=================================================================

允许服务之间使用“桥接”模式（可用于分布式部署）

#connection
#address [:]
#topic [[[out | in | both] qos-level] local-prefix remote-prefix]

设置桥接的客户端ID

#clientid

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

#cleansession false

是否发布桥接的状态信息

#notifications true

设置桥接模式下，消息将会发布到的话题地址

$SYS/broker/connection//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

自己的配置可以放到以下目录中

include_dir /etc/mosquitto/conf.d

4.启动服务，两种方式
mosquitto -c /etc/mosquitto/mosquitto.conf -d
sudo /etc/init.d/mosquitto start

演示部分：
前面已经开启了服务，如果没有请参考前面步骤。在本例中，发布者、代理和订阅者均为localhsot，但是在实际的情况下三种并不是同一个设备，在mosquitto中可通过-h(–host)设置主机名称(hostname)。为了实现这个简单的测试案例，需要在linux中打开三个控制台，分别代表代理服务器、发布者和订阅者。

一、开启另一个终端窗口，运行订阅程序mosquitto_sub:

注意：

消息推送的发布和订阅要有主题，选项[-t] 主题，即：mosquitto -t 主题

如需指定用户名称则加选项[-i] 用户名，即：mosquitto_sub -t 主题 -i 订阅端

mosquitto_sub -t mqtt

二、开启另一个终端窗口，运行发布程序mosquitto_pub:

指定消息推送的主题，发布端用户名和消息：

mosquitto_pub -t 主题 -i 发布端 -h 主机 -m 你好

*注意：如果消息中间有空格则消息要用引号括起来。

mosquitto_pub -h localhost -t mqtt -m “hello world.”

这时候前面那个订阅窗口就可以收到”hello world”的消息了。

另外Mosquitto官方也提供了C++和Python写的测试代码,这里测试一下Python客户端paho-mqtt 1.1
Python的安装环境就不讲了。最新的paho-mqtt1.1使用下面的命令安装

pip install paho-mqtt
接下来写一个测试的Python文件,具体的接口文档建议参考官方文档。
import paho.mqtt.client as mqtt

The callback for when the client receives a CONNACK response from the server.

def on_connect(client, userdata, flags, rc):
print("Connected with result code "+str(rc))

Subscribing in on_connect() means that if we lose the connection and

reconnect then subscriptions will be renewed.

client.subscribe(“mqtt”)
#订阅，第一个参数是订阅的主题

The callback for when a PUBLISH message is received from the server.

def on_message(client, userdata, msg):
print(msg.topic+" "+str(msg.payload))
client = mqtt.Client()
client.on_connect = on_connect
client.on_message = on_message
client.connect(“XXXXXXXXXX”, 1883, 60)
#第一个参数为主机名，及Mosquitto所在服务器，第二个参数是端口

Blocking call that processes network traffic, dispatches callbacks and

handles reconnecting.

Other loop*() functions are available that give a threaded interface and a

manual interface.

client.loop_forever()
执行这个Python文件

接下来我在服务器控制台发布一个消息

回头看订阅方

已经收到了推送的消息。

参考：mqtt消息中间件mosquitto的安装和配置 - 斜风细雨