Mosquitto是一個實現了MQTT3.1協議的代理服務器,由MQTT協議創始人之一的Andy Stanford-Clark開發,它為我們提供了非常棒的輕量級數據交換的解決方案。本文的主旨在於記錄Mosquitto服務的安裝和使用,以備日后查閱。
1、獲取&安裝
Mosquitto提供了Windows、Linux以及qnx系統的版本,安裝文件可從http://mosquitto.org/files/binary/ 地址中獲取。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 # ================================================================= # 客戶端心跳的間隔時間 #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推送服務中。