Skip to content

Instantly share code, notes, and snippets.

@inscapist
Last active April 10, 2024 11:32
Show Gist options
  • Save inscapist/59bfc6c1b1e21074241dff9511663834 to your computer and use it in GitHub Desktop.
Save inscapist/59bfc6c1b1e21074241dff9511663834 to your computer and use it in GitHub Desktop.
Pi-Hole + unbound + tailnet search domain (Void linux)
#version: "3"
# More info at https://github.com/pi-hole/docker-pi-hole/ and https://docs.pi-hole.net/
services:
pihole:
container_name: pihole
image: pihole/pihole:latest
network_mode: "host"
# For DHCP it is recommended to remove these ports and instead add: network_mode: "host"
environment:
TZ: 'America/Chicago'
WEBPASSWORD: ''
# Volumes store your data between container upgrades
volumes:
- './etc-pihole:/etc/pihole'
- './etc-dnsmasq.d:/etc/dnsmasq.d'
# https://github.com/pi-hole/docker-pi-hole#note-on-capabilities
cap_add:
- NET_ADMIN # Required if you are using Pi-hole as your DHCP server, else not needed
restart: unless-stopped
server:
# If no logfile is specified, syslog is used
# logfile: "/var/log/unbound/unbound.log"
verbosity: 0
interface: 0.0.0.0
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: '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.
# IP fragmentation is unreliable on the Internet today, and can cause
# transmission failures when large DNS messages are sent via UDP. Even
# when fragmentation does work, it may not be secure; it is theoretically
# possible to spoof parts of a fragmented DNS message, without easy
# detection at the receiving end. Recently, there was an excellent study
# >>> Defragmenting DNS - Determining the optimal maximum UDP response size for DNS <<<
# by Axel Koolhaas, and Tjeerd Slokker (https://indico.dns-oarc.net/event/36/contributions/776/)
# in collaboration with NLnet Labs explored DNS using real world data from the
# the RIPE Atlas probes and the researchers suggested different values for
# IPv4 and IPv6 and in different scenarios. They advise that servers should
# be configured to limit DNS messages sent over UDP to a size that will not
# trigger fragmentation on typical network links. DNS servers can switch
# from UDP to TCP when a DNS response is too big to fit in this limited
# buffer size. This value has also been suggested in DNS Flag Day 2020.
edns-buffer-size: 1232
# 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
private-domain: "gila-gamma.ts.net."
forward-zone:
name: "gila-gamma.ts.net."
forward-addr: 100.100.100.100
@inscapist
Copy link
Author

inscapist commented Apr 9, 2024

Pi-hole admin is at http://pi.hole/admin

roothints

cd /etc/unbound
wget https://www.internic.net/domain/named.root -qO- | sudo tee root.hints

testing

dig google.com @127.0.0.1 -p 5335

@inscapist
Copy link
Author

inscapist commented Apr 9, 2024

To enable search domain (ie. vm -> vm.gila-gamma.ts.net), there are two main things:

Configuring Search Domain in /etc/resolv.conf

Add search gila-gamma.ts.net to /etc/resolv.conf

Setting DNS and Search Domain via dhcpcd.conf

Append the following code:

static domain_name_servers=127.0.0.1
static domain_search=gila-gamma.ts.net

Other tips:

  • Doesn't seem to matter, but in pi-hole DNS settings, everything is left as default
  • MagicDNS is disabled in admin (tailscaled always server DNS at 100.100.100.100 regardless of the setting)
  • Use nslookup and not dig to test whether search domain works.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment