mainflux/mqtt-verne

VerneMQ Docker镜像（Mainflux集成版）

镜像概述

本镜像基于VerneMQ构建，是一个轻量级、高性能的MQTT消息代理容器，预集成了与Mainflux物联网平台对接的专用插件。VerneMQ作为开源MQTT broker，支持MQTT 3.1、3.1.1和5.0协议，具备高可用性和可扩展性；通过集成Mainflux插件，可实现与Mainflux平台的设备管理、数据流转等功能的无缝集成。

核心功能与特性

• 原生VerneMQ能力：支持高并发连接、消息持久化、集群部署，符合MQTT标准协议
• Mainflux集成插件：预安装专用插件，实现与Mainflux平台的认证、授权及数据同步
• 简化部署：容器化封装，减少环境依赖，快速启动和配置
• 灵活扩展：支持通过环境变量和配置文件自定义参数，适应不同场景需求

使用场景与适用范围

• 基于Mainflux平台构建的物联网系统，需MQTT协议进行设备通信
• 智能家居、工业监控、智慧城市等物联网应用中消息代理层的部署
• 需要快速集成VerneMQ与Mainflux平台的开发和测试环境
• 对消息传输可靠性、实时性有要求的分布式物联网场景

使用方法与配置说明

基本运行

通过以下命令启动容器：

bash
docker run -d \
  --name vernemq-mainflux \
  -p 1883:1883 \  # MQTT默认端口
  -p 8883:8883 \  # MQTTs端口（如需TLS）
  -p 8080:8080 \  # HTTP API端口
  mainflux/vernemq:latest

环境变量配置

可通过环境变量自定义配置，常用参数：

示例（自定义Mainflux API地址）：

bash
docker run -d \
  --name vernemq-mainflux \
  -p 1883:1883 \
  -e MAINFLUX_API_URL="http://192.168.1.100:8180" \
  mainflux/vernemq:latest

持久化数据

为避免容器重启后配置和数据丢失，可挂载本地目录：

bash
docker run -d \
  --name vernemq-mainflux \
  -p 1883:1883 \
  -v /path/to/vernemq/data:/vernemq/data \
  -v /path/to/vernemq/etc:/vernemq/etc \
  mainflux/vernemq:latest

验证运行状态

容器启动后，可通过以下命令检查日志：

bash
docker logs vernemq-mainflux

若看到类似 vernemq is running 的日志，表明服务正常启动。可使用MQTT客户端连接 localhost:1883 进行测试。