Pi-hole
通过 AI 使用 Pi-hole 排查域名拦截、查看 DNS 活动并设置限时拦截。
在可从公网访问的 Pi-hole 实例上检查 DNS 查询、匹配名单和上游活动。也可以按指定时长调整拦截，并核对变更后的状态。
Agent 能在 Pi-hole 里做什么
按任务分组，每组列出要调用的操作。
检查域名
读取 DNS 查询，并搜索域名在允许、拦截与 gravity 列表中的记录。
- Get Queries
- Search Domain
查看 DNS 活动
读取概览与上游指标，整理 DNS 活动。
- Get Overview
- Get Upstreams
设置限时拦截
按明确时长变更拦截模式并查看状态。
- Set Dns Blocking
- Get Dns Blocking Status
可以交给 Agent 的任务
方括号里填你的内容，任务标出的其他应用也要连接。
检查域名
读取 DNS 查询，并搜索域名在允许、拦截与 gravity 列表中的记录。
查看 [域名] 的近期 DNS 查询和匹配名单，说明拦截原因。
查看 DNS 活动
读取概览与上游指标，整理 DNS 活动。
查看 Pi-hole DNS 活动和上游响应时间，汇总需要关注的情况。
设置限时拦截
按明确时长变更拦截模式并查看状态。
暂停 DNS 拦截 [时长]，随后检查拦截状态。
操作40
Pi-hole 连接器提供的全部操作，附名称和 id。
- Get Overview
get_overview获取 Pi-hole 活动概览：总查询数和被阻止查询数、被阻止查询百分比、唯一客户端和域名，以及阻止和 gravity 列表状态。 - Get Dns Blocking Status
get_dns_blocking_status获取 Pi-hole DNS 阻止当前是启用、禁用、失败还是未知。 - Set Dns Blocking
set_dns_blocking启用或禁用 Pi-hole DNS 阻止，可选择限时，之后自动恢复为相反模式。 - Get Queries
get_queries查询 Pi-hole DNS 日志，支持可选筛选条件。默认返回最近的查询；每个响应提供下一页的游标。 - Get Query Types
get_query_types获取 Pi-hole 已处理的每种 DNS 查询类型的查询数。 - Get Top Domains
get_top_domains获取 Pi-hole 处理最多的域名，可选择仅限被阻止的域名。 - Get Top Clients
get_top_clients获取查询 Pi-hole 最多的客户端，可选择仅限被阻止的客户端。 - Get Recent Blocked
get_recent_blocked获取 Pi-hole 最近阻止的域名。 - Get Upstreams
get_upstreams获取 Pi-hole DNS 上游目标的相关指标，包括响应时间。 - Get History
get_history获取 Pi-hole 活动图数据：随时间变化的查询总数，并区分缓存、被阻止和转发。 - Search Domain
search_domain搜索域名是否出现在 Pi-hole 的允许列表、阻止列表或 gravity 列表中，以了解其被阻止或允许的原因。 - Get Config
get_config获取当前 Pi-hole 配置，例如 DNS 设置、隐私级别和 API 设置。 - Update Config
update_config更改部分 Pi-hole 配置，例如 DNS 上游、隐私级别或 API 设置。提供的字段会合并到当前配置中。 - Run Gravity
run_gravity运行 Pi-hole gravity 更新以刷新阻止列表。实例流式传输 gravity 日志；操作从日志中报告尽力而为的状态以及流的尾部。 - Restart Dns
restart_dns重启 Pi-hole 的 DNS 服务器并重新加载其 DNS 配置。 - Flush Dns Logs
flush_dns_logs清空 Pi-hole DNS 查询日志。 - List Groups
list_groups列出所有 Pi-hole 组及其成员关系。 - Create Group
create_group创建一个或多个 Pi-hole 组，可选择带注释和启用状态。 - Update Group
update_group更新一个 Pi-hole 组：重命名，或更改其注释或启用状态。 - Delete Group
delete_group按名称删除一个 Pi-hole 组。
Pi-hole 怎么登录
- 登录方式
- API Key提供 Pi-hole Application Password 与公网可访问的实例 URL。
- 需要准备
- 托管 connector 可访问的公网 Pi-hole 实例，以及 Application Password。
- 说明
- 无法访问私有或本地网络地址。提供域名或查询期间；带 timer 的拦截变更会自动恢复为相反模式。