rainisto/emqtt

Docker化emqtt镜像说明

镜像概述

本镜像为Docker化的emqttd v2.0.7，用于快速部署高可用（HA）MQTT消息服务器集群，适用于物联网（IoT）、实时通信系统等场景，提供稳定的消息传递服务。

核心功能

• 支持高可用（HA）集群部署
• 兼容标准MQTT协议
• 通过环境变量灵活配置节点信息
• 可与HAProxy配合实现负载均衡

使用场景

• 物联网设备数据采集与实时传输
• 分布式系统间的消息通信
• 实时消息推送服务（如通知、告警）

配置说明

• NODE_IP: 节点IP地址（必填，每个节点需设置）
• MASTER: 主节点IP地址（仅从节点需要设置）

部署示例

1. 在3台Docker机器上部署HA集群

bash
# 主节点（192.168.1.7）
docker run -d --name emqtt-master --net=host -e NODE_IP=192.168.1.7 rainisto/emqtt

# 从节点1（192.168.1.8）
docker run -d --name emqtt-node1 --net=host -e NODE_IP=192.168.1.8 -e MASTER=192.168.1.7 rainisto/emqtt

# 从节点2（192.168.1.9）
docker run -d --name emqtt-node2 --net=host -e NODE_IP=192.168.1.9 -e MASTER=192.168.1.7 rainisto/emqtt

# 部署HAProxy负载均衡（可选）
docker run -d --name haproxy-emqtt --net=host -v haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg rainisto/haproxy-emqtt

2. 在Swarm overlay网络中部署集群

bash
# 创建overlay网络
docker network create --driver overlay --subnet 10.0.1.0/24 mqtt

# 部署主节点
docker service create --constraint "node.hostname==node1.local" --name emqtt-master --network mqtt -e NODE_IP=emqtt-master rainisto/emqtt

# 部署从节点1
docker service create --constraint "node.hostname==node2.local" --name emqtt-node1 --network mqtt -e NODE_IP=emqtt-node1 -e MASTER=emqtt-master rainisto/emqtt

# 部署从节点2
docker service create --constraint "node.hostname==node3.local" --name emqtt-node2 --network mqtt -e NODE_IP=emqtt-node2 -e MASTER=emqtt-master rainisto/emqtt

# 部署HAProxy并暴露端口
docker service create --name haproxy-emqtt --network mqtt -p 1883:1883 -p ***:*** rainisto/haproxy-emqtt

# 扩展HAProxy实例数
docker service scale haproxy-emqtt=3