sneck/emqttd

EMQ Docker镜像

EMQ（Erlang MQTT Broker）是一款采用Erlang/OTP编写的分布式、高可扩展、高度灵活的MQTT消息代理。本镜像基于Alpine Linux构建，旨在提供轻量且高效的MQTT服务部署方案。

核心功能

• 分布式架构，支持大规模水平扩展
• 支持MQTT（1883）、MQTTS（8883）、HTTP/WS（8083）、HTTPS/WSS（8084）等多种协议端口
• 通过环境变量灵活配置节点名称、日志级别、***登录权限等参数
• 支持插件动态加载（如认证插件、仪表盘插件、状态监测插件等）

使用场景

• 物联网（IoT）设备间的消息通信与数据采集
• 实时应用（如即时通讯、监控系统）的消息中间件
• 分布式系统中的跨服务消息传递
• 高并发场景下的消息队列服务

快速部署示例

基础运行命令

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

说明：映射1883端口（MQTT）和***端口（Web仪表盘），启动EMQ服务。

配置说明

通过环境变量可配置EMQ容器的各项参数，以下是常用配置项：

EMQ基础配置

配置示例：修改MQTT TCP端口

bash
docker run --rm -ti --name emq -e "EMQ_TCP_PORT=1883" -p 18083:18083 -p 1883:1883 sneck/emqttd:latest

插件配置

通过EMQ_LOADED_PLUGINS环境变量指定加载的插件，默认加载以下插件：

• emq_recon（系统监测）
• emq_dashboard（Web仪表盘）
• emq_mod_presence（在线状态监测）
• emq_mod_retainer（消息保留）
• emq_mod_subscription（默认订阅）

插件加载示例：添加emq_auth_redis插件

使用逗号分隔插件名称：

bash
docker run --rm -ti --name emq -e "EMQ_LOADED_PLUGINS=emq_auth_redis,emq_recon,emq_dashboard" -p 18083:18083 -p 1883:1883 sneck/emqttd:latest

https://github.com/emqtt/emq-docker