一、获取、安装
Mosquitto提供了Windows、Linux以及qnx系统的版本,安装文件可从 http://mosquitto.org/files/binary/获取。Windows系统下的安装过程非常简单,甚至可以把Mosquitto直接安装成为系统服务;但是,在实际应用中更倾向于使用Linux系统的服务器。在Linux系统上安装Mosquitto,建议使用源码安装模式,最新的源码可从 http://mosquitto.org/files/source/获取。解压之后,可以在源码目录里面找到主要的配置文件config.mk,其中包含了所有Mosquitto的安装选项,详细的参数说明如下:
这里需要注意的是,默认情况下Mosquitto的安装需要OpenSSL的支持;如果不需要SSL,则需要关闭config.mk里面的某些与SSL功能有关的选项(WITH_TLS、WITH_TLS_PSK)。接着,就是运行make install进行安装,完成之后会在系统命令行里发现mosquitto、mosquitto_passwd、mosquitto_pub和 mosquitto_sub四个工具,分别用于启动代理、管理密码、发布消息和订阅消息。
二、配置、运行
安装完成之后,所有配置文件会被放置于/etc/mosquitto/目录下,其中最重要的就是Mosquitto的配置文件,即mosquitto.conf,以下是详细的配置参数说明。
启动Mosquitto服务很简单,直接运行命令行“ mosquitto -c /etc/mosquitto/mosquitto.conf -d”即可。另外,Mosquitto是个纯异步IO框架,经测试可以轻松处理20000个以上的客户端连接。当然,实际的最大承载量还和业务的复杂度有比较大的关系。测试的时候不要忘记调整系统的最大连接数和栈大小,比如Linux上可用ulimit -n20000 -s512命令设置你需要的系统参数。
Mosquitto提供了Windows、Linux以及qnx系统的版本,安装文件可从 http://mosquitto.org/files/binary/获取。Windows系统下的安装过程非常简单,甚至可以把Mosquitto直接安装成为系统服务;但是,在实际应用中更倾向于使用Linux系统的服务器。在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
二、配置、运行
安装完成之后,所有配置文件会被放置于/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是个纯异步IO框架,经测试可以轻松处理20000个以上的客户端连接。当然,实际的最大承载量还和业务的复杂度有比较大的关系。测试的时候不要忘记调整系统的最大连接数和栈大小,比如Linux上可用ulimit -n20000 -s512命令设置你需要的系统参数。