woahbase/alpine-mosquitto

alpine-mosquitto

镜像概述

alpine-mosquitto是一个基于Alpine Linux的多架构Docker镜像，集成了S6进程管理工具和Mosquitto MQTT代理服务器。该镜像以轻量级为特点，适合在资源受限环境中部署，提供稳定可靠的MQTT协议消息传递功能，支持物联网、智能家居等场景下的设备通信需求。

核心功能与特性

• 多架构支持：适配x86_64、aarch64、armv7l、armhf、i386、ppc64le、riscv64、s390x等多种硬件架构，满足不同设备部署需求。
• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低，启动速度快。
• 进程管理：集成S6进程管理工具，确保Mosquitto服务稳定运行、优雅重启及进程监控。
• Mosquitto核心功能：支持MQTT v3.1.1和v5.0协议，实现发布/订阅消息传递模式，支持TCP和WebSocket连接。

使用场景与适用范围

• 物联网（IoT）设备间的实时数据通信。
• 智能家居系统中设备状态同步与控制指令传递。
• 传感器网络的数据采集与集中监控。
• 分布式系统中的轻量级消息中间件。
• 边缘计算、嵌入式设备等资源受限环境下的MQTT代理部署。

使用方法与配置说明

快速启动

通过docker run命令直接启动基础服务：

bash
docker run -d --name alpine-mosquitto -p 1883:1883 -p 9001:9001 woahbase/alpine-mosquitto

• -p 1883:1883：映射MQTT默认TCP端口，用于设备间消息通信。
• -p 9001:9001：映射WebSocket端口（需配置启用），支持Web应用接入。

持久化与自定义配置

为实现配置持久化和数据保存，建议挂载本地目录：

bash
docker run -d --name alpine-mosquitto \
  -p 1883:1883 \
  -v /path/to/local/config:/etc/mosquitto \
  -v /path/to/local/data:/var/lib/mosquitto \
  woahbase/alpine-mosquitto

• /path/to/local/config：本地配置目录，可放置mosquitto.conf自定义服务参数。
• /path/to/local/data：本地数据目录，用于持久化Mosquitto运行数据。

Docker Compose配置

创建docker-compose.yml文件简化部署：

yaml
version: '3'
services:
  mosquitto:
    image: woahbase/alpine-mosquitto
    container_name: alpine-mosquitto
    ports:
      - "1883:1883"  # MQTT TCP端口
      - "9001:9001"  # MQTT WebSocket端口
    volumes:
      - ./mosquitto/config:/etc/mosquitto
      - ./mosquitto/data:/var/lib/mosquitto
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置文件说明

默认配置文件路径为/etc/mosquitto/mosquitto.conf，可通过挂载本地配置文件自定义参数，常用配置项包括：

• 端口设置：listener 1883（TCP端口）、listener 9001+protocol websockets（WebSocket端口）。
• 认证配置：使用password_file /etc/mosquitto/passwd启用密码认证，通过mosquitto_passwd工具生成密码文件。
• 访问控制：通过acl_file /etc/mosquitto/acl定义主题访问权限，限制客户端发布/订阅范围。

维护与支持

该镜像由WOAHBase维护，源代码托管于https://github.com/woahbase/alpine-mosquitto%EF%BC%8C%E9%95%9C%E5%83%8F%E5%8F%AF%E5%9C%A8https://hub.docker.com/r/woahbase/alpine-mosquitto%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%82