ruimarinho/mosquitto

ruimarinho/mosquitto Docker镜像

这是基于Alpine基础镜像构建的Mosquitto MQTT服务器镜像，包含服务器二进制文件及客户端工具（mosquitto_pub、mosquitto_sub），支持自动更新。

支持的标签及对应Dockerfile链接

• 1.5.1, 1.5, latest (https://github.com/ruimarinho/docker-mosquitto/blob/master/1.5/Dockerfile)
• 1.4.15, 1.4 (https://github.com/ruimarinho/docker-mosquitto/blob/master/1.4/Dockerfile)

核心功能

• 实现MQTT 3.1/3.1.1协议的开源服务器，提供轻量级发布/订阅消息机制。
• 适用于低带宽、小代码 footprint 场景，如物联网（IoT）、机器对机器（M2M）通信。
• 包含客户端工具：mosquitto_pub（发布消息）、mosquitto_sub（订阅消息）。

使用场景

• 物联网设备间实时消息交互。
• 智能家居系统设备状态同步。
• 传感器数据采集与远程传输。
• 移动应用与后端服务的低功耗通信。

配置说明

默认运行

镜像默认以mosquitto用户运行，监听1883端口：

sh
docker run --rm -it ruimarinho/mosquitto

自定义配置

挂载主机卷到/etc/mosquitto目录，使用自定义配置文件：

sh
docker run \
  -p 1883:1883 \
  -p 9001:9001 \
  -v /path/to/your/config:/etc/mosquitto \
  -d \
  ruimarinho/mosquitto -c /etc/mosquitto/mosquitto.conf -v

客户端工具示例

启动测试服务器

sh
docker run --rm -it --name mosquitto-server ruimarinho/mosquitto

订阅消息

订阅所有主题并打印消息：

sh
docker run --rm -it --link mosquitto-server ruimarinho/mosquitto mosquitto_sub -h mosquitto-server -t '#'

发布消息

发布消息到指定主题：

sh
docker run --rm -it --link mosquitto-server ruimarinho/mosquitto mosquitto_pub -h mosquitto-server -t home-assistant/switch/1/on -m "Switch is ON"

支持的Docker版本

官方支持Docker 1.12，旧版本提供最佳努力支持。

许可证

• 软件许可证：https://github.com/eclipse/mosquitto/blob/master/LICENSE.txt
• Docker项目许可证：https://github.com/ruimarinho/docker-mosquitto/blob/master/LICENSE