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

本文转自 http://blog.youkuaiyun.com/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 plain copy

1. # 是否支持tcpd/libwrap功能.  
2. #WITH_WRAP:=yes  
3.   
4. # 是否开启SSL/TLS支持  
5. #WITH_TLS:=yes  
6.   
7. # 是否开启TLS/PSK支持  
8. #WITH_TLS_PSK:=yes  
9.   
10. # Comment out to disable client client threading support.  
11. #WITH_THREADING:=yes  
12.   
13. # 是否使用严格的协议版本（老版本兼容会有点问题）  
14. #WITH_STRICT_PROTOCOL:=yes  
15.   
16. # 是否开启桥接模式  
17. #WITH_BRIDGE:=yes  
18.   
19. # 是否开启持久化功能  
20. #WITH_PERSISTENCE:=yes  
21.   
22. # 是否监控运行状态  
23. #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 plain copy

1. # =================================================================  
2. # General configuration  
3. # =================================================================  
4.   
5. # 客户端心跳的间隔时间  
6. #retry_interval 20  
7.   
8. # 系统状态的刷新时间  
9. #sys_interval 10  
10.   
11. # 系统资源的回收时间，0表示尽快处理  
12. #store_clean_interval 10  
13.   
14. # 服务进程的PID  
15. #pid_file /var/run/mosquitto.pid  
16.   
17. # 服务进程的系统用户  
18. #user mosquitto  
19.   
20. # 客户端心跳消息的最大并发数  
21. #max_inflight_messages 10  
22.   
23. # 客户端心跳消息缓存队列  
24. #max_queued_messages 100  
25.   
26. # 用于设置客户端长连接的过期时间，默认永不过期  
27. #persistent_client_expiration  
28.   
29. # =================================================================  
30. # Default listener  
31. # =================================================================  
32.   
33. # 服务绑定的IP地址  
34. #bind_address  
35.   
36. # 服务绑定的端口号  
37. #port 1883  
38.   
39. # 允许的最大连接数，-1表示没有限制  
40. #max_connections -1  
41.   
42. # cafile：CA证书文件  
43. # capath：CA证书目录  
44. # certfile：PEM证书文件  
45. # keyfile：PEM密钥文件  
46. #cafile  
47. #capath  
48. #certfile  
49. #keyfile  
50.   
51. # 必须提供证书以保证数据安全性  
52. #require_certificate false  
53.   
54. # 若require_certificate值为true，use_identity_as_username也必须为true  
55. #use_identity_as_username false  
56.   
57. # 启用PSK（Pre-shared-key）支持  
58. #psk_hint  
59.   
60. # SSL/TSL加密算法，可以使用“openssl ciphers”命令获取  
61. # as the output of that command.  
62. #ciphers  
63.   
64. # =================================================================  
65. # Persistence  
66. # =================================================================  
67.   
68. # 消息自动保存的间隔时间  
69. #autosave_interval 1800  
70.   
71. # 消息自动保存功能的开关  
72. #autosave_on_changes false  
73.   
74. # 持久化功能的开关  
75. persistence true  
76.   
77. # 持久化DB文件  
78. #persistence_file mosquitto.db  
79.   
80. # 持久化DB文件目录  
81. #persistence_location /var/lib/mosquitto/  
82.   
83. # =================================================================  
84. # Logging  
85. # =================================================================  
86.   
87. # 4种日志模式：stdout、stderr、syslog、topic  
88. # none 则表示不记日志，此配置可以提升些许性能  
89. log_dest none  
90.   
91. # 选择日志的级别（可设置多项）  
92. #log_type error  
93. #log_type warning  
94. #log_type notice  
95. #log_type information  
96.   
97. # 是否记录客户端连接信息  
98. #connection_messages true  
99.   
100. # 是否记录日志时间  
101. #log_timestamp true  
102.   
103. # =================================================================  
104. # Security  
105. # =================================================================  
106.   
107. # 客户端ID的前缀限制，可用于保证安全性  
108. #clientid_prefixes  
109.   
110. # 允许匿名用户  
111. #allow_anonymous true  
112.   
113. # 用户/密码文件，默认格式：username:password  
114. #password_file  
115.   
116. # PSK格式密码文件，默认格式：identity:key  
117. #psk_file  
118.   
119. # pattern write sensor/%u/data  
120. # ACL权限配置，常用语法如下：  
121. # 用户限制：user <username>  
122. # 话题限制：topic [read|write] <topic>  
123. # 正则限制：pattern write sensor/%u/data  
124. #acl_file  
125.   
126. # =================================================================  
127. # Bridges  
128. # =================================================================  
129.   
130. # 允许服务之间使用“桥接”模式（可用于分布式部署）  
131. #connection <name>  
132. #address <host>[:<port>]  
133. #topic <topic> [[[out | in | both] qos-level] local-prefix remote-prefix]  
134.   
135. # 设置桥接的客户端ID  
136. #clientid  
137.   
138. # 桥接断开时，是否清除远程服务器中的消息  
139. #cleansession false  
140.   
141. # 是否发布桥接的状态信息  
142. #notifications true  
143.   
144. # 设置桥接模式下，消息将会发布到的话题地址  
145. # $SYS/broker/connection/<clientid>/state  
146. #notification_topic  
147.   
148. # 设置桥接的keepalive数值  
149. #keepalive_interval 60  
150.   
151. # 桥接模式，目前有三种：automatic、lazy、once  
152. #start_type automatic  
153.   
154. # 桥接模式automatic的超时时间  
155. #restart_timeout 30  
156.   
157. # 桥接模式lazy的超时时间  
158. #idle_timeout 60  
159.   
160. # 桥接客户端的用户名  
161. #username  
162.   
163. # 桥接客户端的密码  
164. #password  
165.   
166. # bridge_cafile：桥接客户端的CA证书文件  
167. # bridge_capath：桥接客户端的CA证书目录  
168. # bridge_certfile：桥接客户端的PEM证书文件  
169. # bridge_keyfile：桥接客户端的PEM密钥文件  
170. #bridge_cafile  
171. #bridge_capath  
172. #bridge_certfile  
173. #bridge_keyfile  
174.   
175. # 自己的配置可以放到以下目录中  
176. 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 时出现错误

