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的安装和配置 - 斜风细雨