emqx_gateway_schema {
dtls_listener_acceptors.desc:
"""Acceptor 进程池大小。"""
dtls_listener_dtls_opts.desc:
"""DTLS Socket 配置"""
gateway_common_authentication.desc:
"""网关的认证器配置,对该网关下所以的监听器生效。如果每个监听器需要配置不同的认证器,需要配置监听器下的 authentication
字段。"""
gateway_common_clientinfo_override.desc:
"""ClientInfo 重写。"""
gateway_common_clientinfo_override_clientid.desc:
"""clientid 重写模板"""
gateway_common_clientinfo_override_password.desc:
"""password 重写模板"""
gateway_common_clientinfo_override_username.desc:
"""username 重写模板"""
gateway_common_enable.desc:
"""是否启用该网关"""
gateway_common_enable_stats.desc:
"""是否开启客户端统计"""
gateway_common_idle_timeout.desc:
"""客户端连接过程的空闲时间。该配置用于:
1. 一个新创建的客户端进程如果在该时间间隔内没有收到任何客户端请求,将被直接关闭。
2. 一个正在运行的客户进程如果在这段时间后没有收到任何客户请求,将进入休眠状态以节省资源。"""
gateway_common_listener_access_rules.desc:
"""配置监听器的访问控制规则。
见:https://github.com/emqtt/esockd#allowdeny"""
gateway_common_listener_bind.desc:
"""监听器绑定的 IP 地址或端口。"""
gateway_common_listener_enable.desc:
"""是否启用该监听器。"""
gateway_common_listener_enable_authn.desc:
"""配置 true
(默认值)启用客户端进行身份认证。
配置 false
时,将不对客户端做任何认证。"""
gateway_common_listener_max_conn_rate.desc:
"""监听器支持的最大连接速率。"""
gateway_common_listener_max_connections.desc:
"""监听器支持的最大连接数。"""
gateway_mountpoint.desc:
"""发布或订阅时,在所有主题前增加前缀字符串。
当消息投递给订阅者时,前缀字符串将从主题名称中删除。挂载点是用户可以用来实现不同监听器之间的消息路由隔离的一种方式。
例如,如果客户端 A 在 `listeners.tcp.\.mountpoint` 设置为 `some_tenant` 的情况下订阅 `t`,
则客户端实际上订阅了 `some_tenant/t` 主题。
类似地,如果另一个客户端 B(连接到与客户端 A 相同的侦听器)向主题 `t` 发送消息,
则该消息被路由到所有订阅了 `some_tenant/t` 的客户端,因此客户端 A 将收到该消息,带有 主题名称`t`。 设置为 `""` 以禁用该功能。
挂载点字符串中可用的变量:
- ${clientid}
:clientid
- ${username}
:用户名"""
listener_name_to_settings_map.desc:
"""从监听器名称到配置参数的映射。"""
ssl_listener_options.desc:
"""SSL Socket 配置。"""
tcp_listener_acceptors.desc:
"""Acceptor 进程池大小。"""
tcp_listener_proxy_protocol.desc:
"""是否开启 Proxy Protocol V1/2。当 EMQX 集群部署在 HAProxy 或 Nginx 后需要获取客户端真实 IP 时常用到该选项。参考:https://www.haproxy.com/blog/haproxy/proxy-protocol/"""
tcp_listener_proxy_protocol_timeout.desc:
"""接收 Proxy Protocol 报文头的超时时间。如果在超时内没有收到 Proxy Protocol 包,EMQX 将关闭 TCP 连接。"""
tcp_listener_tcp_opts.desc:
"""TCP Socket 配置。"""
tcp_listeners.desc:
"""配置 TCP 类型的监听器。"""
tcp_udp_listeners.desc:
"""监听器配置。"""
udp_listener_active_n.desc:
"""为 Socket 指定 {active, N} 选项。
参见:https://erlang.org/doc/man/inet.html#setopts-2"""
udp_listener_buffer.desc:
"""Socket 在用户空间的缓冲区大小。"""
udp_listener_recbuf.desc:
"""Socket 在内核空间接收缓冲区的大小。"""
udp_listener_reuseaddr.desc:
"""允许重用本地处于 TIME_WAIT 的端口号。"""
udp_listener_sndbuf.desc:
"""Socket 在内核空间发送缓冲区的大小。"""
udp_listener_udp_opts.desc:
"""UDP Socket 配置。"""
udp_listeners.desc:
"""配置 UDP 类型的监听器。"""
}