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找不到的情况。 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　  
ｈ：小时　　ｄ：天　　ｍ：月　　ｙ：年  
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/