peez/hivemq

专业HiveMQ Docker镜像

镜像概述

本镜像基于HiveMQ 3.3.3版本构建，提供生产级预配置，支持通过环境变量自定义配置，集成TLS加密、集群发现插件、文件认证插件等功能，适用于快速部署高可用的MQTT消息代理服务。

核心功能

• 支持TLS加密通信，需挂载自定义密钥库和信任库
• 集成数据库集群发现插件，通过PostgreSQL实现集群状态管理
• 内置文件认证插件，支持自定义凭据和配置
• 支持持久化模式配置（内存或持久存储）
• 允许自定义配置文件、日志配置

使用场景

• 物联网（IoT）设备之间的消息通信
• 构建高可用的MQTT消息队列服务
• 企业级消息代理部署

配置说明

安装许可证

默认使用开发版许可证，如需使用正式许可证，挂载许可证文件到/opt/hivemq/license：

bash
docker run -itd -v /本地路径/license.lic:/opt/hivemq/license/license.lic:ro peez/hivemq

持久化配置

默认使用内存持久化，可通过环境变量HIVEMQ_PERSISTENCE_MODE切换为持久存储：

bash
docker run -itd -e HIVEMQ_PERSISTENCE_MODE=file peez/hivemq

自定义配置

挂载自定义config.xml到/opt/hivemq/conf/config_initial.xml（启动脚本会自动处理）：

bash
docker run -itd -v /本地路径/config.xml:/opt/hivemq/conf/config_initial.xml:ro peez/hivemq

TLS配置

挂载自定义密钥库和信任库，并设置环境变量：

bash
docker run -itd \
  -v /本地路径/keystore.jks:/opt/hivemq/cert/hivemq_keystore.jks:ro \
  -v /本地路径/truststore.jks:/opt/hivemq/cert/hivemq_truststore.jks:ro \
  -e HIVEMQ_KEYSTORE_PASSWORD=your_keystore_pw \
  -e HIVEMQ_PRIVATE_KEY_PASSWORD=your_private_key_pw \
  -e HIVEMQ_TRUSTSTORE_PASSWORD=your_truststore_pw \
  peez/hivemq

认证插件配置

默认启用文件认证插件，凭据为hivemq/test。如需禁用：

bash
docker run -itd -e HIVEMQ_DISABLE_AUTH_PLUGIN=true peez/hivemq

自定义凭据或配置文件：

bash
docker run -itd \
  -v /本地路径/credentials.properties:/opt/hivemq-modules/fileauth/conf/credentials.properties:ro \
  -v /本地路径/fileAuthConfiguration.properties:/opt/hivemq-modules/fileauth/conf/fileAuthConfiguration.properties:ro \
  peez/hivemq

集群部署（Docker Swarm模式）

1. 创建overlay网络：

bash
docker network create --driver overlay hivemqcluster

2. 启动PostgreSQL数据库：

bash
docker service create --name clusterdb --network hivemqcluster -p 5432:5432 \
  -e POSTGRES_PASSWORD=cluster -e POSTGRES_USER=cluster -e POSTGRES_DB=cluster \
  postgres:latest

3. 启动HiveMQ集群（3个副本）：

bash
docker service create --name hivemq --network hivemqcluster -p 1883:1883 --replicas=3 \
  -e HIVEMQ_CLUSTER_JDBC_URL=jdbc:postgresql://clusterdb:5432/cluster \
  -e HIVEMQ_CLUSTER_JDBC_USER=cluster \
  -e HIVEMQ_CLUSTER_JDBC_PASSWORD=cluster \
  peez/hivemq:dev