[移动] Mosquitto简要教程（安装/使用/测试）

本文转自 http://blog.csdn.net/shagoo/article/details/7910598

上篇文章《Android主流推送方案分析（MQTT/XMPP/GCM）》中，我们给大家介绍了，如何在移动领域使用灵巧的消息传输协议MQTT来完成消息推送，最后也提到了开源项目Mosquitto。实际上，Mosquitto是一个实现了MQTT3.1协议的代理服务器，由MQTT协议创始人之一的Andy
Stanford-Clark开发，它为我们提供了非常棒的轻量级数据交换的解决方案。本文的主旨在于记录Mosquitto服务的安装和使用，以备日后查阅。

1、获取&安装

Mosquitto提供了Windows、Linux以及qnx系统的版本，安装文件可从http://mosquitto.org/files/binary/地址中获取（建议使用最新的1.1.x版本）。Windows系统下的安装过程非常简单，我们甚至可以把Mosquitto直接安装成为系统服务；但是，在实际应用中，我们更倾向于使用Linux系统的服务器，接下来我们就将重点介绍Linux版Mosquitto的安装方法。

在Linux系统上安装Mosquitto，本人建议大家使用源码安装模式，最新的源码可从http://mosquitto.org/files/source/地址中获取。解压之后，我们可以在源码目录里面找到主要的配置文件config.mk，其中包含了所有Mosquitto的安装选项，详细的参数说明如下：

[html] view
plaincopy

# 是否支持tcpd/libwrap功能.  

#WITH_WRAP:=yes  

  

# 是否开启SSL/TLS支持  

#WITH_TLS:=yes  

  

# 是否开启TLS/PSK支持  

#WITH_TLS_PSK:=yes  

  

# Comment out to disable client client threading support.  

#WITH_THREADING:=yes  

  

# 是否使用严格的协议版本（老版本兼容会有点问题）  

#WITH_STRICT_PROTOCOL:=yes  

  

# 是否开启桥接模式  

#WITH_BRIDGE:=yes  

  

# 是否开启持久化功能  

#WITH_PERSISTENCE:=yes  

  

# 是否监控运行状态  

#WITH_MEMORY_TRACKING:=yes  

这里需要注意的是，默认情况下Mosquitto的安装需要OpenSSL的支持；如果不需要SSL，则需要关闭config.mk里面的某些与SSL功能有关的选项（WITH_TLS、WITH_TLS_PSK）。接着，就是运行make install进行安装，完成之后会在系统命令行里发现mosquitto、mosquitto_passwd、mosquitto_pub和mosquitto_sub四个工具（截图如下），分别用于启动代理、管理密码、发布消息和订阅消息。



2、配置&运行

安装完成之后，所有配置文件会被放置于/etc/mosquitto/目录下，其中最重要的就是Mosquitto的配置文件，即mosquitto.conf，以下是详细的配置参数说明。

[html] view
plaincopy

# =================================================================  

# 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 <username>  

# 话题限制：topic [read|write] <topic>  

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

#acl_file  

  

# =================================================================  

# Bridges  

# =================================================================  

  

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

#connection <name>  

#address <host>[:<port>]  

#topic <topic> [[[out | in | both] qos-level] local-prefix remote-prefix]  

  

# 设置桥接的客户端ID  

#clientid  

  

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

#cleansession false  

  

# 是否发布桥接的状态信息  

#notifications true  

  

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

# $SYS/broker/connection/<clientid>/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服务很简单，直接运行命令行“mosquitto -c /etc/mosquitto/mosquitto.conf -d”即可开启服务。接下来，就让我们尽情体验Mosquitto的强大功能吧！当然，有了Mosquitto，我们就可以安心地抛弃“简陋”的rsmb了，有兴趣的话，大家还可以尝试把Mosquitto服务运用到上一篇的Android推送服务中。

另外，Mosquitto是个异步IO框架，经测试可以轻松处理20000个以上的客户端连接。当然，实际的最大承载量还和业务的复杂度还有比较大的关系。下图是本人在一台普通Linux机器上进行的压力测试结果，大家可以参考。



友情提醒：测试的时候不要忘记调整系统的最大连接数和栈大小，比如：Linux上可用ulimit -n20000 -s512命令设置你需要的系统参数。

make install 时出现错误

[root@localhost mosquitto-1.3]# make WITH_TLS=no  

set -e; for d in lib client src; do make -C ${d}; done  

make[1]: Entering directory `/qyl/mosquitto-1.3/lib'  

cc -Wall -ggdb -O2  -I. -I.. -I../lib -fPIC -DWITH_THREADING -DWITH_SRV -c mosquitto.c -o mosquitto.o  

In file included from mosquitto.c:46:  

mosquitto_internal.h:51:20: error: ares.h: No such file or directory  

In file included from mosquitto.c:46:  

mosquitto_internal.h:238: error: expected specifier-qualifier-list before ?.res_channel?  

mosquitto.c: In function ?.osquitto_loop?.  

mosquitto.c:834: error: ?.truct mosquitto?.has no member named ?.chan?  

mosquitto.c:837: warning: implicit declaration of function ?.res_fds?  

mosquitto.c:837: error: ?.truct mosquitto?.has no member named ?.chan?  

mosquitto.c:917: error: ?.truct mosquitto?.has no member named ?.chan?  

mosquitto.c:918: warning: implicit declaration of function ?.res_process?  

mosquitto.c:918: error: ?.truct mosquitto?.has no member named ?.chan?  

make[1]: *** [mosquitto.o] Error 1  

make[1]: Leaving directory `/qyl/mosquitto-1.3/lib'  

make: *** [mosquitto] Error 2 

解决方法：（参考http://blog.csdn.net/Netown_Ethereal/article/details/22653125）

在config.mk配置文件里面把srv support 关掉。如下图：

[plain] view
plaincopy





# Build with SRV lookup support.  

WITH_SRV:=no  

再执行make，就可以顺利安装了。