evanrich/py-eagle-mqtt

py-eagle-mqtt

镜像概述

py-eagle-mqtt 是一个基于 Python3 构建的 Docker 镜像，主要用于读取 Rainforest Eagle 能源监控器的数据，并将其推送到 MQTT 代理（Broker）。该镜像移植自 https://github.com/TD22057/T-Home 的 T-Home 自动化项目，并针对 Docker 环境及安全性进行了代码优化和调整。

核心功能与特性

• 数据桥接：接收来自 Rainforest Eagle 设备的实时能源数据。
• 协议转换：将接收到的能源数据转换为 JSON 格式，并发布为 MQTT 消息。
• 轻量级 Web 服务器：内置小型 Web 服务器（监听 22042 端口），作为 Eagle 设备的“云服务提供商（Cloud Provider）”接收数据推送。
• 灵活的 MQTT 配置：支持自定义 MQTT 代理地址、端口、心跳时间以及身份验证。

使用场景

• 智能家居集成：将家庭实时用电数据接入 Home Assistant、Node-RED 等支持 MQTT 的智能家居平台。
• 能源监控与分析：采集 Eagle 能源监控器数据，用于长期的电力消耗分析、可视化看板（如 Grafana）或自动化节能策略。

部署与使用

使用 Docker CLI 部署

bash
docker run -d \
  --name=py-eagle-mqtt \
  -e MQTT_BROKER_IP=192.168.1.100 \
  -e MQTT_BROKER_PORT=1883 \
  -e KEEPALIVE=60 \
  -e MQTT_USER=your_mqtt_user \
  -e MQTT_PASSWORD=your_mqtt_password \
  -p 22042:22042 \
  docker.xuanyuan.run/evanrich/py-eagle-mqtt

使用 Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  py-eagle-mqtt:
    image: docker.xuanyuan.run/evanrich/py-eagle-mqtt
    container_name: py-eagle-mqtt
    restart: unless-stopped
    ports:
      - "22042:22042"
    environment:
      - MQTT_BROKER_IP=192.168.1.100
      - MQTT_BROKER_PORT=1883
      - KEEPALIVE=60
      - MQTT_USER=your_mqtt_user
      - MQTT_PASSWORD=your_mqtt_password

启动服务：

bash
docker-compose up -d

环境变量与配置参数

必填参数

可选参数

端口映射

设备配置说明

为了让 Rainforest Eagle 设备将数据发送到本容器，您需要在 Eagle 设备的本地管理界面中进行以下配置：

1. 登录 Rainforest Eagle 的 Web 管理界面。
2. 导航至 Cloud 或 Network 设置（具体名称取决于固件版本）。
3. 将 Cloud Provider（云服务提供商）类型设置为自定义或本地服务器。
4. 将目标 URL/IP 设置为运行此 Docker 容器的宿主机 IP，端口设置为 22042（例如：http://<宿主机IP>:22042）。
5. 保存配置后，Eagle 设备将开始向该容器推送能源数据。

致谢

本镜像的核心逻辑和原始代码归功于 https://github.com/TD22057/T-Home 及其 T-Home 自动化软件项目。Docker 化移植及部分安全优化由 evanrich 完成。