takuyao/eclipse-mosquitto Docker 镜像

Eclipse Mosquitto v1.4.12 Docker镜像

镜像概述

Eclipse Mosquitto是开源的MQTT（消息队列遥测传输）消息代理工具，本镜像版本为v1.4.12，支持边缘场景，可实现设备间高效的消息发布与订阅，适用于轻量级通信需求。

核心功能

• 遵循MQTT协议，支持设备间消息交互
• 提供配置、数据持久化、日志三大挂载点，便于自定义管理
• 支持消息数据持久化存储，避免容器重启数据丢失
• 可配置日志输出路径，助力运维监控与问题排查

使用场景

• 物联网（IoT）设备间的实时消息通信
• 边缘计算环境下的本地消息代理部署
• 中小型系统中的轻量级消息传递解决方案

配置说明

挂载点

镜像预设三个挂载目录：

/mosquitto/config  # 配置文件目录  
/mosquitto/data    # 数据持久化目录  
/mosquitto/log     # 日志存储目录  

自定义配置

默认使用内置配置，如需自定义，将本地配置文件挂载到/mosquitto/config/mosquitto.conf：

bash
docker run -it -p 1883:1883 -p 9001:9001 -v <本地配置文件路径>:/mosquitto/config/mosquitto.conf docker.xuanyuan.run/eclipse-mosquitto:1.4.12

可通过配置实现：

• 开启数据持久化：

  persistence true  
  persistence_location /mosquitto/data/  
  

• 日志输出到文件：

  log_dest file /mosquitto/log/mosquitto.log  
  

注意：使用卷挂载时，数据会在容器间保持持久化。

构建镜像

bash
docker build -t eclipse-mosquitto:1.4.12 .  

运行容器

完整运行命令（含配置、数据、日志挂载）：

bash
docker run -it -p 1883:1883 -p 9001:9001 \  
  -v <本地配置文件路径>:/mosquitto/config/mosquitto.conf \  
  -v /mosquitto/data \  
  -v /mosquitto/log \  
  docker.xuanyuan.run/eclipse-mosquitto:1.4.12

⚠️ 若修改配置中的端口，需同步更新docker run命令的端口映射（如-p 1884:1884）。