aietes/mqtt

Mosquitto MQTT服务器（树莓派Debian版）镜像文档

镜像概述

本镜像基于Debian系统构建，集成了Mosquitto MQTT服务器，专为树莓派（Raspberry Pi）硬件平台优化。Mosquitto是一款轻量级开源MQTT消息代理，支持MQTT协议v3.1、v3.1.1和v5.0，适用于低带宽、低资源环境下的设备间通信，是物联网（IoT）项目的理想选择。

核心功能与特性

• 轻量级设计：资源占用低，适合树莓派等嵌入式设备
• 完整协议支持：兼容MQTT v3.1、v3.1.1和v5.0协议
• 树莓派优化：针对ARM架构优化，确保在树莓派上稳定运行
• 配置灵活：支持自定义配置文件，可配置认证、权限、持久化等
• 安全特性：支持TLS/SSL加密通信，保障数据传输安全
• 持久化存储：支持消息持久化，确保服务重启后消息不丢失

使用场景

• 家庭自动化系统：连接智能设备（如传感器、开关、摄像头）
• 物联网原型开发：快速搭建MQTT通信环境
• 传感器网络：收集和转发分布式传感器数据
• 嵌入式设备通信：实现树莓派与其他微控制器（如ESP32、Arduino）的通信
• 低功耗设备网络：支持低带宽环境下的设备间消息传递

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name mosquitto-rpi \
  -p 1883:1883 \  # MQTT默认端口（未加密）
  -v /path/to/mosquitto/config:/mosquitto/config \  # 挂载配置目录
  -v /path/to/mosquitto/data:/mosquitto/data \      # 挂载数据目录（持久化）
  -v /path/to/mosquitto/log:/mosquitto/log \        # 挂载日志目录
  --restart unless-stopped \
  mosquitto-rpi:latest

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  mosquitto:
    image: mosquitto-rpi:latest
    container_name: mosquitto-rpi
    ports:
      - "1883:1883"  # MQTT端口
      - "8883:8883"  # MQTT over TLS端口（如需启用）
    volumes:
      - ./mosquitto/config:/mosquitto/config
      - ./mosquitto/data:/mosquitto/data
      - ./mosquitto/log:/mosquitto/log
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai  # 设置时区

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

配置文件

默认配置文件路径：/mosquitto/config/mosquitto.conf
常用配置项示例：

conf
# 基本配置
listener 1883 0.0.0.0  # 监听所有网络接口的1883端口
allow_anonymous true   # 允许匿名连接（生产环境建议设为false）

# 持久化配置
persistence true
persistence_location /mosquitto/data/

# 日志配置
log_dest file /mosquitto/log/mosquitto.log
log_type all

# 认证配置（如需启用）
# password_file /mosquitto/config/password.txt
# allow_anonymous false

安全配置（TLS/SSL）

1. 准备TLS证书（如自签名证书）：

   bash
   openssl req -new -x509 -days 3650 -nodes -out /path/to/mosquitto/config/cert.pem -keyout /path/to/mosquitto/config/key.pem
   

2. 修改mosquitto.conf：

   conf
   listener 8883 0.0.0.0
   cafile /mosquitto/config/cert.pem
   certfile /mosquitto/config/cert.pem
   keyfile /mosquitto/config/key.pem
   tls_version tlsv1.2
   

3. 重启容器使配置生效

验证服务

使用mosquitto_sub和mosquitto_pub工具测试：

1. 订阅主题：

   bash
   mosquitto_sub -h <树莓派IP> -t "test/topic" -v
   

2. 发布消息：

   bash
   mosquitto_pub -h <树莓派IP> -t "test/topic" -m "Hello from MQTT"
   

如配置正确，订阅端将收到发布的消息。