EMQ X的旧版本Docker镜像,适用于需要使用历史版本EMQ X MQTT消息服务器的场景,其中v2.3.4版本功能正常,v2.1.0和v2.1.1存在start.sh脚本配置bug。
EMQ X 旧版本 Docker 镜像文档
1. 镜像概述
本镜像为EMQ X(一款开源的MQTT消息服务器)的历史版本Docker镜像。需注意以下版本状态:
-
v2.1.0:存在
start.sh脚本bug,无法正确配置auth.mysql.username参数,不建议使用。
Dockerfile地址:https://github.com/emqx/emqx-docker/blob/b55440cf96f978ef8dba5a9b20fcaad8d9891f32/Dockerfile -
v2.1.1:同样存在
start.sh脚本bug,无法正确配置auth.mysql.username参数,不建议使用。
Dockerfile地址:https://github.com/emqx/emqx-docker/blob/1b04e44610f5d02c1ba073375117ddaaae4e7279/Dockerfile -
v2.3.4:功能正常,推荐使用此版本。
Dockerfile地址:https://github.com/emqx/emqx-docker/blob/24ad314468a40ea24b09345c94b899505a096435/Dockerfile
2. 核心功能与特性
- MQTT协议支持:兼容MQTT 3.1/3.1.1协议,提供TCP监听端口(默认1883),支持百万级并发连接。
- 插件系统:支持加载多种插件,如
emq_auth_mysql(MySQL认证)、emq_dashboard(Web控制台)、emq_retainer(消息留存)等。 - 环境变量配置:可通过环境变量灵活配置服务器参数,如监听端口、认证信息、插件加载列表等。
- 稳定性:v2.3.4版本修复了start.sh脚本的配置bug,可正常设置
auth.mysql.username等关键参数。
3. 使用场景
适用于需要部署旧版本EMQ X MQTT消息服务器的场景,例如:
- 对历史版本EMQ X有依赖的 legacy 系统;
- 需要验证旧版本功能或进行兼容性测试;
- 因特定业务需求无法升级至新版本的环境。
4. 使用方法与配置说明
4.1 前提条件
- 已安装Docker环境(Docker 1.13+);
- 若使用MySQL认证插件,需提前准备MySQL数据库服务及相关表结构。
4.2 快速启动命令
以下命令基于v2.3.4版本,通过docker run快速部署EMQ X容器,包含MySQL认证配置(需替换<project>、<mysql_url>、<xxxxxxxx>等占位符):
bash# 设置容器名称(替换<project>为实际项目名) name="emqx-<project>" # 清理同名旧容器(若存在) docker rm -f $(docker ps -aq --filter name=${name}) || echo "容器不存在,继续部署" # 启动EMQ X容器(v2.3.4版本) docker run -d --name ${name} --restart=always \ -p 18083:18083 -p 1883:1883 -p 4369:4369 \ -e EMQ_MQTT__LISTENER__TCP=1883 \ # MQTT TCP监听端口 -e EMQ_LOADED_PLUGINS="emq_auth_mysql,emq_recon,emq_modules,emq_retainer,emq_dashboard" \ # 加载的插件列表 -e EMQ_AUTH__MYSQL__SERVER="<mysql_url>:3306" \ # MySQL服务器地址(替换<mysql_url>) -e EMQ_AUTH__MYSQL__USERNAME="admin" \ # MySQL用户名 -e EMQ_AUTH__MYSQL__PASSWORD="<xxxxxxxx>" \ # MySQL密码(替换<xxxxxxxx>为实际密码) -e EMQ_AUTH__MYSQL__PASSWORD_HASH=plain \ # 密码加密方式(此处为明文,生产环境建议使用哈希) -e EMQ_AUTH__MYSQL__DATABASE="mqtt_table" \ # MySQL数据库名 alpine/emqx:2.3.4 sh -c "sleep 5 & /opt/emqttd/start.sh" # 需先执行sleep 5解决start.sh启动问题
4.3 参数说明
端口映射
| 宿主机端口 | 容器端口 | 用途 |
|---|---|---|
| 1883 | 1883 | MQTT TCP协议监听端口 |
| *** | *** | Web控制台(Dashboard)端口 |
| 4369 | 4369 | Erlang节点间通信端口 |
关键环境变量
| 环境变量 | 说明 |
|---|---|
EMQ_MQTT__LISTENER__TCP | MQTT TCP监听端口,默认1883 |
EMQ_LOADED_PLUGINS | 启动时加载的插件列表,逗号分隔(如emq_auth_mysql启用MySQL认证) |
EMQ_AUTH__MYSQL__SERVER | MySQL服务器地址,格式为<host>:<port> |
EMQ_AUTH__MYSQL__USERNAME | MySQL登录用户名 |
EMQ_AUTH__MYSQL__PASSWORD | MySQL登录密码 |
EMQ_AUTH__MYSQL__PASSWORD_HASH | 密码存储方式(plain为明文,md5/sha256等为哈希,需与数据库一致) |
EMQ_AUTH__MYSQL__DATABASE | 用于认证的MySQL数据库名 |
4.4 注意事项
- sleep 5的必要性:v2.3.4版本需在启动
start.sh前执行sleep 5,以解决脚本启动时的配置加载问题。 - 版本选择:避免使用v2.1.0和v2.1.1版本,这两个版本的
start.sh脚本存在bug,无法正确设置auth.mysql.username参数。 - 安全建议:生产环境中,
EMQ_AUTH__MYSQL__PASSWORD_HASH建议使用哈希方式(如sha256),并确保MySQL数据库访问权限限制。
4.5 参考文档
更多配置细节可参考上游官方文档:https://hub.docker.com/r/emqx/emqx
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务