waljqiang/emqx

EMQX 消息服务器 Docker 镜像文档

镜像概述和主要用途

本镜像为 EMQX 消息服务器的 Docker 封装，基于 debian:10-slim 构建，由 waljqiang 维护。EMQX 是一款开源的 MQTT 消息服务器，支持高并发连接和多种消息传输协议，适用于物联网设备通信、实时数据传输等场景，提供 Web 管理界面和丰富的系统调优选项。

核心功能和特性

支持的端口及协议

Web 管理界面（Dashboard）

• 默认用户名/密码：admin/public

使用场景和适用范围

• 物联网（IoT）设备间的消息通信
• 实时数据传输与消息中间件
• 需要支持高并发 MQTT 连接的场景
• 分布式消息系统部署

使用方法和配置说明

基本运行命令

bash
docker run --name test -d -p 18083:18083 docker.xuanyuan.run/waljqiang/emqx:${tag}

说明：将 ${tag} 替换为具体版本标签，如 4.0.0。

系统调优

为确保 EMQX 服务性能，需进行以下系统调优：

系统全局允许分配的最大文件句柄数

bash
sysctl -w fs.file-max=2097152
sysctl -w fs.nr_open=2097152
echo 2097152 > /proc/sys/fs/nr_open

允许当前会话/进程打开文件句柄数

bash
ulimit -n 1048576

持久化 fs.file-max 设置到 /etc/sysctl.conf 文件

bash
echo "fs.file-max = 1048576" >> /etc/sysctl.conf

/etc/systemd/system.conf 设置服务最大文件句柄数

bash
echo "DefaultLimitNOFILE=1048576" >> /etc/systemd/system.conf

/etc/security/limits.conf 持久化设置允许用户/进程打开文件句柄数

bash
echo -e "*      soft   nofile      1048576\n*      hard   nofile      1048576" >> /etc/security/limits.conf

TCP 协议栈网络参数

并发连接 backlog 设置

bash
sysctl -w net.core.somaxconn=32768
sysctl -w net.ipv4.tcp_max_syn_backlog=16384
sysctl -w net.core.netdev_max_backlog=16384

可用知名端口范围

bash
sysctl -w net.ipv4.ip_local_port_range='1000 65535'

TCP Socket 读写 Buffer 设置

bash
sysctl -w net.core.rmem_default=262144
sysctl -w net.core.wmem_default=262144
sysctl -w net.core.rmem_max=16777216
sysctl -w net.core.wmem_max=16777216
sysctl -w net.core.optmem_max=16777216
sysctl -w net.ipv4.tcp_rmem='1024 4096 16777216'
sysctl -w net.ipv4.tcp_wmem='1024 4096 16777216'

TCP 连接追踪设置

bash
sysctl -w net.netfilter.nf_conntrack_max=1000000
sysctl -w net.netfilter.nf_conntrack_tcp_timeout_time_wait=30

TIME-WAIT Socket 最大数量、回收与重用设置

bash
sysctl -w net.ipv4.tcp_max_tw_buckets=1048576
# 注意：不建议开启以下设置，NAT 模式下可能引起连接 RST
# sysctl -w net.ipv4.tcp_tw_recycle=1
# sysctl -w net.ipv4.tcp_tw_reuse=1

FIN-WAIT-2 Socket 超时设置

bash
sysctl -w net.ipv4.tcp_fin_timeout=15

Erlang 虚拟机参数

优化设置 Erlang 虚拟机启动参数，修改配置文件 emqx/etc/emqx.conf：

ini
## Erlang Process Limit
node.process_limit = 2097152
## Sets the maximum number of simultaneously existing ports for this system
node.max_ports = 1048576

Docker 参数调优

bash
docker run -d --name emqx -p 18083:18083 -p 1883:1883 -p 4369:4369 \
  --sysctl fs.file-max=2097152 \
  --sysctl fs.nr_open=2097152 \
  --sysctl net.core.somaxconn=32768 \
  --sysctl net.ipv4.tcp_max_syn_backlog=16384 \
  --sysctl net.core.netdev_max_backlog=16384 \
  --sysctl net.ipv4.ip_local_port_range=1000 65535 \
  --sysctl net.core.rmem_default=262144 \
  --sysctl net.core.wmem_default=262144 \
  --sysctl net.core.rmem_max=16777216 \
  --sysctl net.core.wmem_max=16777216 \
  --sysctl net.core.optmem_max=16777216 \
  --sysctl net.ipv4.tcp_rmem=1024 4096 16777216 \
  --sysctl net.ipv4.tcp_wmem=1024 4096 16777216 \
  --sysctl net.ipv4.tcp_max_tw_buckets=1048576 \
  --sysctl net.ipv4.tcp_fin_timeout=15 \
  emqx/emqx:4.0.0

友情提示：不要使用 --privileged 或者将系统内核目录挂载到 Docker 中进行调优。

EMQX 消息服务器参数

修改 emqx/etc/emqx.conf 或 emqx/etc/listeners.conf 配置文件，调整 acceptor 池大小和最大允许连接数：

ini
## TCP Listener
listener.tcp.external = 0.0.0.0:1883
listener.tcp.external.acceptors = 64
listener.tcp.external.max_connections = 1024000

测试客户端设置

测试客户端服务器在一个接口上最多只能创建 65000 连接，需进行以下设置：

bash
sysctl -w net.ipv4.ip_local_port_range="500 65535"
echo 1000000 > /proc/sys/fs/nr_open
ulimit -n 100000

并发连接测试工具

• https://github.com/waljqiang/emqx 或 https://github.com/emqx/emqtt-bench
• 第二个链接中点击 tag->release 可找到编译好的包。

相关链接

• 代码仓库：https://github.com/waljqiang/emqx