bradreardon/pihole-influx

pihole-influx

一个后台运行的脚本，用于将Pi-Hole的统计数据上报至InfluxDB，以便通过Grafana展示可视化仪表盘。

!示例Grafana仪表盘

镜像概述

本镜像提供自动化工具，定期从Pihole API获取广告拦截、DNS查询等统计数据，并写入InfluxDB数据库，为Grafana构建数据可视化仪表盘提供支持。

核心功能

1. 定期采集Pihole API数据（默认每10秒一次）
2. 将数据写入指定InfluxDB实例
3. 通过环境变量自定义配置参数（Pihole地址、InfluxDB连接信息等）
4. 兼容Grafana仪表盘导入（支持ID 6603或本地JSON文件）

使用场景

• Pihole用户监控广告拦截效果、DNS查询量等关键指标
• 通过可视化仪表盘直观展示网络过滤数据
• 长期存储Pihole统计数据用于趋势分析

配置说明

容器通过环境变量配置，关键参数如下：

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name pihole-influx \
  -e PIHOLE_HOSTNAME="my-pihole" \
  -e PIHOLE_API="http://pihole.local/admin/api.php" \
  -e INFLUX_HOST="influxdb.local" \
  -e INFLUX_DB="pihole_stats" \
  -e INFLUX_USER="admin" \
  -e INFLUX_PASSWORD="your_password" \
  docker.xuanyuan.run/bradreardon/pihole-influx

Docker Compose示例

yaml
version: '3'
services:
  pihole-influx:
    image: docker.xuanyuan.run/bradreardon/pihole-influx
    environment:
      PIHOLE_HOSTNAME: "my-pihole"
      PIHOLE_API: "http://pihole:80/admin/api.php"
      REPORTING_INTERVAL: 10
      INFLUX_HOST: "influxdb"
      INFLUX_PORT: 8086
      INFLUX_USER: "admin"
      INFLUX_PASSWORD: "your_password"
      INFLUX_DB: "pihole_stats"
    depends_on:
      - influxdb
  influxdb:
    image: docker.xuanyuan.run/influxdb:1.8
    environment:
      INFLUXDB_DB: "pihole_stats"
      INFLUXDB_ADMIN_USER: "admin"
      INFLUXDB_ADMIN_PASSWORD: "your_password"
    volumes:
      - influxdb_data:/var/lib/influxdb
volumes:
  influxdb_data:

Grafana仪表盘设置

示例仪表盘可通过以下方式导入：

1. 使用仓库中的dashboard.json文件导入
2. 通过Grafana仪表盘目录导入，ID为6603（https://grafana.com/dashboards/6603%EF%BC%89

致谢

引用自分叉仓库janw/pi-hole-influx的README：

脚本最初由Jon Hayward创建，2016年12月由/u/tollsjo改编支持InfluxDB，后由@johnappletree改进扩展。"如果我看得更远，那是因为我站在巨人的肩膀上"。🤓
由Brad Reardon进一步修改以支持Docker部署。