erlio/docker-vernemq

docker-vernemq

什么是VerneMQ？

VerneMQ是一款高性能分布式MQTT消息代理，可在通用硬件上实现水平与垂直扩展，支持大量并发发布者与消费者，同时保持低延迟和容错性。它是IoT平台或智能产品的可靠消息枢纽，采用Apache2许可协议，基于Erlang开发。

核心功能

• 高并发支持：处理大规模并发连接与消息传递
• 分布式集群：支持自动发现与集群部署，保证高可用性
• 多协议兼容：原生支持MQTT 3.1/3.1.1/5.0及WebSocket
• 灵活配置：通过环境变量或配置文件自定义参数
• 安全认证：支持***访问、文件认证及第三方集成认证

使用场景

• IoT设备数据采集与指令下发
• 智能产品实时消息交互
• 分布式系统间的消息传递枢纽
• 大规模实时数据流处理场景

配置与部署说明

1. 接受EULA

使用官方镜像需接受VerneMQ最终用户许可协议，通过环境变量DOCKER_VERNEMQ_ACCEPT_EULA=yes确认接受。

2. 快速部署示例

纯Docker部署

bash
# 基础启动（需接受EULA）
docker run -e "DOCKER_VERNEMQ_ACCEPT_EULA=yes" --name vernemq -d vernemq/vernemq

# 允许匿名访问并映射端口
docker run -p 1883:1883 -e "DOCKER_VERNEMQ_ACCEPT_EULA=yes" -e "DOCKER_VERNEMQ_ALLOW_ANONYMOUS=on" --name vernemq -d vernemq/vernemq

Kubernetes部署（Helm）

bash
# 添加Helm仓库
helm repo add vernemq https://vernemq.github.io/docker-vernemq

# 部署集群
helm install my-vernemq vernemq/vernemq

Docker Swarm部署

yaml
# docker-compose.yml
version: "3.7"
services:
  vmq0:
    image: vernemq/vernemq
    environment: [DOCKER_VERNEMQ_SWARM=1]
  vmq:
    image: vernemq/vernemq
    depends_on: [vmq0]
    environment: [DOCKER_VERNEMQ_SWARM=1, DOCKER_VERNEMQ_DISCOVERY_NODE=vmq0]
    deploy: {replicas: 2}

执行部署：docker stack deploy -c docker-compose.yml my-vernemq-stack

3. 集群状态检查

bash
# Docker容器
docker exec vernemq vmq-admin cluster show

# Kubernetes Pod
kubectl exec my-vernemq-0 -- vmq-admin cluster show

4. 配置参数

所有vernemq.conf参数可通过DOCKER_VERNEMQ_前缀定义，例如：

• allow_anonymous=on → -e DOCKER_VERNEMQ_ALLOW_ANONYMOUS=on
• log.console.level=debug → -e DOCKER_VERNEMQ_LOG__CONSOLE__LEVEL=debug（点替换为双下划线）

5. 文件认证

通过环境变量添加用户：

bash
docker run -e "DOCKER_VERNEMQ_ACCEPT_EULA=yes" -e "DOCKER_VERNEMQ_USER_test='mypassword'" --name vernemq -d vernemq/vernemq

用户名自动转为小写，密码不含=字符。

更多配置细节见VerneMQ官方文档。