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命令设置你需要的系统参数
