ssenart/gazpar2haws Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Gazpar2HAWS Docker镜像文档

镜像概述

Gazpar2HAWS是一个数据网关工具，主要功能是从GrDF（法国燃气供应商）的燃气表读取历史数据，并通过WebSocket接口将数据发送到Home Assistant智能家居系统。该工具特别优化了与Home Assistant能源仪表板的兼容性，支持历史数据上传及实时读数更新，帮助用户实现燃气使用数据的集中监控与管理。

项目GitHub仓库：[***]

核心功能和特性

• 数据读取：从GrDF燃气表获取历史用气数据
• 数据传输：通过WebSocket接口将数据实时发送至Home Assistant
• 能源仪表板兼容：完美适配Home Assistant能源仪表板，支持数据可视化展示
• 历史与实时结合：支持历史数据批量上传及最新读数实时更新
• 自动化集成：可与Home Assistant的自动化规则联动，实现能源使用监控与告警

使用场景和适用范围

• 家庭能源监控：适用于使用GrDF燃气表的家庭用户，需将燃气使用数据集成到Home Assistant系统
• 能源管理分析：通过Home Assistant能源仪表板分析燃气消耗趋势，优化能源使用
• 智能家居联动：结合其他智能家居设备，实现基于燃气使用数据的自动化控制（如节能提醒、异常用气告警等）

使用方法和配置说明

环境变量配置

使用该镜像需配置以下必要环境变量：

Docker运行示例

bash
docker run -d \
  --name gazpar2haws \
  -e GRDF_USERNAME="user@example.com" \
  -e GRDF_PASSWORD="your_secure_password" \
  -e HA_WEBSOCKET_URL="ws://homeassistant:8123/api/websocket" \
  -e HA_TOKEN="your_home_assistant_token" \
  ssenart/gazpar2haws:latest

Docker Compose配置示例

yaml
version: '3'
services:
  gazpar2haws:
    image: ssenart/gazpar2haws:latest
    container_name: gazpar2haws
    environment:
      - GRDF_USERNAME=user@example.com
      - GRDF_PASSWORD=your_secure_password
      - HA_WEBSOCKET_URL=ws://homeassistant:8123/api/websocket
      - HA_TOKEN=your_home_assistant_token
    restart: unless-stopped

注意事项

1. 确保Home Assistant已启用WebSocket API，并生成具有足够权限的访问令牌
2. GrDF账户需正常激活并能通过官方渠道访问燃气表数据
3. 首次运行时，工具会同步历史数据，可能需要几分钟时间完成初始数据上传
4. 如需调整数据同步频率，可通过项目GitHub仓库获取配置文件自定义说明