mosquitto配置文件详解

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

# Config file for mosquitto
#
# See mosquitto.conf(5) for more information.
#
# Default values are shown, uncomment to change.
#
# Use the # character to indicate a comment, but only if it is the 
# very first character on the line.

# =================================================================
# General configuration
# =================================================================
# 客户端心跳的时间间隔,重新发送已经发出去的Qos 为1或者2的消息的等待时间
retry_interval 20

# 系统状态的刷新时间,设置为0表示不刷新
sys_interval 10

#系统资源的回收时间
#清除在内部消息存储里面的未引用的消息的时间。 #较低的值将占用较少的内存,但处理器时间较长, #越高的值将产生相反的效果。 #设置值为0意味着未引用的消息将以尽可能快的速度处理。 store_clean_interval 10
#服务进程的PID #pid_file /var/run/mosquitto.pid # 以什么用户启动 mosquitto,此配置在 windows 下无效,以非 root 运行无效 #user mosquitto #客户端心跳消息的最大并非数
#当前每个客户端正在传输的Qo1和2消息的最大数量。 #这包括通过握手信息,以及那些正在重试的信息。 #默认为20。设置为0表示无上限。 #设置为1将保证QoS 1 和2的消息按顺序传递 max_inflight_messages 20 #客户端心跳消息缓存队列
#当前正在进行的队列中Qos 1和2条消息的最大数量。默认为100。 #设置到0表示没有上限(不推荐)。同样可参见queue_qos0_messages max_queued_messages 100 #设置为true,当一个持久客户端被断开连接时,以Qos为0将消息放到队列中。 #这些消息受max_queued_messages限制 queue_qos0_messages false #此选项设置被代理允许发布的消息的大小。 #超过这个尺寸的消息将不会被代理接受。 #默认值为0,这意味着所有有效的MQTT消息都被接受。 #MQTT的最大有效大小为268435455字节 message_size_limit 0 # 用于设置客户端长连接的过期时间,默认永不过期,必须以h d w m y为单位 #分别代表 小时,天,星期,月,念 #persistent_client_expiration # 如果客户端订阅了多个重叠的订阅,例如foo/#和foo/+/baz,然后MQTT期望当代理接 #收到一个与两个订阅相匹配的主题的消息时,例如foo/bar/baz,那么客户端应该只接 #收一次消息。为了满足这一要求,mosquitto不断跟踪发送给客户的消息。允许重复的 #消息选项允许禁用此行为,如果您有大量的客户端订阅相同的主题集合,并且非常关注 #最小化内存使用的情况,那么这个选项可能是有用的。如果你事先知道你的客户端永不 #会有重叠的订阅,那么你的客户必须能够正确处理重复的信息,即使在Qo = 2的时候, #你的客户端也必须能够正确地处理重复的信息 #allow_duplicate_messages false # ================================================================= # 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命令设置你需要的系统参数

posted on 2018-10-18 18:55  清明-心若淡定  阅读(9861)  评论(0编辑  收藏  举报