Mosquitto服务的安装和使用

本文的主旨在于记录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的安装选项，详细的参数说明如下：

 # 是否支持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，以下是详细的配置参数说明。

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

再加一份说明：

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将会被移除。
这并不是一个标准的配置项，因为对于ＭＱＴＴ协议来说所有的持久订阅应该是永远有效的。
如：　persistent_client_expiration 2m　　persistent_client_expiration 14d　persistent_client_expiration 1y　
ｈ：小时　　ｄ：天　　ｍ：月　　ｙ：年
１９.queue_qos0_messages　是否将ＱｏＳ为０的消息计算到max_queued_messages参数中

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

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



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