Pi-hole广告拦截

技能简介

通过Pi-hole v6 API远程控制DNS广告屏蔽器，支持查看状态、开关过滤、临时禁用及查询统计。

能做什么

• 获取Pi-hole运行状态和实时统计
• 开启或关闭广告过滤功能
• 按指定时长临时禁用过滤
• 查看近期被拦截的域名记录

使用说明

安装配置

在Clawdbot配置文件中添加：

skills:
  entries:
    pihole:
      apiUrl: "https://pi-hole.local/api"
      apiToken: "your-app-password-here"
      insecure: false

或通过环境变量设置：

export PIHOLE_API_URL="https://pi-hole.local/api"
export PIHOLE_API_TOKEN="your-app-password-here"
export PIHOLE_INSECURE="false"

获取API凭证：登录Pi-hole Admin → 设置 → API → 生成应用密码。

常用指令

# 检查状态
"pihole status"

# 关闭广告过滤
"pihole off"

# 开启广告过滤
"pihole on"

# 临时禁用5分钟
"pihole disable 5m"

# 查看最近30分钟拦截记录
"pihole blocked"

# 显示统计信息
"pihole stats"

输入与输出

见下方输入与输出表格。

风险提示

• 会话令牌30分钟后过期，需重新认证
• 自签名证书需设置insecure为true
• Pi-hole v6 API不再支持通过API添加白名单
• 确保网络可访问Pi-hole服务器

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/baanish/pihole/SKILL.md
来源类型：GitHub仓库