datoma/pihole-exporter
datoma
PI-Hole Prometheus Exporter是用于将Raspberry PI广告拦截器PI-Hole的运行数据导出到Prometheus的工具，支持监控广告拦截数量、DNS查询统计等关键指标，可与Grafana集成展示详细数据面板。
下载次数: 0状态：社区镜像维护者：datoma仓库类型：镜像最近更新：4 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
PI-Hole Prometheus Exporter
!https://github.com/eko/pihole-exporter/workflows/Build/Push%20(master/badge.svg) ![GoDoc]([] ![GoReportCard]([]
镜像概述和主要用途
PI-Hole Prometheus Exporter是一个Prometheus导出器，专为PI-Hole（Raspberry PI广告拦截器）设计。它能够从PI-Hole收集关键运行指标并导出到Prometheus，以便进行监控和数据分析。配合Grafana可实现直观的数据可视化。
!https://raw.githubusercontent.com/eko/pihole-exporter/master/dashboard.jpg
Grafana仪表盘可在Grafana官网获取，也可从GitHub仓库https://raw.githubusercontent.com/eko/pihole-exporter/master/grafana/dashboard.json%E3%80%82
核心功能和特性
- 导出PI-Hole关键运行指标，包括被阻止的域名数量、DNS查询总数、广告拦截数等
- 支持通过密码或API令牌（PI-Hole的
WEBPASSWORD）进行身份验证 - 可配置数据采集间隔和导出器端口
- 支持HTTP和HTTPS协议连接PI-Hole
- 提供丰富的Prometheus指标，便于监控和告警配置
使用场景和适用范围
适用于所有使用PI-Hole作为广告拦截器的环境，尤其是需要对PI-Hole运行状态进行持续监控的场景：
- 家庭网络环境中监控广告拦截效果
- 小型企业网络中跟踪DNS查询和广告拦截统计
- 与Prometheus+Grafana集成构建网络监控平台
使用方法和配置说明
Docker部署示例
基本部署（使用密码）
bashdocker run \ -e 'PIHOLE_HOSTNAME=192.168.1.2' \ -e 'PIHOLE_PASSWORD=mypassword' \ -e 'INTERVAL=30s' \ -e 'PORT=9617' \ -p 9617:9617 \ ekofr/pihole-exporter:latest
使用API令牌（推荐）
通过PI-Hole的WEBPASSWORD作为API令牌（位于/etc/pihole/setupVars.conf）：
bashAPI_TOKEN=$(awk -F= -v key="WEBPASSWORD" '$1==key {print $2}' /etc/pihole/setupVars.conf) docker run \ -e 'PIHOLE_HOSTNAME=192.168.1.2' \ -e "PIHOLE_API_TOKEN=$API_TOKEN" \ -e 'INTERVAL=30s' \ -e 'PORT=9617' \ -p 9617:9617 \ ekofr/pihole-exporter:latest
HTTPS连接PI-Hole
当PI-Hole启用HTTPS时，需指定协议并挂载SSL证书：
bashdocker run \ -e 'PIHOLE_PROTOCOL=https' \ -e 'PIHOLE_HOSTNAME=192.168.1.2' \ -e 'PIHOLE_PASSWORD=mypassword' \ -e 'INTERVAL=30s' \ -e 'PORT=9617' \ -v '/etc/ssl/certs:/etc/ssl/certs:ro' \ -p 9617:9617 \ ekofr/pihole-exporter:latest
环境变量配置
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| PIHOLE_HOSTNAME | PI-Hole所在的主机名或IP地址 | 127.0.0.1 |
| PIHOLE_PASSWORD | PI-Hole管理界面密码 | 无 |
| PIHOLE_API_TOKEN | PI-Hole的WEBPASSWORD（API令牌），替代密码使用 | 无 |
| PIHOLE_PROTOCOL | 连接PI-Hole的协议（http或https） | http |
| INTERVAL | 数据采集间隔（如30s、5m） | 10s |
| PORT | 导出器监听端口 | 9617 |
Prometheus配置
在Prometheus配置文件（prometheus.yml）中添加如下 scrape 配置：
yamlscrape_configs: - job_name: 'pihole' static_configs: - targets: ['localhost:9617'] # 替换为导出器实际地址
可用Prometheus指标
| 指标名称 | 描述 |
|---|---|
| pihole_domains_being_blocked | 被阻止的域名数量 |
| pihole_dns_queries_today | 当日DNS查询总数 |
| pihole_ads_blocked_today | 当日广告拦截数量 |
| pihole_ads_percentage_today | 当日广告拦截百分比 |
| pihole_unique_domains | 唯一域名数量 |
| pihole_queries_forwarded | 转发的查询数量 |
| pihole_queries_cached | 缓存的查询数量 |
| pihole_clients_ever_seen | 曾连接的客户端数量 |
| pihole_unique_clients | 唯一客户端数量 |
| pihole_dns_queries_all_types | 所有类型的DNS查询总数 |
| pihole_reply | 各类回复数量 |
| pihole_top_queries | 按域名统计的热门查询数量 |
| pihole_top_ads | 按域名统计的热门广告数量 |
| pihole_top_sources | 按源主机统计的热门请求来源数量 |
| pihole_forward_destinations | 按目标统计的转发请求数量 |
| pihole_querytypes | 按类型统计的查询数量 |
| pihole_status | PI-Hole运行状态（1表示启用，0表示禁用） |
Helm Chart部署
可通过https://github.com/SiM22/pihole-exporter-helm-chart%E5%9C%A8Kubernetes%E9%9B%86%E7%BE%A4%E4%B8%AD%E9%83%A8%E7%BD%B2%E8%AF%A5%E5%AF%BC%E5%87%BA%E5%99%A8%E3%80%82
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 pihole-exporter 镜像标签
docker pull docker.xuanyuan.run/datoma/pihole-exporter:<标签>
DockerHub 原生拉取命令
docker pull datoma/pihole-exporter:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"