kireevco/emqttd

EMQ Docker镜像

镜像概述

EMQ（Erlang MQTT Broker）是一款用Erlang/OTP编写的分布式、高可扩展MQTT消息 broker，本镜像基于官方EMQ Docker仓库构建，镜像大小约37.1MB，支持MQTT 3.1/3.1.1/5.0协议，适用于物联网与实时应用场景。

核心功能

• 分布式架构：支持大规模集群部署，满足高并发消息处理需求
• 多协议支持：兼容TCP、SSL/TLS、WebSocket（WS/WSS）等通信方式
• 插件扩展：通过插件机制实现认证（Redis/MySQL等）、数据持久化、监控等功能
• 管理控制台：提供Web界面（默认端口***），方便配置与监控

使用场景

• 物联网（IoT）设备间的消息通信与数据上报
• 实时应用系统的消息中间件（如即时通讯、实时监控）
• 分布式系统中的消息路由与转发

配置说明

环境变量映射规则

以EMQ_为前缀的环境变量对应配置文件参数，将配置中的点（.）替换为双下划线（__），例如：

• EMQ_LISTENER__SSL__EXTERNAL__ACCEPTORS → listener.ssl.external.acceptors
• EMQ_MQTT__MAX_PACKET_SIZE → mqtt.max_packet_size

部署示例

1. 基本运行

bash
docker run --rm -ti --name emq -p 18083:18083 -p 1883:1883 emq:latest

2. 加载Redis认证插件

bash
docker run --rm -ti --name emq -p 18083:18083 -p 1883:1883 -p 4369:4369 \
    -e EMQ_LISTENER__TCP__EXTERNAL=1883 \
    -e EMQ_LOADED_PLUGINS="emq_auth_redis,emq_recon,emq_modules,emq_retainer,emq_dashboard" \
    -e EMQ_AUTH__REDIS__SERVER="your.redis.server:6379" \
    -e EMQ_AUTH__REDIS__PASSWORD="your_redis_password" \
    -e EMQ_AUTH__REDIS__PASSWORD_HASH=plain \
    emq:latest

3. 集群部署

bash
docker run --rm -ti --name emq -p 18083:18083 -p 1883:1883 -p 4369:4369 -p 6000-6100:6000-6100 \
    -e EMQ_NAME="emq" \
    -e EMQ_HOST="s2.emqtt.io" \
    -e EMQ_LISTENER__TCP__EXTERNAL=1883 \
    -e EMQ_JOIN_CLUSTER="emq@s1.emqtt.io" \
    emq:latest

4. 内核调优

bash
docker run --rm -ti --name emq -p ***:*** -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=*** \
    --sysctl net.core.netdev_max_backlog=*** \
    --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=*** \
    --sysctl net.core.wmem_max=*** \
    --sysctl net.core.optmem_max=*** \
    --sysctl net.ipv4.tcp_rmem=1024 4096 *** \
    --sysctl net.ipv4.tcp_wmem=1024 4096 *** \
    --sysctl net.ipv4.tcp_max_tw_buckets=*** \
    --sysctl net.ipv4.tcp_fin_timeout=15 \
    emq:latest