cburki/mosquitto

cburki/mosquitto 镜像说明

镜像概述

本镜像封装了轻量级MQTT消息代理软件mosquitto，提供稳定高效的消息传递能力，适用于物联网、实时应用及微服务架构等场景。

核心功能

• 支持MQTT协议（默认端口1883）
• 支持MQTT WebSocket通信（默认端口9883）
• 可通过环境变量配置用户认证
• 支持动态添加认证用户

使用场景

• 物联网设备间的实时消息交互
• 实时应用的消息推送（如聊天、通知）
• 微服务架构中的异步通信
• 传感器数据采集与传输

配置说明

通过以下环境变量启用用户认证：

• MQTT_USERNAME：认证用户名
• MQTT_PASSWORD：认证密码
  未设置时，镜像运行不启用认证。

部署示例

构建镜像

在docker-mosquitto目录执行：

bash
docker build -t cburki/mosquitto .

运行镜像

绑定端口并配置认证：

bash
docker run \
    --name mosquitto \
    --volumes-from <容器ID> \
    -d \
    -p 1883:1883 \
    -p 9883:9883 \
    -e MQTT_USERNAME=<你的用户名> \
    -e MQTT_PASSWORD=<你的密码> \
    cburki/mosquitto:latest

添加额外用户

在运行的容器中执行：

bash
docker exec -it mosquitto /bin/bash
mosquitto_passwd /data/mqtt/password <新用户名>

根据提示输入密码完成添加。