- name
- adguard-home
- description
- Manage AdGuard Home network-wide DNS ad blocking. Query blocklist stats, add/remove custom DNS rules, check filtering status, and view top blocked domains from your self-hosted DNS server.
- version
- 1.0.0
- metadata
- openclaw
- requires
- env
- bins
- primaryEnv
- ADGUARD_PASSWORD
- emoji
- 🛡️
- homepage
- https://github.com/Adguard/AdGuardHome
AdGuard Home
Manage AdGuard Home — the network-wide DNS server that blocks ads, trackers, and malware for your entire network.
Setup
- Install AdGuard Home on your VPS or home server
- Create a user for the agent: Settings → AdGuard Home → Users → Add User
- Get your base URL (e.g.
http://192.168.1.1:3000orhttps://your-vps.example.com) - Export env vars:
export ADGUARD_USERNAME=your_username
export ADGUARD_PASSWORD=your_password
export ADGUARD_BASE_URL=http://192.168.1.1:3000Tools
status
Get overall AdGuard Home status — DNS status, filtering enabled, protection level.
adguard-home-statusstats
Get filtering statistics: total blocked, allowed, queries today, top blocked domains.
adguard-home-stats [period] # period: hour, day, week, month, year (default: day)blocked_domains
Get the most frequently blocked domains.
adguard-home-blocked-domains [limit] # default: 20add_rule
Add a custom DNS blocking rule.
adguard-home-add-rule "<domain or rule>"
# Examples:
# adguard-home-add-rule "example.com" # block single domain
# adguard-home-add-rule "||example.com^" # AdGuard blocking syntax
# adguard-home-add-rule "@||example.com^" # allowlist exceptionremove_rule
Remove a custom DNS rule by content.
adguard-home-remove-rule "<rule>"list_rules
List all custom DNS rewrite rules.
adguard-home-list-rulesquery_log
Query the DNS query log — find what domains were resolved on the network.
adguard-home-query-log [domain_filter] [limit]
# Example: adguard-home-query-log "ads" 50toggle_filtering
Enable or disable DNS filtering (ad blocking).
adguard-home-toggle-filtering true # or falseNotes
- AdGuard Home API:
https://github.com/AdguardTeam/AdGuardHome/wiki/Config#web-interface - Authentication uses HTTP Basic Auth with username:password
- Rate limiting: avoid querying the query_log with very large limits
- DNS rewrite rules can create custom DNS responses (A, AAAA, CNAME records)