spants/mqtt

MQTT Docker镜像文档

镜像概述和主要用途

本镜像基于Alpine 3.3构建，提供MQTT协议支持并集成WebSocket功能，适用于需要轻量级消息传输的场景。通过简单配置即可快速部署MQTT broker，支持标准MQTT端口(1883)和WebSocket端口(9001)，满足物联网设备通信、实时消息传递等需求。

核心功能和特性

• MQTT协议支持：兼容MQTT标准协议，支持消息发布/订阅模式
• WebSocket支持：提供9001端口用于WebSocket连接，支持浏览器等Web客户端接入
• 密码加密机制：通过passwords.txt文件自动加密并管理用户密码
• 配置持久化：支持挂载/config目录，实现配置文件持久化存储
• 轻量级基础：基于Alpine 3.3，镜像体积小，资源占用低

使用场景和适用范围

• 物联网(IoT)设备间的消息通信
• 实时数据传输与监控系统
• Web应用与后端服务的实时消息交互
• 开发测试环境中的MQTT broker快速部署

使用方法和配置说明

准备工作

1. 创建本地配置目录，用于持久化存储配置文件：

   bash
   mkdir -p /path/to/local/config
   

密码设置

1. 创建密码文件：在本地配置目录中创建passwords.txt文件（不要直接编辑passwords.mqtt），文件格式参考passwords.README说明
2. 启动容器：容器启动时会自动加密passwords.txt中的密码，添加到passwords.mqtt顶部，并删除passwords.txt

运行容器

Docker Run命令

bash
docker run -t -i --net="bridge" \
  -p 1883:1883/tcp \  # MQTT标准端口
  -p 9001:9001 \      # WebSocket端口
  -v /path/to/local/config:/config \  # 挂载配置目录
  spants/mqtt

移除密码要求

如需关闭密码验证：

1. 停止容器：

   bash
   docker stop <container_id>
   

2. 编辑本地配置目录中的mosquitto.conf文件，移除密码相关配置
3. 重新启动容器

注意事项

• 密码管理仅通过passwords.txt文件进行，不要直接修改passwords.mqtt
• 配置目录挂载是必要的，否则容器重启后配置和密码信息会丢失
• WebSocket连接使用9001端口，确保该端口在防火墙中已开放