smartboot/smart-mqtt

smart-mqtt 镜像文档

镜像概述

smart-mqtt镜像是一个轻量级的MQTT消息代理（broker）实现，用于在设备之间建立可靠的消息传递通道。它遵循MQTT协议标准，可作为物联网（IoT）等场景中的消息中间件，实现设备与设备、设备与服务器之间的异步通信。

核心功能

• 支持MQTT协议，实现设备间消息发布与订阅
• 轻量级设计，资源占用低，适合嵌入式设备及服务器环境
• 提供基本的消息路由与传递能力

使用场景

• 物联网设备通信：连接各类传感器、智能设备，实现数据上报与控制指令下发
• 分布式系统消息传递：作为轻量级消息中间件，实现服务间异步通信
• 实时数据传输场景：需要低延迟、可靠消息传递的应用场景

使用方法

快速启动

1. 创建docker-compose.yml文件

创建配置文件并拷贝以下内容：

yaml
services:
  smart-mqtt:
    container_name: smart-mqtt  # 容器名称
    hostname: smart-mqtt       # 容器主机名
    image: smartboot/smart-mqtt:latest  # 镜像名称及版本
    ports:
      - 1883:1883/tcp  # 映射MQTT默认端口1883
    read_only: true    # 容器以只读模式运行
    restart: always    # 容器退出时自动重启
    security_opt:
      - no-new-privileges:true  # 禁止获取新权限
    user: root:root    # 运行用户
    logging:
      driver: "json-file"  # 日志驱动
      options:
        max-size: "100m"   # 单日志文件最大大小
        max-file: "1"      # 日志文件保留数量
version: '3.7'  # docker-compose版本

2. 启动容器

在docker-compose.yml文件所在目录执行以下命令启动服务：

bash
docker compose up -d

配置说明

• 端口映射：默认映射1883端口（MQTT标准端口），可根据需求修改宿主机端口
• 只读模式：read_only: true 增强容器安全性，限制对文件系统的写入操作
• 重启策略：restart: always 确保服务持续运行，意外退出后自动恢复
• 日志配置：限制日志文件大小和数量，避免磁盘空间占用过大
• 安全选项：no-new-privileges:true 防止容器内进程获取额外权限，提升安全性