zoneinternal

zone.internal.allow_anonymous

TypeOptional ValueDefault
enumtrue, falsetrue
说明

是否允许匿名用户登录系统。

zone.internal.enable_stats

TypeOptional ValueDefault
enumon, offon
说明

是否开启客户端状态统计。

zone.internal.enable_acl

TypeOptional ValueDefault
enumon, offoff
说明

是否开启 ACL 检查。

zone.internal.acl_deny_action

TypeOptional ValueDefault
enumignore, disconnectignore
说明

ACL 检查失败后,执行的操作。

  • ignore:不做任何操作。
  • disconnect:断开连接。

zone.internal.force_gc_policy

TypeDefault
string-
说明

当收到一定数量的消息,或字节,就强制执行一次垃圾回收。

格式:<Number>|<Bytes>

例如,16000|16MB 表示当收到 16000 条消息,或 16MB 的字节流入就强制执行一次垃圾回收。

zone.internal.wildcard_subscription

TypeOptional ValueDefault
enumtrue, false-
说明

是否支持订阅通配主题。

zone.internal.shared_subscription

TypeOptional ValueDefault
enumtrue, false-
说明

是否支持共享订阅。

zone.internal.max_subscriptions

TypeDefault
integer0
说明

单个客户端允许订阅的最大主题数。0 表示不限制。

zone.internal.max_inflight

TypeDefault
integer128
说明

飞行窗口大小。飞行窗口用于存储未被应答的 QoS 1 和 QoS 2 消息。

zone.internal.max_awaiting_rel

TypeDefault
integer1000
说明

QoS 2 消息的最大接收窗口,配置 EMQ X 能够同时处理多少从客户端发来的 QoS 2 消息。0 表示不限制。

zone.internal.max_mqueue_len

TypeDefault
integer10000
说明

消息队列最大长度。当飞行窗口满,或客户端离线后,消息会被存储至该队列中。0 表示不限制。

``zone.internal.mqueue_store_qos0

TypeOptional ValueDefault
enumtrue, falsetrue
说明

消息队列是否存储 QoS 0 消息。

zone.internal.enable_flapping_detect

TypeOptional ValueDefault
enumon, offoff
说明

是否开启 Flapping 检查。

zone.internal.force_shutdown_policy

TypeDefault
string-
说明

当进程消息队列长度,或占用的内存字节到达某值,就强制关闭该进程。

这里的 消息队列 指的是 Erlang 进程的 消息邮箱,并非 QoS 1 和 QoS 2 的 mqueue

格式:<Number>|<Bytes>

例如,32000|32MB 表示当进程堆积了 32000 条消息,或进程占用内存达到 32MB 则关闭该进程。

zone.internal.mountpoint

TypeDefault
string-
说明

主题挂载点。配置后,所有订阅和发布的主题在 EMQ X 都会为其增加一个前缀。

其中可用的占位符有:

  • %c:表示客户端的 Client ID。
  • %u:表示客户端的 Username。

例如,配置挂载点为 user/%c/。那么 Client ID 为 tom 的客户端在发布主题 open 消息时,实际在 EMQ X 中路由的主题是 user/tom/open

zone.internal.ignore_loop_deliver

TypeOptional ValueDefault
enumtrue, falsefalse
说明

是否忽略自己发送的消息。如果忽略,则表明 EMQ X 不会向消息的发送端投递此消息。

zone.internal.strict_mode

TypeOptional ValueDefault
enumtrue, falsefalse
说明

是否开启严格检查模式。严格检查模式会更细致的检查 MQTT 报文的正确性。

zone.internal.bypass_auth_plugins

TypeOptional ValueDefault
enumtrue, falsetrue
说明

是否允许该 Zone 下的客户端绕过认证插件的认证步骤。