（1688期）Pi-hole Control – DNS 级广告拦截智能控制台

DNS 级广告拦截智能控制台 通过 Pi-hole v6 API 远程控制 DNS 广告拦截器，支持状态查看、启停控制、临时禁用及阻断分析，适合家庭网络管理员。 使用说明 核心用法 Pi-hole Skill 是一个用于远程管理 Pi-hole DNS 广告拦截器的工具，基于 Pi-hole v6 API 构建。用户可通过自然语言指令控制广告过滤的启停、查看实时统计、分析被阻断的域名，并支持临时禁用功能以应对特定网站的广告依赖需求。 主要功能模块： 状态监控：实时查看 Pi-hole 运行状态、今日查询量、已阻断查询数、活跃客户端数及阻断域名库规模 开关控制：完全启用或禁用广告过滤，支持自定义时长的临时禁用（如 5 分钟或 30 分钟） 阻断分析：查看指定时间窗口内的被阻断域名，识别高频阻断的目标 配置需提供 Pi-hole v6 的 API 端点地址和应用密码，支持通过 YAML 配置文件或环境变量注入。v6 API 采用会话认证机制，token 有效期 30 分钟，相比 v5 的 URL 参数认证更安全。 显著优点 会话安全机制：v6 API 将会话 token 置于请求头而非 URL，避免敏感信息泄露于日志或进程列表 灵活的临时控制：支持精确到分钟的临时禁用，解决"某些网站需要广告才能正常访问"的实际痛点 网络级广告拦截：作用于 DNS 层，为整个局域网所有设备提供统一保护，无需逐设备配置 详尽的遥测数据：提供查询总量、阻断率、活跃客户端等多维度统计，便于网络健康度评估 潜在缺点与局限性 API 功能阉割：Pi-hole v6 移除了通过 API 管理白名单的能力，用户必须登录 Admin UI 手动添加例外域名，破坏了纯 CLI 工作流。 依赖网络可达性：要求运行环境能直连 Pi-hole 主机，跨网络或容器隔离场景需额外配置。 无图形界面：纯文本交互对非技术用户存在门槛，错误信息（如认证失败）依赖用户自行排查日志。 自签名证书处理：本地部署常用自签名 HTTPS 证书，需显式开启 insecure: true，削弱 TLS 安全保证。 适合人群 家庭网络管理员：需要为全屋设备统一管控广告过滤的技术爱好者 智能家居用户：已将 Pi-hole 集成至 Home Assistant 等生态，希望扩展语音/聊天控制入口 隐私敏感用户：希望实时监控网络请求阻断情况，审计潜在跟踪域名 开发与测试人员：需要临时禁用过滤以验证广告相关功能的开发者 常规风险 | 风险类别 | 具体描述 | 缓解建议 ||---------|---------|---------|| 认证泄露 | API 密码以明文存储于配置文件或环境变量 | 限制配置文件权限，避免提交至版本控制 || 中间人攻击 | insecure: true 跳过证书验证 | 生产环境使用有效证书，仅内网测试开启此选项 || 会话劫持 | 30 分钟有效期的会话 token 若被截获可被复用 | 在可信网络运行，避免公共 WiFi 环境 || 服务拒绝 | 恶意或误操作频繁切换过滤状态，影响网络可用性 | 设置合理的禁用时长上限，避免无限期关闭 || 信息暴露 | pihole stats 输出可能包含敏感的网络使用模式 | 注意对话历史的管理，避免在共享环境暴露 | 总体而言，这是一个面向特定技术圈层的实用工具，在正确配置和网络安全边界内使用风险可控。 原始说明 Control Pi-hole v6 DNS ad blocker: check status, view stats, enable/disable block, and analyze blocked domains via API.