Overview
dnscrypt-proxy is a local DNS forwarder that can encrypt queries before they leave your machine or network. It is useful on Linux, macOS, Raspberry Pi, or behind tools such as Pi-hole when you want encrypted upstream DNS without depending on browser settings.
HostuxDNS exposes encrypted resolvers compatible with dnscrypt-proxy via DNS stamps. The examples below use DoQ and declare the servers statically, so the setup works even if the public resolver list does not include HostuxDNS.
Declare HostuxDNS static servers
Open dnscrypt-proxy.toml and add the following block in the [static]
section:
[static.'hostuxdns-front1-v4']
stamp = 'sdns://BAcAAAAAAAAAEjQ2LjIyNi4xMDguMTczOjg1MwAOZG5zLmhvc3R1eC5uZXQ'
[static.'hostuxdns-front1-v6']
stamp = 'sdns://BAcAAAAAAAAAKVsyMDAxOjRiOTg6ZGMyOjQxOjIxNjozZWZmOmZlMTY6MTA4MF06ODUzAA5kbnMuaG9zdHV4Lm5ldA'
[static.'hostuxdns-front2-v4']
stamp = 'sdns://BAcAAAAAAAAAETQ2LjIyNi4xMDkuODI6ODUzAA5kbnMuaG9zdHV4Lm5ldA'
[static.'hostuxdns-front2-v6']
stamp = 'sdns://BAcAAAAAAAAAKVsyMDAxOjRiOTg6ZGMyOjQxOjIxNjozZWZmOmZlY2U6M2U1NV06ODUzAA5kbnMuaG9zdHV4Lm5ldA'
These four entries cover both HostuxDNS frontends over IPv4 and IPv6.
Enable the servers in the main configuration
In the main section of the same file, set:
server_names = ['hostuxdns-front1-v4', 'hostuxdns-front1-v6', 'hostuxdns-front2-v4', 'hostuxdns-front2-v6']
If you use dnscrypt-proxy as a local upstream for another service, keep the default local listener or set one explicitly, for example:
listen_addresses = ['127.0.0.1:5053']
Tools such as Pi-hole can then forward queries to 127.0.0.1:5053.
Restart and verify
Restart the service after saving the file:
systemctl restart dnscrypt-proxy
Then test local resolution:
dig @127.0.0.1 -p 5053 example.com
You can also test the upstream directly with Knot DNS:
kdig @dns.hostux.net example.com +quic
If the local query works, your applications can use dnscrypt-proxy as their local DNS resolver while HostuxDNS handles the encrypted upstream hop.
Notes
- Resolver list
- Static stamps are the most reliable option when you want to pin a specific upstream and avoid depending on the public source list.
- Ad blocking
- The
/adsHostuxDNS filtering endpoint is a DoH path and is not exposed through the DoQ stamps shown here. - Official documentation
- dnscrypt-proxy documentation