pi-hole:setting_up_pi-hole_as_a_recursive_dns_server
This is an old revision of the document!
Table of Contents
Pi-Hole - Setting up Pi-hole as a recursive DNS server
Unbound will be used.
NOTE: This assumes Pi-hole is already setup.
Install Unbound
Install the recursive DNS resolver
sudo apt update sudo apt install unbound
Configure Unbound
- /etc/unbound/unbound.conf.d/pi-hole.conf
server: # If no logfile is specified, syslog is used # logfile: "/var/log/unbound/unbound.log" verbosity: 0 interface: 127.0.0.1 port: 5335 do-ip4: yes do-udp: yes do-tcp: yes # May be set to yes if you have IPv6 connectivity do-ip6: no # You want to leave this to no unless you have *native* IPv6. With 6to4 and # Terredo tunnels your web browser should favor IPv4 for the same reasons prefer-ip6: no # Use this only when you downloaded the list of primary root servers! # If you use the default dns-root-data package, unbound will find it automatically #root-hints: "/var/lib/unbound/root.hints" # Trust glue only if it is within the server's authority harden-glue: yes # Require DNSSEC data for trust-anchored zones, if such data is absent, the zone becomes BOGUS harden-dnssec-stripped: yes # Don't use Capitalization randomization as it known to cause DNSSEC issues sometimes # see https://discourse.pi-hole.net/t/unbound-stubby-or-dnscrypt-proxy/9378 for further details use-caps-for-id: no # Reduce EDNS reassembly buffer size. # Suggested by the unbound man page to reduce fragmentation reassembly problems edns-buffer-size: 1472 # Perform prefetching of close to expired message cache entries # This only applies to domains that have been frequently queried prefetch: yes # One thread should be sufficient, can be increased on beefy machines. In reality for most users running on small networks or on a single machine, it should be unnecessary to seek performance enhancement by increasing num-threads above 1. num-threads: 1 # Ensure kernel buffer is large enough to not lose messages in traffic spikes so-rcvbuf: 1m # Ensure privacy of local IP ranges private-address: 192.168.0.0/16 private-address: 169.254.0.0/16 private-address: 172.16.0.0/12 private-address: 10.0.0.0/8 private-address: fd00::/8 private-address: fe80::/10
NOTE: Unbound will listen on port 5335.
Restart Unbound
sudo service unbound restart
Test that Unbound can resolve
dig pi-hole.net @127.0.0.1 -p 5335
NOTE: The first query may be quite slow, but subsequent queries should be faster due to caching.
Test DNSSEC validation
dig sigfail.verteiltesysteme.net @127.0.0.1 -p 5335 dig sigok.verteiltesysteme.net @127.0.0.1 -p 5335
NOTE:
- The first command should give a status report of SERVFAIL and no IP address.
- The second should give NOERROR plus an IP address.
Configure Pi-hole
Navigate to Tools → Settings → DNS.
In Upstream DNS Servers:
- Untick any pre-defined servers.
- Change the Custom 1 (IPv4) to 127.0.0.1#5335.
- Click Save.
NOTE: Pi-Hole should now be passing requests via Unbound.
References
pi-hole/setting_up_pi-hole_as_a_recursive_dns_server.1611863140.txt.gz · Last modified: 2021/01/28 19:45 by peter