just do it

centos-MQTT服务器搭建-mosquitto1.4.14

Mosquitto

mosquitto是一款实现了 MQTT v3.1 协议的开源的消息代理服务软件.
其提供了非常轻量级的消息数据传输协议,采用发布/订阅模式进行工作,可用于物联设备、中间件、APP客户端之间的消息通讯。

mosquitto官网
http://mosquitto.org/
关于mqtt协议可参考
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html

基础准备

Linux内核版本:Centos 6.5_final_64bit
安装基础软件

yum install gcc-c++
yum install cmake
yum install openssl-devel //mosquitto默认支持openssl

编译安装

编译选项

当前的程序目录可直接编译,在编译之前需根据需要做一定的配置,否则会出现 xxx.h找不到的情况。

vim config.mk

config.mk包括了多个选项, 可按需关闭或开启,但一旦开启则需要先安装对应的模块
模块说明

选项
说明
make出错信息
WITH_SRV
启用c-areas库的支持,一个支持异步DNS查找的库
见http://c-ares.haxx.se
missing ares.h
WITH_UUID
启用lib-uuid支持,支持为每个连接的客户端生成唯一的uuid
missing uuid.h
WITH_WEBSOCKETS
启用websocket支持,需安装libwebsockets
对于需要使用websocket协议的应用开启
missing libwebsockets.h

安装c-areas

wget http://c-ares.haxx.se/download/c-ares-1.13.0.tar.gz
tar xvf c-ares-1.13.0.tar.gz
cd c-ares-1.13.0
./configure
make
sudo make install

安装lib-uuid

yum install libuuid-devel

安装libwebsockets

wget https://github.com/warmcat/libwebsockets/archive/v1.3-chrome37-firefox30.tar.gz
tar zxvf v1.3-chrome37-firefox30.tar.gz
cd libwebsockets-1.3-chrome37-firefox30
mkdir build; cd build;
cmake .. -DLIB_SUFFIX=64
make install

//若遇到以上模块无法安装的情况,可将对应模块选项关闭即可,但相应功能也将无法提供;

开始安装mosquitto

wget http://mosquitto.org/files/source/mosquitto-1.4.14.tar.gz
tar -xzvf mosquitto-1.4.14.tar.gz
cd mosquitto-1.4.14
make
make install

至此程序已经安装完毕!
程序文件将默认安装到以下位置

路径 程序文件
/usr/local/sbin mosquiotto server
/etc/mosquitto configuration
/usr/local/bin utility command

修正链接库路径

由于操作系统版本及架构原因,很容易出现安装之后的链接库无法被找到,如启动mosquitto客户端可能出现找不到
libmosquitto.so.1文件,因此需要添加链接库路径

//添加路径
vim /etc/ld.so.conf.d/liblocal.conf
/usr/local/lib64
/usr/local/lib

//刷新
ldconfig

启动与测试

创建用户
mosquitto默认以mosquitto用户启动,可以通过配置文件修改

groupadd gmosquitto
useradd -g gmosquitto mosquitto

程序配置

mv /etc/mosquitto/mosquitto.conf.example /etc/mosquitto/mosquitto.conf

配置项说明

# 服务进程的PID
#pid_file /var/run/mosquitto.pid
 
# 服务进程的系统用户
#user mosquitto
 
# 服务绑定的IP地址
#bind_address
 
# 服务绑定的端口号
#port 1883
 
# 允许的最大连接数,-1表示没有限制
#max_connections -1
 
# 允许匿名用户
#allow_anonymous true

//关于详细配置可参考
http://mosquitto.org/man/mosquitto-conf-5.html

# =================================================================  
# General configuration  
# =================================================================  
  
# 当QoS为1或2的消息已经被发送后,mosquitto在一段时间内仍未接收到客户端的反馈消息,将重新发送消息。 默认为20秒  
#retry_interval 20  
  
# 每隔一段时间将更新$SYS层级话题的状态,其中包含着proker的状态信息。 默认为10秒
#sys_interval 10  
  
# 系统资源的回收时间,0表示尽快处理  
#store_clean_interval 10  
  
# 服务进程的PID  
#pid_file /var/run/mosquitto.pid  
  
# 服务进程的系统用户  
#user mosquitto  
  
# 表示允许多大数量的QoS为1或2消息被同时进行传输处理。这些消息包括正在进行握手的消息和进行重新发送的消息。默认为20个,
如果设置为0,表示不设限制;如果为1,则会确保消息被顺序处理。
#max_inflight_messages 10  
  
# 表示允许多大数量的QoS为1或2消息在队列中进行排队。 默认为100个
#max_queued_messages 100  
 
#设置最大的连接数  -1表示不限制 
#max_connections

# 用于设置客户端长连接的过期时间,默认永不过期  
#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  

启动

mosquitto -c /etc/mosquitto/mosquitto.conf
mosquitto -c /etc/mosquitto/mosquitto.conf -d (守护进程)

