machinedata/mosquitto

支持的标签及对应Dockerfile链接

• latest, 1, 1.4, 1.4.10 https://github.com/machine-data/docker-oauth2_proxy/blob/master/Dockerfile
• 1.4.8 https://github.com/machine-data/docker-node-red/blob/v1.4.8-r2/Dockerfile

Docker上的Mosquitto

本仓库提供Docker镜像构建定义及支持文件，用于运行Mosquitto，并作为自动化构建镜像machine-data/mosquitto发布于Docker Hub。

什么是Mosquitto？

Mosquitto是开源（EPL/EDL许可）的消息代理，实现MQTT 3.1和3.1.1协议。MQTT采用轻量级发布/订阅模型，适合物联网场景（如低功耗传感器、移动设备、嵌入式计算机）的消息通信。

镜像特点

本镜像具备以下优势：

• 基于Alpine Linux，体积轻量；
• 配置简洁，支持环境变量或配置文件灵活配置；
• 遵循Docker最佳实践（放弃root权限、信号处理、日志管理等）；
• 用户数据集中于/data目录，便于卷挂载。

快速开始

启动容器

sh
docker run -d --name mosquitto_test machine-data/mosquitto

推送消息

sh
docker run --rm -ti --link mosquitto_test machine-data/mosquitto mosquitto_pub -h mosquitto_test -t "mytopic/mypath" -m "message payload" -q 1 -r

消费消息

sh
docker run --rm -ti --link mosquitto_test:mosquitto machine-data/mosquitto mosquitto_sub -h localhost -t "mytopic/mypath" -C 1

持久化数据

sh
mkdir data
docker run -d --volume $(pwd)/data:/data --publish 1880:1880 machine-data/mosquitto

环境变量配置

无配置文件时，可通过以下变量配置：

• MOSQUITTO_LOG_DEST：日志输出目标（默认stdout）；
• MOSQUITTO_PERSISTENCE：是否持久化数据（默认true）；
• MOSQUITTO_PERSISTENCE_LOCATION：持久化目录（默认/data/，需以斜杠结尾）。

配置文件挂载

挂载自定义配置文件（忽略环境变量）：

sh
curl -O https://raw.githubusercontent.com/eclipse/mosquitto/master/mosquitto.conf
sed -e "s#log_dest syslog#log_dest stdout#" -e "s#\#persistence false#persistence true#" -e "s#\#persistence_location#persistence_location /data/#" mosquitto.conf
docker run -d -v $(pwd)/mosquitto.conf:/config/mosquitto.conf:ro -p 1883:1883 machine-data/mosquitto

卷与端口

• 卷：/data（存储内存数据库）；
• 端口：1883（默认监听）、8883（TLS需手动配置）、9001（WebSocket需手动配置）。

***声明

Mosquitto采用EPL/EDL双许可；docker-mosquitto采用Apache 2.0许可，版权归2016-2017 Crate.io, Inc.所有。

贡献指南

可通过GitHub提交Issue或Pull Request，或加入Slack交流。