1. [root@localhost mosquitto-1.3]# make WITH_TLS=no  
2. set -e; for d in lib client src; do make -C ${d}; done  
3. make[1]: Entering directory `/qyl/mosquitto-1.3/lib'  
4. cc -Wall -ggdb -O2  -I. -I.. -I../lib -fPIC -DWITH_THREADING -DWITH_SRV -c mosquitto.c -o mosquitto.o  
5. In file included from mosquitto.c:46:  
6. mosquitto_internal.h:51:20: error: ares.h: No such file or directory  
7. In file included from mosquitto.c:46:  
8. mosquitto_internal.h:238: error: expected specifier-qualifier-list before ?.res_channel?  
9. mosquitto.c: In function ?.osquitto_loop?.  
10. mosquitto.c:834: error: ?.truct mosquitto?.has no member named ?.chan?  
11. mosquitto.c:837: warning: implicit declaration of function ?.res_fds?  
12. mosquitto.c:837: error: ?.truct mosquitto?.has no member named ?.chan?  
13. mosquitto.c:917: error: ?.truct mosquitto?.has no member named ?.chan?  
14. mosquitto.c:918: warning: implicit declaration of function ?.res_process?  
15. mosquitto.c:918: error: ?.truct mosquitto?.has no member named ?.chan?  
16. make[1]: *** [mosquitto.o] Error 1  
17. make[1]: Leaving directory `/qyl/mosquitto-1.3/lib'  
18. make: *** [mosquitto] Error 2 

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

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

[plain]  view plain copy

1. # Build with SRV lookup support.  
2. WITH_SRV:=no  

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