node

node

node.name

Type Default
string emqx@127.0.0.1
说明

节点名。格式为 <name>@<host>。其中 <host> 可以是 IP 地址，也可以是 FQDN。详见 http://erlang.org/doc/reference_manual/distributed.html node - 图1 (opens new window)。

node.cookie

Type Default
string emqxsecretcookie
说明

分布式 Erlang 集群使用的 cookie 值。

node.data_dir

Type Default
folder ./data
说明

节点的 data 目录，用于存放 Mnesia 数据文件等。

node.heartbeat

Type Optional Value Default
enum on, off off
说明

系统调优参数，此配置将覆盖 vm.args 文件里的 -heart 参数。

启用或关闭 Erlang 运行时检测机制，并在运行时终止时自动重启。需小心使用，以免手动关闭 emqx 时被监控进程重新启动。

node.async_threads

Type Optional Value Default
integer 0 - 1024 4
说明

系统调优参数，此配置将覆盖 vm.args 文件里的 +A 参数。

设置 Erlang 运行时异步线程池中的线程数量。详情请参见 http://erlang.org/doc/man/erl.html node - 图2 (opens new window)。

node.process_limit

Type Optional Value Default
integer 1024 - 134217727 2097152
说明

系统调优参数，此配置将覆盖 vm.args 文件里的 +P 参数。

设置 Erlang 允许的最大进程数，这将影响 emqx 节点能处理的连接数。详情请参见 http://erlang.org/doc/man/erl.html node - 图3 (opens new window)。

node.max_ports

Type Optional Value Default
integer 1024 - 134217727 1048576
说明

系统调优参数，此配置将覆盖 vm.args 文件里的 +Q 参数。

设置 Erlang 允许的最大 Ports 数量。详情请参见 http://erlang.org/doc/man/erl.html node - 图4 (opens new window)。

node.dist_buffer_size

Type Optional Value Default
bytesize 1KB - 2GB 8MB
说明

系统调优参数，此配置将覆盖 vm.args 文件里的 +zdbbl 参数。

设置 Erlang 分布式通信使用的最大缓存大小。详情请参见 http://erlang.org/doc/man/erl.html node - 图5 (opens new window)。

node.max_ets_tables

Type Default
integer 262144
说明

系统调优参数，此配置将覆盖 vm.args 文件里的 +e 参数。

设置 Erlang 运行时允许的最大 ETS 表数量。详情请参见 http://erlang.org/doc/man/erl.html node - 图6 (opens new window)。

node.global_gc_interval

Type Default
duration 15m
说明

系统调优参数，设置 Erlang 运行多久强制进行一次全局垃圾回收。

node.fullsweep_after

Type Optional Value Default
integer 0 - 65535 1000
说明

系统调优参数，此配置将覆盖 vm.args 文件里的 -env ERL_FULLSWEEP_AFTER 参数。

设置 Erlang 运行时多少次 generational GC 之后才进行一次 fullsweep GC。详情请参见 http://erlang.org/doc/man/erlang.html#spawn_opt-4 node - 图7 (opens new window)。

node.crash_dump

Type Default
string log/crash.dump
说明

设置 Erlang crash_dump 文件的存储路径和文件名。

node.ssl_dist_optfile

Type Default
string etc/ssl_dist.conf
说明

此配置将覆盖 vm.args 文件里的 -ssl_dist_optfile 参数。

如使用 SSL 方式建立 emqx 集群，需指定 SSL 分布式协议的配置文件。需要与 cluster.proto_dist = inet_tls 一起使用。

node.dist_net_ticktime

Type Default
integer 120
说明

系统调优参数，此配置将覆盖 vm.args 文件里的 -kernel net_ticktime 参数。

当一个节点持续无响应多久之后，认为其已经宕机并断开连接。详情请参见 http://www.erlang.org/doc/man/kernel_app.html#net_ticktime node - 图8 (opens new window)。

node.dist_listen_min

Type Optional Value Default
integer 1024 - 65535 6369
说明

与 node.dist_listen_max 一起设定一个 TCP 端口段，此端口段用于分配给分布式 Erlang，作为分布式通道的监听端口。注意如果在节点之间设置了防火墙，需要将此端口段放进防火墙的端口白名单里。

node.dist_listen_max

Type Optional Value Default
integer 1024 - 65535 6369
说明

与 node.dist_listen_min 一起设定一个 TCP 端口段，此端口段用于分配给分布式 Erlang，作为分布式通道的监听端口。注意如果在节点之间设置了防火墙，需要将此端口段放进防火墙的端口白名单里。