emqx-retaineremqx-retainer (opens new window) - 图1 (opens new window)

retainer.storage_type

TypeOptional ValueDefault
enumram, disc, disc_onlyram
说明

保留消息的存储类型,以下选项可用:

ram

保留消息仅存储在内存中。

disc

保留消息同时存储在内存和磁盘中。

disc_only

保留消息仅存储在磁盘中。

retainer.max_retained_messages

TypeDefault
integer0
说明

保留消息的存储数量限制。一旦存储数量达到限制,可以替换已存在的保留消息,但不能为新的主题存储保留消息。0 表示没有限制。

retainer.max_payload_size

TypeDefault
bytesize1MB
说明

允许存储的保留消息的 Payload 最大长度限制。如果 Payload 超出最大限制,该保留消息可以被正常处理,但不会存储在服务端。

retainer.expiry_interval

TypeDefault
duration0
说明

保留消息的过期间隔,仅对协议版本低于 MQTT v5.0 的客户端生效,MQTT v5.0 客户端的保留消息过期间隔将以 Message Expiry Interval 的值为准。0 表示永不过期。