chhaley/tplink_smartplug_exporter

tplink_smartplug_exporter

Prometheus Exporter for TP-Link Smart Plugs，用于采集TP-Link智能插头的用电指标并暴露给Prometheus监控系统。

镜像概述

该镜像提供了一个Prometheus Exporter，能够连接TP-Link智能插头（如HS1X系列），收集电流、电压、功率和总电量等关键指标，并通过HTTP接口暴露这些指标供Prometheus抓取。

核心功能

• 采集智能插头的电流（毫安）、电压（毫伏）、功率（毫瓦）及总电量（瓦时）指标
• 支持多个智能插头的批量监控（通过环境变量配置）
• 暴露标准Prometheus指标接口，便于集成到现有监控体系

使用场景

• 家庭环境中监控智能设备的用电情况
• 小型办公场所对智能插头的能耗进行统计分析
• 集成到Prometheus+Grafana系统中实现用电数据可视化与异常告警

配置说明

• 环境变量：HS1X_HOSTS，格式为逗号分隔的"IP:端口"列表，指定需监控的智能插头地址（默认端口为9999）
• 监听端口：默认9784（Exporter暴露指标的端口）

部署示例

Docker部署

bash
docker run -d \
    -e HS1X_HOSTS='192.168.1.156:9999,192.168.1.159:9999' \
    --network host \
    --name tplink_smartplug_exporter \
    chhaley/tplink_smartplug_exporter

Helm部署

bash
helm repo add charlie-haley https://charlie-haley.github.io/private-charts
helm repo update
helm install tplink-smartplug-exporter charlie-haley/tplink-smartplug-exporter --set "hs1xHosts={192.168.1.156:9999,192.168.1.159:9999}" -n monitoring

若需使用ServiceMonitor（默认启用），需确保集群已部署https://github.com/prometheus-operator/prometheus-operator%EF%BC%9B%E5%A6%82%E9%9C%80%E7%A6%81%E7%94%A8ServiceMonitor%E6%94%B9%E7%94%A8Ingress%EF%BC%8C%E5%8F%AF%E5%8F%82%E8%80%83values.yaml%E8%B0%83%E6%95%B4%E9%85%8D%E7%BD%AE%E3%80%82 ===END===