文档中心

云原生消息引擎

集群配置

MQTT 配置

在 Dashboard 的管理 > 集群配置 > MQTT 配置页面，您可以查看或修改 MQTT 协议相关的配置项，包括通用配置、会话配置、保留消息和系统主题的配置。

通用

通用页签下，展示 MQTT 协议的通用基础配置项，包括最大报文大小、最大客户端 ID 长度、主题层级和 QoS 等配置项。

会话

会话页签下，展示 MQTT 协议的会话相关配置项，包括最大订阅数量、消息重试间隔、是否存储 QoS 0 消息等相关配置。

保留消息

保留消息页签下，展示 MQTT 协议的保留消息相关配置项，例如启用保留消息、消息的存储类型与方式、保留消息的最大数量、保留消息的负载大小、保留消息过期间隔等相关配置。

配置项	说明
启用保留消息	是否启用保留消息。说明当停用保留消息时，已有的保留消息将不会被删除。
存储类型	固定存储类型为内置数据库。
存储方式	保留消息的存储方式。 ram：仅存储在内存中。 disc：存储在内存和硬盘中。
最大保留消息数	保留消息的的数量上限，默认不限（0）。当设置了最大保留消息数的限制后，MQTT 在达到限制时会替换现有消息，且在达到限制后您不能再为新主题存储保留消息。
最大消息负载大小	保留消息的最大负载大小。如果负载超过最大值，MQTT 将把保留的保留消息视为普通消息。
消息过期间隔	保留消息的过期时间，默认永不过期（0）。如果在 PUBLISH 数据包中设置了消息过期时间间隔，则以 PUBLISH 数据包中的消息过期时间为准。
消息清理间隔	清理过期消息的间隔，默认禁用。
派发速率	派发保留消息的最大速率。

系统主题

系统主题页签下，展示 MQTT 内置的系统主题相关配置项，包括消息发布周期、心跳周期、客户端连接/断开提醒等配置项。

MQTT 将周期性的运行状态、使用统计和即时客户端事件发布到 $SYS/ 开头的系统主题，当客户端订阅此类主题时，MQTT 将会将相关的信息发布到该主题下。

最近更新时间：2025.08.04 17:30:02

这个页面对您有帮助吗？

有用

无用