成功将启动1883端口监听

客户端测试

新建两个shell端口A/B
A 订阅主题:
mosquitto_sub -t location
B 推送消息:
mosquitto_pub -t location -h localhost -m “new location”

可以在A窗口看到由B推送的消息,此外服务端窗口也可以看到客户端连接和端口的日志

停止mosquitto脚本

#!/bin/sh
sudo kill $(ps aux |awk '/mosquitto/ {print $2}')

FAQ

启动mosquitto报错

error while loading shared libraries: libwebsockets.so.4.0.0: cannot open shared object file: No such file or directory
或者
error while loading shared libraries: libmosquitto.so.1: cannot open shared object file: No such file or directory
解决方法
找不到链接库,通过locate或find命令找到libwebsockets.so.4.0.0,将其目录添加至ldconfg配置中:

vim /etc/ld.so.conf.d/liblocal.conf
/usr/local/lib64
/usr/local/lib
ldconfig
//执行ln -s 添加软连接的方式也可行

编译找不到openssl/ssl.h

解决方法

yum install openssl-devel

编译报错

mosquitto.c:871: error: ‘struct mosquitto’ has no member named ‘achan’
找不到areas.h
解决方法
安装 c-areas模块(见上文)或将config.mk中WITH_SRV选项关闭

make test 提示不支持协议

Address family not supported by protocol
一般是指所访问的地址类型不被支持,比如IPV6,忽略该错误即可

————————————————
说明

1.retry_interval   
当QoS为1或2的消息已经被发送后,mosquitto在一段时间内仍未接收到客户端的反馈消息,将重新发送消息。 默认为20秒  
2.sys_interval   
每隔一段时间将更新$SYS层级话题的状态,其中包含着proker的状态信息。 默认为10秒  
3.store_clean_interval  
表示间隔多长时间将不再被使用的消息销毁掉。该值越小,使用的内存就会越小但会需要更多的处理时间。 如果设置为0,表示不被  
使用的消息将会及时销毁。 默认为10秒  
4. pid_file  默认为/var/run/mosquitto.pid  
5.user   设置mosquitto启动用户  
6.max_inflight_messages   
表示允许多大数量的QoS为1或2消息被同时进行传输处理。这些消息包括正在进行握手的消息和进行重新发送的消息。默认为20个,  
如果设置为0,表示不设限制;如果为1,则会确保消息被顺序处理。  
7.max_queued_messages  
表示允许多大数量的QoS为1或2消息在队列中进行排队。 默认为100个  
8.max_connections  
设置最大的连接数  -1表示不限制  
9.autosave_interval  
表示当开启持久化设置时,间隔多少时间mosquitto会把内存中的消息保存到磁盘中。默认为30分钟,当设置为0时,只有mosquitto  
关闭的时候才会写的磁盘中。  
10.persistence  
设置为true时,所有的连接,订阅和消息数据都会被保存到磁盘的mosquitto.db文件中。当mosquitto重启的时候,它会从mosquitto.db文件中  
重新加载数据。  
11.persistence_location  默认为/var/lib/mosquitto/  
12.log_dest    
设置日志的输出目的地 可以是:stdout stderr syslog topic   如果输出到某个文件的话可以这样设置log_dest file /var/log/mosquitto.log  要赋予对mosquitto.log文件的读写权限。  
13.log_type  日志类型:debug, error, warning, notice, information, subscribe, unsubscribe, websockets, none, all  
14.log_timestamp   是否记录日志时间  
15.clientid_prefixes  
设置只有clientId以某个前缀开始的客户端才允许连接到mosquitto broker.  
16.allow_duplicate_messages  
如果一个客户端订阅了多个topic时,设置是否允许接收重复的消息。比如订阅了foo/# 和 foo/+/baz。  
17.autosave_on_changes   
If true, mosquitto will count the number of subscription changes, retained messages received and queued messages and if the total exceeds autosave_interval then the in-memory database will be saved to disk. If false, mosquitto will save the in-memory database to disk by treating autosave_interval as a time in seconds  
18.persistent_client_expiration  
持久订阅的过期设置。 对于将clean session设置为false的持久订阅客户端,如果在一定的时间段里面没有重新连接mosquitto将会被移除。  
这并不是一个标准的配置项,因为对于MQQT协议来说所有的持久订阅应该是永远有效的。  
如: persistent_client_expiration 2m  persistent_client_expiration 14d persistent_client_expiration 1y   
h:小时  d:天  m:月  y:年  
19.queue_qos0_messages 是否将QOS为0的消息计算到max_queued_messages参数中  

————————————————
mqtt源文件
http://mosquitto.org/files/source/
mqtt调试工具
http://www.jensd.de/apps/mqttfx/
https://repo.eclipse.org/content/repositories/paho-releases/org/eclipse/paho/org.eclipse.paho.ui.app/1.1.1/

点赞