jllopis/mosquitto

镜像概述

本镜像基于Alpine Linux构建，包含Mosquitto MQTT Broker（版本1.6.9）及mosquitto-auth-plug认证插件，支持MQTT over WebSocket协议，可通过Redis、PostgreSQL、HTTP、JWT等后端实现用户认证与权限控制。

核心功能

• 支持MQTT 3.1/3.1.1协议及WebSocket通信
• 集成认证插件，支持多后端存储认证信息
• 日志默认输出至stderr便于容器日志收集
• 扩展配置目录/etc/mosquitto.d，自动加载所有.conf文件

使用场景

• 物联网（IoT）设备间消息传递
• 分布式系统中的轻量级消息队列服务
• 需要用户认证与细粒度权限控制的MQTT通信场景

配置说明

持久化与卷挂载

镜像提供以下可挂载目录：

• /etc/mosquitto：主配置文件目录
• /etc/mosquitto.d：扩展配置文件目录
• /var/lib/mosquitto：数据持久化目录

主机目录映射示例

bash
docker run -ti \
  -v /host/mosquitto/etc:/etc/mosquitto \
  -v /host/mosquitto/etc.d:/etc/mosquitto.d \
  -v /host/mosquitto/data:/var/lib/mosquitto \
  -p 1883:1883 \
  -p 9883:9883 \
  jllopis/mosquitto:v1.6.9

数据卷容器示例

1. 创建数据卷容器：

bash
docker run -d -v /etc/mosquitto -v /etc/mosquitto.d -v /var/lib/mosquitto --name mqtt_data busybox /bin/true

2. 运行MQTT容器：

bash
docker run -ti \
  --volumes-from mqtt_data \
  -p 1883:1883 \
  -p 9883:9883 \
  jllopis/mosquitto:v1.6.9

认证访问示例（Redis后端）

1. 启动Redis容器：

bash
docker run -d --name redis_1 -v ${PWD}/redis-data:/data redis:3

2. 启动带Redis链接的MQTT容器：

bash
docker run -d \
  -v ${PWD}/mosquitto/etc:/etc/mosquitto \
  -v ${PWD}/mosquitto/etc.d:/etc/mosquitto.d \
  -v ${PWD}/mosquitto/data:/var/lib/mosquitto \
  -v ${PWD}/auth-plugin.conf:/etc/mosquitto.d/auth-plugin.conf \
  --name mqtt \
  -p 1883:1883 \
  -p 9883:9883 \
  --link redis_1:redis \
  jllopis/mosquitto:v1.6.9

3. 添加管理员用户密码：

bash
# 生成加密密码
docker run -ti --rm jllopis/mosquitto:v1.6.9 np -p secretpass
# 将密码存入Redis（替换<加密密码>为上一步输出）
docker run -it --link redis_1:redis --rm redis sh -c 'exec redis-cli -h "$REDIS_PORT_6379_TCP_ADDR" -p "$REDIS_PORT_6379_TCP_PORT" SET admin <加密密码>'

4. 测试订阅与发布：

bash
# 订阅测试主题
mosquitto_sub -h localhost -t test -u admin -P secretpass
# 发布测试消息
mosquitto_pub -h localhost -t test -m "测试消息" -u admin -P secretpass