kdsmith/egauge2mqtt

eGauge-MQTT数据上传镜像

镜像概述与主要用途

本Docker镜像用于实现本地eGauge设备与本地MQTT代理之间的数据传输，核心功能是将eGauge设备采集的能源监测数据实时发布至本地MQTT代理，支持构建基于MQTT协议的本地化数据传输与集成系统。

核心功能与特性

• 数据转发：从本地eGauge设备采集能源数据并发布至指定MQTT代理
• 本地网络适配：优化局域网环境下eGauge设备与MQTT代理的通信链路
• 轻量级设计：镜像体积精简，资源占用低，适合边缘计算环境部署
• 协议兼容：支持标准MQTT协议，适配主流MQTT代理（如Mosquitto、EMQX等）

使用场景与适用范围

• 家庭能源监控：在智能家居系统中，将eGauge电表数据接入本地MQTT生态，实现能源使用可视化
• 工业数据集成：工业环境中eGauge设备的能源监测数据与本地SCADA或MES系统的MQTT数据总线对接
• 边缘数据预处理：本地化部署场景下，减少数据上传云端的延迟与带宽消耗，提升实时性

使用方法与配置说明

前提条件

• 本地eGauge设备已正常运行并可通过局域网访问
• 本地MQTT代理服务已部署（如未部署，可参考官方文档搭建）
• 运行环境需具备Docker Engine 20.10+或兼容容器运行时

配置参数

部署示例

Docker Run快速启动

bash
docker run -d \
  --name egauge-mqtt-bridge \
  -e EGAUGE_IP=192.168.1.10 \
  -e MQTT_BROKER=192.168.1.20 \
  -e MQTT_PORT=1883 \
  -e MQTT_TOPIC=home/energy/egauge \
  -e UPDATE_INTERVAL=30 \
  egauge-mqtt-uploader:latest

Docker Compose配置

yaml
version: '3.8'
services:
  egauge-mqtt:
    image: egauge-mqtt-uploader:latest
    container_name: egauge-mqtt-bridge
    environment:
      - EGAUGE_IP=192.168.1.10       # 替换为实际eGauge设备IP
      - EGAUGE_PORT=80
      - MQTT_BROKER=mqtt.local       # 替换为MQTT代理地址
      - MQTT_PORT=1883
      - MQTT_TOPIC=energy/monitoring
      - MQTT_USER=mqtt_user          # 如MQTT代理启用认证
      - MQTT_PASSWORD=secure_pass    # 如MQTT代理启用认证
      - UPDATE_INTERVAL=60
    restart: unless-stopped
    network_mode: bridge             # 确保与eGauge和MQTT代理在同一网络

注意事项

• 网络连通性：需确保容器所在网络可访问eGauge设备的EGAUGE_IP:EGAUGE_PORT及MQTT代理的MQTT_BROKER:MQTT_PORT
• 认证配置：若MQTT代理启用用户名密码认证，必须同时配置MQTT_USER和MQTT_PASSWORD参数
• 数据格式：发布至MQTT的消息默认采用JSON格式，包含eGauge设备的标准监测字段（如电压、电流、功率等）