snoopy86/emoncms-docker

Emoncms-MQTT 集成Docker镜像

镜像概述

本Docker镜像将Emoncms能源监控系统与MQTT消息服务集成在单个容器中，提供一站式的能源数据采集、存储、监控及物联网设备通信解决方案。适用于需要简化部署流程的能源监控场景，无需分别配置Emoncms和MQTT服务。

核心功能与特性

• Emoncms集成：完整包含Emoncms开源能源监控系统，支持能源数据采集、处理、可视化及分析
• MQTT服务：内置MQTT消息代理，支持物联网设备间的消息传递与数据上报
• 单容器部署：无需额外配置多个服务容器，简化部署与维护流程
• 轻量级设计：优化容器体积，降低资源占用

使用场景与适用范围

• 家庭或小型企业能源消耗监控系统搭建
• 太阳能、风能等可再生能源设备数据采集与分析
• 物联网设备（如传感器、智能电表）数据汇聚与处理
• 教育或科研环境中的能源监控实验平台

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name emoncms-mqtt \
  -p 80:80 \  # Emoncms Web界面端口
  -p 1883:1883 \  # MQTT服务端口
  -v ./emoncms-data:/var/www/emoncms/data \  # 数据持久化
  -v ./mqtt-data:/var/lib/mosquitto \  # MQTT数据持久化
  --restart unless-stopped \
  [镜像名称]

Docker Compose配置示例

yaml
version: '3'
services:
  emoncms-mqtt:
    image: docker.xuanyuan.run/[镜像名称]
    container_name: emoncms-mqtt
    ports:
      - "80:80"
      - "1883:1883"
    volumes:
      - ./emoncms-data:/var/www/emoncms/data
      - ./mqtt-data:/var/lib/mosquitto
    restart: unless-stopped

环境变量配置

数据持久化

建议通过挂载卷（Volume）持久化以下目录，避免容器重启后数据丢失：

• /var/www/emoncms/data：Emoncms数据存储目录（包含配置、日志、采集数据）
• /var/lib/mosquitto：MQTT服务数据目录（包含消息队列、配置）

访问与使用

1. 部署完成后，通过 http://[主机IP]:[EMONCMS_PORT] 访问Emoncms Web界面
2. 使用MQTT客户端（如MQTT.fx、mosquitto_sub/pub）连接 [主机IP]:[MQTT_PORT] 进行消息通信
3. 在Emoncms中配置数据源，可通过MQTT协议接收物联网设备上报的能源数据