AdGuard Home

管理 AdGuard Home——一款全网络范围的 DNS 服务器，可为整个网络屏蔽广告、追踪器和恶意软件。

设置

1. 1. 在您的 VPS 或家庭服务器上安装 AdGuard Home
2. 为代理创建用户：设置 → AdGuard Home → 用户 → 添加用户
3. 获取您的基础 URL（例如 http://192.168.1.1:3000 或 https://your-vps.example.com）
4. 导出环境变量：

bash
export ADGUARDUSERNAME=yourusername
export ADGUARDPASSWORD=yourpassword
export ADGUARDBASEURL=http://192.168.1.1:3000

工具

status

获取 AdGuard Home 的整体状态——DNS 状态、过滤是否启用、保护级别。

bash
adguard-home-status

stats

获取过滤统计信息：总拦截数、允许数、今日查询数、拦截最多的域名。

bash
adguard-home-stats [period] # period: hour, day, week, month, year（默认：day）

blocked_domains

获取最常被拦截的域名。

bash
adguard-home-blocked-domains [limit] # 默认：20

add_rule

添加自定义 DNS 拦截规则。

bash
adguard-home-add-rule

示例：

adguard-home-add-rule example.com # 拦截单个域名

adguard-home-add-rule ||example.com^ # AdGuard 拦截语法

adguard-home-add-rule @||example.com^ # 白名单例外

remove_rule

按内容移除自定义 DNS 规则。

bash
adguard-home-remove-rule

list_rules

列出所有自定义 DNS 重写规则。

bash
adguard-home-list-rules

query_log

查询 DNS 查询日志——查找网络上解析了哪些域名。

bash
adguard-home-query-log [domain_filter] [limit]

示例：adguard-home-query-log ads 50

toggle_filtering

启用或禁用 DNS 过滤（广告拦截）。

bash
adguard-home-toggle-filtering true # 或 false

注意事项

• - AdGuard Home API：https://github.com/AdguardTeam/AdGuardHome/wiki/Config#web-interface
• 认证使用 HTTP 基本认证，用户名:密码格式
• 速率限制：避免使用过大的限制值查询 query_log
• DNS 重写规则可创建自定义 DNS 响应（A、AAAA、CNAME 记录）