How adguardteam/adguardhome works
AdGuard Home is a self-hosted DNS server for network-wide ad and tracker blocking. The principal workflow is that devices send DNS queries to the server, which applies filtering and returns a response; administrators configure policy and inspect activity through the web interface or REST API. Major documented capabilities include custom filtering, client management, DHCP, encrypted DNS, and HTTPS administration. The tree and excerpts show several UI and storage details, but not the full DNS request path, so uncertain backend connections are omitted.
Main entry points: clientshttp.go Client API · requesthandler.go DNS server · service.go Web service · index.tsx Query log view
Components 24
DNS protection
- DNS server
internal/dnsforward/requesthandler.go - Filtering rules
internal/filtering/rulelist/engine.go - DNS rewrites
internal/filtering/rewrite/storage.go - DNS upstreams
internal/client/upstreammanager.go
Administration API
- Web service
internal/home/service.go - Client API
internal/home/clientshttp.go
Web interface
- Admin interface
client_v2/src/components/App/index.tsx - API client
client/src/api/Api.ts - Query log view
client/src/components/Logs/index.tsx - Query log actions
client/src/actions/queryLogs.ts - Dashboard
client_v2/src/components/Dashboard/Dashboard.tsx - Client settings
client_v2/src/components/Clients/Clients.tsx - Filter controls
- DHCP settings
client/src/components/Settings/Dhcp/index.tsx - DNS settings
client/src/components/Settings/Dns/index.tsx
State and services
- Client registry
internal/client/storage.go - DHCP service
internal/dhcpsvc/server.go - Query log
internal/querylog/querylog.go - Log files
internal/querylog/querylogfile.go - TLS certificates
internal/aghtls/defaultmanager.go - User sessions
internal/aghuser/sessionstorage.go
Other components
- Network devices
- Administrator
- Web administrator
Connections 19
- Network devices → DNS server: send DNS queries
README.md - DNS server → Filtering rules: applies rules
- DNS server → DNS rewrites: checks rewrites
- DNS server → DNS upstreams: uses upstreams
- Administrator → Web service: configures server
README.md - Web service → Client API: serves API
- Client API → Client registry: reads and updates
internal/home/clientshttp.go - Web administrator → Admin interface: uses interface
- Admin interface → API client: uses API
- Query log view → Query log actions: dispatches actions
client/src/components/Logs/index.tsx - Query log actions → API client: requests log data
client/src/actions/queryLogs.ts - Query log view → Dashboard: reviews activity
- Client settings → Client API: manages clients
- Filter controls → Client API: configures filtering
- DHCP settings → Client API: configures DHCP
- DNS settings → Client API: configures DNS
- Query log → Log files: persists entries
- TLS certificates → Web service: supports HTTPS
- User sessions → Web service: stores sessions