什么是Adguard
Adguard Home Controller 是一个专为 AdGuard Home DNS 服务设计的命令行管理工具，通过调用其 REST API 实现对网络广告与恶意内容过滤的精细化控制。该工具无需图形界面即可在终端中完成一系列核心操作，非常适合自动化脚本集成或远程管理场景。用户只需配置一次认证信息，便可通过简洁的命令行指令对 DNS 过滤规则进行动态调整，极大提升了家庭或小型企业网络的安全管理效率。 该工具的核心优势在于其与 AdGuard Home 原生 API 的无缝对接，支持实时查询域名是否被拦截、添加自定义黑白名单规则、查看当前防护状态及统计数据等关键功能。无论是临时放行误拦的网站，还是批量屏蔽已知追踪器或恶意域名，都能快速响应。此外，它还提供了缓存清除和防护开关等实用命令，确保规则变更能够立即生效，避免因本地缓存导致的问题延迟。 Adguard Home Controller 设计轻量且易于部署，依赖常见的 `curl` 工具运行，适用于 macOS 和 Linux 系统。它既可作为日常运维的小助手，也可嵌入到自动化流程中，例如结合定时任务定期清理缓存或更新黑名单列表。对于熟悉命令行操作的技术用户而言，这是一个高效、灵活且功能完整的 AdGuard Home 远程管控解决方案。
核心功能特点
- 通过命令行调用 AdGuard Home 的 REST API，实现无界面远程管理
- 支持检查域名是否被当前规则阻止或允许
- 可一键将域名加入白名单（允许）或黑名单（阻止）
- 实时查看 DNS 过滤统计信息，包括拦截率与各类查询数据
- 支持开启/关闭 DNS 保护功能，便于临时调试或维护
- 提供 DNS 缓存清除命令，确保规则变更即时生效
适用场景
在日常使用过程中，当某个常用网站（如银行登录页或开发测试站点）意外被 AdGuard Home 的规则误判为广告或跟踪器时，管理员可以通过 Adguard Home Controller 快速执行 `allow my-bank.com` 命令将其加入白名单，恢复访问而不影响其他安全防护。这种精准控制避免了全局规则修改的风险，特别适合需要频繁访问特定内部或第三方服务的环境。 在企业或家庭网络中，若发现新的恶意域名正在传播，管理员可以立即使用 `block malicious-tracker.xyz` 命令将其加入黑名单，有效阻止用户设备向该域名发送请求，从而防止潜在的数据泄露或恶意软件感染。结合定期更新的威胁情报源，该工具还能轻松集成到自动化脚本中，实现黑名单的动态同步与扩展。 对于网络故障排查，Adguard Home Controller 提供了 `toggle` 命令，允许临时禁用 DNS 过滤功能。这在测试新网站、排查兼容性问题或验证客户端缓存行为时尤为有用。完成排查后，再次启用保护即可恢复全面防护，整个过程无需重启设备或中断网络连接。