AdGuard DNS管理

技能简介

通过HTTP API远程控制AdGuard Home的DNS过滤功能，支持管理黑白名单、查询域名过滤状态、切换防护开关及清理DNS缓存。

业务背景

企业网络管理员可通过统一入口远程管控AdGuard DNS过滤策略，无需登录多台设备。快速排查员工访问异常、灵活调整域名黑白名单、一键切换全网防护状态，确保办公网络安全合规，同时减少IT运维的重复操作成本。

落地案例：某企业员工反馈无法访问合作方官网，IT人员在控制台输入域名执行check指令，秒级确认该域被误拦；随即使用allow指令加入白名单，并触发cache-clear使规则即时生效，全程无需远程连接网关设备，5分钟内恢复业务访问。

能做什么

• 检查指定域名是否被拦截或放行
• 将域名加入白名单（允许访问）
• 将域名加入黑名单（阻止访问）
• 查看DNS查询统计与防护状态
• 启用或禁用DNS过滤保护
• 清空DNS缓存使规则立即生效

使用说明

安装准备

1. 确保AdGuard Home已运行并开启Web界面
2. 确认拥有管理员账号密码
3. 系统需预装curl（macOS/Linux默认包含）

配置环境变量

export ADGUARD_URL="http://192.168.1.100:3000"
export ADGUARD_USERNAME="admin"
export ADGUARD_PASSWORD="your_admin_password"

将上述命令写入~/.bashrc或~/.zshrc可持久化配置。也可创建~/.adguard/config.json存储URL和用户名，密码单独设置。

常用命令

# 查看状态
./adguard.sh status

# 检查域名
./adguard.sh check example.com

# 允许域名
./adguard.sh allow broken-site.com

# 阻止域名
./adguard.sh block malware.ru

# 切换防护开关
./adguard.sh toggle

# 清理缓存
./adguard.sh cache-clear

输入与输出

见下方输入与输出表格。

风险提示

• 错误配置可能导致误拦正常网站或放行恶意域名
• 关闭DNS保护会使网络暴露于钓鱼和跟踪风险
• 管理员密码泄露可导致过滤规则被恶意篡改
• 批量操作前建议先单条测试验证效果

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rowbotik/adguard/SKILL.md
来源类型：开源项目文档