用途：面向运行在 Ubuntu Server 上的 AdGuard Home DNS 服务器，提供管理、排障、配置、分析与审查能力，适用于 DNS 拦截、广告拦截与全网 DNS 管理场景。
主要能力：通过 HTTP Basic Auth 调用控制 API，覆盖状态、DNS 信息、查询日志、统计、客户端、过滤状态等端点，并可清空缓存；支持查看与添加过滤列表、自定义拦截/放行/正则规则；支持客户端增改、DNS 重写、统计查看与重置；可通过 SSH 执行服务状态检查、重启、查看日志、备份与查看配置文件，以及更新 AdGuard Home。
使用方式：需先配置环境变量 ADGUARD_URL、ADGUARD_USER、ADGUARD_PASS、ADGUARD_SSH_HOST、ADGUARD_SSH_USER，并安装依赖 pip install requests paramiko，建议使用 SSH 密钥认证。常用命令如 python scripts/adguard_api.py status、querylog --limit 100 --search "blocked"、filters、add-filter、clients、add-client、rewrites、add-rewrite、stats、reset-stats；API 示例：curl -u "$ADGUARD_USER:$ADGUARD_PASS" "$ADGUARD_URL/control/status"。SSH 示例：ssh $ADGUARD_SSH_USER@$ADGUARD_SSH_HOST "systemctl status AdGuardHome"。
适用场景：排查 DNS 解析失败、客户端未使用 AdGuard Home、高延迟、拦截列表更新失败与服务启动问题；新增设备并配置自定义上游 DNS、拦截服务与家长控制；进行安全审计，如检查未知客户端、可疑域名、安全浏览与 TLS 配置及软件更新。
限制：资料未提供具体收费、价格、平台支持范围与效果数据；配置文件路径为 /opt/AdGuardHome/AdGuardHome.yaml，操作需具备服务器访问权限，部分命令需 sudo。