webdevops/shelly-plug-exporter

Shelly智能插座Prometheus导出器镜像

概述

本Docker镜像提供Shelly智能插座的Prometheus导出器功能，能够从Shelly设备采集关键运行指标（如功率、电压、电流、能耗、开关状态等），并通过Prometheus兼容的HTTP接口暴露指标，便于集成到监控系统中进行数据采集与分析。

核心功能与特性

• 多维度指标采集：支持功率（W）、电压（V）、电流（A）、累计能耗（kWh）、开关状态（开/关）、设备在线状态等指标
• Prometheus兼容接口：通过标准/metrics端点暴露指标，可直接被Prometheus服务器抓取
• 设备兼容性：支持主流Shelly智能插座型号（Shelly 1PM、Shelly Plug S、Shelly Plus Plug S等）
• 灵活配置：支持通过环境变量自定义设备IP列表、扫描间隔、监听端口等参数
• 轻量级设计：基于Alpine基础镜像构建，资源占用低，适合嵌入式环境或边缘设备部署

使用场景

• 家庭/办公智能插座监控：实时跟踪设备开关状态及运行参数
• 能源管理系统：统计特定设备或区域的电力消耗，优化能源分配
• 自动化告警：结合Prometheus Alertmanager实现设备异常（如过载、离线）告警
• 数据可视化：对接Grafana生成能耗趋势图表，辅助能源分析决策

使用方法

快速启动（docker run）

bash
docker run -d \
  --name shelly-exporter \
  -p 9236:9236 \
  -e SHELLY_DEVICES="192.168.1.100,192.168.1.101" \
  -e SCAN_INTERVAL=30 \
  prometheus-shelly-exporter:latest

环境变量配置

指标访问与示例

容器启动后，通过http://<容器IP>:<LISTEN_PORT>/metrics访问指标，示例输出：

shelly_power_w{device="shelly-plug-s-abc123",channel="0"} 15.2
shelly_voltage_v{device="shelly-plug-s-abc123",channel="0"} 228.5
shelly_current_a{device="shelly-plug-s-abc123",channel="0"} 0.067
shelly_energy_kwh{device="shelly-plug-s-abc123",channel="0"} 2.35
shelly_switch_state{device="shelly-plug-s-abc123",channel="0"} 1
shelly_device_online{device="shelly-plug-s-abc123"} 1

docker-compose配置示例

yaml
version: '3.8'
services:
  shelly-exporter:
    image: prometheus-shelly-exporter:latest
    container_name: shelly-exporter
    ports:
      - "9236:9236"
    environment:
      - SHELLY_DEVICES=192.168.1.100,192.168.1.102,192.168.1.105
      - SCAN_INTERVAL=20
      - LISTEN_PORT=9236
      - REQUEST_TIMEOUT=10
    restart: unless-stopped

支持的Shelly设备型号

• Shelly 1PM
• Shelly 2.5（继电器模式）
• Shelly Plug S
• Shelly Plus Plug S
• Shelly Plug US/UK
• Shelly Pro 1PM

注意事项

• 确保容器与Shelly设备网络互通，设备需开启HTTP API（默认开启，无需额外配置）
• 旧型号设备可能需要升级固件至v1.9.0+以支持完整指标返回
• 设备数量超过5台时建议增大SCAN_INTERVAL至60秒以上，避免网络请求冲突