Eclipse Mosquitto Docker 镜像使用说明

快速参考

维护方

Eclipse 基金会

获取帮助渠道

Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应 Dockerfile 链接

• 2.0.22, 2.0.22-openssl, 2.0, 2.0-openssl, 2, 2-openssl, openssl, latest
• 1.6.15-openssl, 1.6-openssl

快速参考（续）

问题反馈地址

[***]

支持的架构

（更多信息）
amd64、arm32v6、arm64v8、i386、ppc64le、s390x

镜像详情

repo-info 仓库的 repos/eclipse-mosquitto/ 目录（历史记录）
（包含镜像元数据、传输大小等）

镜像更新

official-images 仓库的 library/eclipse-mosquitto 标签
official-images 仓库的 library/eclipse-mosquitto 文件（历史记录）

本文档来源

docs 仓库的 eclipse-mosquitto/ 目录（历史记录）

什么是 Eclipse Mosquitto？

Eclipse Mosquitto 是 MQTT 协议（版本 5、3.1.1 和 3.1）的开源服务器实现。官网：[***]

!logo

Eclipse Mosquitto 与 Cedalo

Cedalo 为 Eclipse Mosquitto 提供商业支持、企业级 MQTT 产品、专业服务及培训。

如何使用本镜像

目录结构

镜像中预设了三个目录，分别用于配置、持久化存储和日志：

• /mosquitto/config（配置目录）
• /mosquitto/data（数据存储目录）
• /mosquitto/log（日志目录）

建议本地也按此结构创建目录，以便映射容器内目录。

配置方法

默认运行时使用镜像内置的配置。如需自定义配置，可按以下步骤操作：

1. 在本地创建配置文件：$PWD/mosquitto/config/mosquitto.conf
2. 运行容器时，将本地配置目录挂载到容器的 /mosquitto/config：

   bash
   docker run -it -p 1883:1883 -v "$PWD/mosquitto/config:/mosquitto/config" eclipse-mosquitto
   

配置示例：
如需启用数据持久化并指定日志路径，可在 mosquitto.conf 中添加：

ini
persistence true          # 启用持久化
persistence_location /mosquitto/data/  # 数据存储路径
log_dest file /mosquitto/log/mosquitto.log  # 日志文件路径

注意：若通过卷（volume）挂载目录，数据会在容器重启后保留。

运行容器

根据需求选择以下命令运行容器：

基础运行（仅挂载配置目录）

bash
docker run -it -p 1883:1883 -v "$PWD/mosquitto/config:/mosquitto/config" eclipse-mosquitto

完整挂载（配置、数据、日志目录均映射到本地）

bash
docker run -it -p 1883:1883 \
  -v "$PWD/mosquitto/config:/mosquitto/config" \
  -v "$PWD/mosquitto/data:/mosquitto/data" \
  -v "$PWD/mosquitto/log:/mosquitto/log" \
  eclipse-mosquitto

自定义端口

若配置文件中修改了默认端口（如新增 8080 端口），需在运行时同步映射端口：

bash
docker run -it -p 1883:1883 -p 8080:8080 \
  -v "$PWD/mosquitto/config:/mosquitto/config" \
  eclipse-mosquitto

许可证

Eclipse Mosquitto 基于 EPL/EDL 许可证发布。

与所有 Docker 镜像类似，本镜像可能包含其他软件（如基础系统的 Bash 等），其许可证需另行遵守。更多许可证信息可参考 repo-info 仓库的 eclipse-mosquitto/ 目录。

使用前请确保遵守镜像中所有软件的相关许可证。