bastgau/ha-pi-hole-v6

说明与用途

**项目简介（2‑3 句）**
bastgau/ha-pi-hole-v6 是一套为 Home Assistant 定制的 Pi‑hole 集成，弥补了官方集成已失效的兼容性，并在此基础上提供了日志、统计、黑名单管理等额外功能。

**价值**

• **恢复并扩展兼容性**：在官方集成不再维护的情况下，仍能让 Home Assistant 实时监控和控制 Pi‑hole。
• **功能增强**：支持查询详细查询日志、按设备/域名过滤、批量添加/删除黑白名单等，帮助用户更精细地管理网络广告拦截。
• **开箱即用**：基于 Python 编写，遵循 Home Assistant 的自定义集成规范，易于在已有 HA 环境中直接部署。

**典型接入方式**

1. **准备工作**：确保 Pi‑hole 已开启 API（在 Pi‑hole 控制面板 → Settings → API / Web interface），记录 API Token。
2. **在 Home Assistant 中添加自定义组件**：

• 将仓库克隆或下载的 custom_components/pi_hole_v6 文件夹放入 HA 配置目录的 custom_components/ 下。
• 在 configuration.yaml 中加入：

     pi_hole_v6:
       host: http://<pi-hole-ip>
       api_token: YOUR_API_TOKEN
       scan_interval: 30  # 可选，刷新间隔（秒）

1. **重启 Home Assistant**，集成会自动创建实体（如 sensor.pi_hole_ads_blocked、binary_sensor.pi_hole_status）以及服务（pi_hole_v6.add_blacklist、pi_hole_v6.remove_blacklist）。
2. **在 Lovelace 中使用**：将生成的传感器、开关或自定义卡片拖入仪表盘，即可实时查看拦截统计并通过 UI 管理名单。

**生产可用性**

• **成熟度**：已有 496 ★、17 Fork，最近一次提交在 2026‑07‑03，活跃度仍在，代码质量符合 Home Assistant 自定义集成的基本要求。
• **适用场景**：适合内部原型、家庭或小型企业网络的监控与自动化；在对稳定性要求不极端的生产环境中使用是可行的。
• **风险与注意事项**：
• 仍需自行审查许可证（MIT/Apache 等）以及潜在的安全依赖。
• 建议在正式部署前先在测试环境验证 API 权限、网络连通性以及异常恢复流程。
• 关注上游仓库的后续更新或社区 Fork，以防止未来因依赖停更导致的兼容性问题。

综上，bastgau/ha-pi-hole-v6 能快速为 Home Assistant 带来完整的 Pi‑hole 监控与管理能力，适合作为原型或内部工具使用；在完成安全审计和小规模验证后，也可进入生产环境。

实际用途

bastgau/ha-pi-hole-v6 may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.