Mosquitto之配置文件解析

最新推荐文章于 2024-08-02 16:14:03 发布

haohaoge_jx

最新推荐文章于 2024-08-02 16:14:03 发布

阅读量2.5k

点赞数 1

分类专栏： Mosquitto 文章标签： mosquitto mqtt消息组件物联网

本文链接：https://blog.csdn.net/haohaoge_jx/article/details/103393350

版权

Mosquitto 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

本篇文章将解释mosquitto.conf文件中部分参数的意义，以方便理解和部署mosquitto。初次使用，难免出现错误，欢迎批评指正。

备注：mosquitto.conf配置文件以 '#' 作为注释。

基本相关

per_listener_settings：按监听配置。mosquitto具备一个默认的listener，称为默认监听端口，同时还可以配置多个listener，一个listener表示一个监听端口，可以在该监听端口上进行消息的发布与订阅操作。当配置多个listener时，本配置项需要设置为true；否则，只会有默认的那个listener生效。默认的listener的端口是通过后面的port指令开启的。

allow_duplicate_messages：设置为true时，允许客户端接收重复消息，false则不允许。mosquitto对于每个发送的的消息，它维护了一个数组，该数组中保存的是该消息已经发送到的客户端id（clientid）。每次发送一个消息时，mosquitto会先检查该客户端的clientid是否已经在该数组中，如果没在，则发送，然后再将该clientid添加到数组中；否则，该消息不会再发送，直接返回。

allow_zero_length_clientid：是否允许客户端连接时的clientid长度为0。本选项在MQTT3.1.1版本以后有效。客户端携带的clientid长度为0时，当本项值设置为true时，broker会结合auto_id_prefix自动生成一个clientid，然后返回给客户端；如果本项值设置为false，那么broker会直接断开与客户端的连接。

auto_id_prefix：自动生成clientid的前缀。

check_retain_source：本项仅针对retain消息（保留消息）有效。在每次有客户端发起订阅的时候，broker都会检查该保留消息的有效性，以决定是否将该消息发送给新接入的订阅者。它主要解决的是在一个消息发布者在发送了保留消息之后，后续假设该消息发布者已经失去了权限，并从访问控制列表（ACL）中被删除，这样，对于该保留消息，其实已经是无效的消息，如果此时有订阅者接入时，mosquitto会根据本项设置值决定是否再将本消息发送给该订阅者。true表示需要检查，false表示不需要检查，即：直接发送给订阅者。

max_inflight_bytes：对于Qos1/2，表示最大正在处理的字节数；一般不进行设置。

max_inflight_messages：仅针对Qos大于0的消息有效。表示最大正在处理的消息数，配合max_queued_messages可以用于限流和确保MQTT的稳定性，但是可能会出现消息丢失现象。

max_keepalive：表示broker支持的最大心跳包括间隔时间。一般说来，超过该时间间隔还未收到任何的数据，broker会断开与该客户端的连接。在mosquitto中，客户端在发起Connect的时候可以携带一个保活时间，broker将检查该保活时间是否大于本项设置值，如果大于，则会返回本设置值给客户端。mosquitto不建议本项设置在10以下，最大值为65535，单位为秒。

max_queued_messages：超过max_inflight_messages的消息会被缓存到队列中。本项设置队列的大小。

max_packet_size：数据包的最大大小。超过设置值，broker会主动断开与该client的连接。对于MQTT V5的版本，broker在断开时会返回一个错误消息给客户端；V5之前的版本不会返回该消息。备注：这里的大小包括了包头等信息，并不是指数据负载内容大小。

mem**：内存配置相关请参考配置文件说明。

persistent_client_expiration：本项针对于Durable客户端而言。超过该时间，broker会删除该会话的信息，这样，Durable 客户端将接收不到任何它断开之后到重连这段时间内未收到的消息。

其他配置略，配置文件描述的比较清楚，或者可以不配置.....

retain_available：false表示不支持retain消息。

upgrade_outgoing_qos：表示broker投递消息时是否适配订阅者的Qos。按照标准的MQTT协议，broker投递消息的Qos值是根据发布消息的Qos进行决策。如果发布消息的Qos大于订阅者要求的Qos，那么按照订阅者的Qos进行投递。如果发布消息的Qos小于订阅者要求的Qos，则按照该消息的Qos进行投递。本选项为true时将改变这一规则，即：强制按照订阅者的Qos进行投递。因此，本选项将不满足MQTT的标准。

user：mosquitto不建议使用root权限执行。

bind_address：绑定的ip地址或者主机名。

port：指定mosquitto默认监听的端口。非加密时默认为1883，ssl时建议设置为8883。

max_connections：最大连接数。本配置按listener进行区别，并不是总的连接数。

use_username_as_clientid：使用用户名代替clientid。username为鉴权中的username。如果本选项设置了，但是username为空，则broker会主动断开该客户端的连接。注意：不能与clientid_prefix共同使用。