How dnscrypt/dnscrypt-proxy works
dnscrypt-proxy is a configurable encrypted DNS proxy. A client query enters the proxy, passes through query processing and configured policy plugins, is resolved through an encrypted DNS protocol and selected resolver, then returns to the client; logging and monitoring expose activity. The README documents additional filtering, resolver updates, load balancing, anonymization, and local DoH capabilities. Some subsystem links are documented only at the product level, so those edges are dashed; source-level edges are limited to the excerpts shown.
Main entry points: query_processing.go Query Processing · plugins.go Plugin Dispatch · proxy.go DNS Proxy · main.go Application Startup
Components 22
Proxy Runtime
- Application Startup
dnscrypt-proxy/main.go - Configuration
dnscrypt-proxy/config_loader.go - DNS Proxy
dnscrypt-proxy/proxy.go - Query Processing
dnscrypt-proxy/query_processing.go
Encrypted DNS
- HTTP Transport
dnscrypt-proxy/xtransport.go - DNSCrypt Crypto
dnscrypt-proxy/crypto.go - Post-Quantum
dnscrypt-proxy/pq.go - Oblivious DoH
dnscrypt-proxy/oblivious_doh.go - Local DoH
dnscrypt-proxy/local-doh.go
Query Policy
- Plugin Dispatch
dnscrypt-proxy/plugins.go - Cloaking Rules
dnscrypt-proxy/plugin_cloak.go - Resolver Forwarding
dnscrypt-proxy/plugin_forward.go - DNS Filtering
dnscrypt-proxy/plugin_block_name.go - DNS Cache
dnscrypt-proxy/plugin_cache.go - Time Filtering
dnscrypt-proxy/time_ranges.go
Resolver Discovery
- Resolver Selection
dnscrypt-proxy/serversInfo.go - Resolver Sources
dnscrypt-proxy/sources.go - Blocklist Generator
utils/generate-domains-blocklist/generate-domains-blocklist.py
Monitoring
- Query Logging
dnscrypt-proxy/plugin_query_log.go - Monitoring UI
dnscrypt-proxy/monitoring_ui.go - Dashboard Client
dnscrypt-proxy/static/js/monitoring.js
Other components
- DNS Client
Connections 22
- DNS Client → DNS Proxy: sends query
- Application Startup → Configuration: loads config
dnscrypt-proxy/main.go - Application Startup → DNS Proxy: starts proxy
dnscrypt-proxy/main.go - DNS Proxy → Query Processing: processes query
- Query Processing → DNS Proxy: exchanges queries
dnscrypt-proxy/query_processing.go - Query Processing → Plugin Dispatch: applies logging
dnscrypt-proxy/query_processing.go - Plugin Dispatch → DNS Filtering: dispatches filters
- Plugin Dispatch → Cloaking Rules: dispatches cloaking
- Plugin Dispatch → DNS Cache: dispatches cache
- Plugin Dispatch → Time Filtering: applies schedules
- Plugin Dispatch → Resolver Forwarding: forwards queries
- Resolver Forwarding → Resolver Selection: selects resolver
- Resolver Selection → Resolver Sources: updates resolver lists
- Blocklist Generator → DNS Filtering: generates blocklists
- Query Processing → HTTP Transport: sends DoH
- Query Processing → DNSCrypt Crypto: encrypts DNSCrypt
- DNSCrypt Crypto → Post-Quantum: supports PQ
- Query Processing → Oblivious DoH: handles ODoH
dnscrypt-proxy/query_processing.go - Query Processing → Local DoH: serves local DoH
- DNS Proxy → Query Logging: records queries
- DNS Proxy → Monitoring UI: exposes monitoring
- Dashboard Client → Monitoring UI: requests metrics