homelab:besluiten:26.014-dns_voor_containers_via_pi-hole
26.014 DNS voor containers via Pi-hole
- Wat: Containers op de NAS gebruiken Pi-hole rechtstreeks als DNS-server, zodat per container zichtbaar is welke namen hij opvraagt.
- Datum: 2026-10-21
- Thema's:
/
Context
- Pi-hole is gekozen voor inzicht in welke apparaten contact zoeken met internet (26.004). Voor containers op de NAS werkte dat niet: ze verschenen in Pi-hole als één host, het adres van de NAS, en niet per container.
- Het doel is vooral monitoring van uitgaand verkeer per container, bijvoorbeeld van de downloaders. Het beperken van de bereikbaarheid van containers (exposure) is een apart onderwerp.
- Pi-hole draait in
host-modus en luistert op alle interfaces, dus het ziet het echte bronadres van elke vraag, ook van een Docker-netwerk op dezelfde NAS.
Opties
- Gekozen:
dns: 192.168.1.10bij elke service in de compose. Pi-hole ziet dan het eigen Docker-adres van die container (een bridge-adres van het stacknetwerk). Zonder VLAN, extra IP's of wijziging in de router. - Afgewezen: een eigen IP per container (macvlan, in een apart VLAN of in
lan). Geeft hetzelfde inzicht maar vraagt VLAN, firewallregels en een macvlan-netwerk. De NAS zelf kan zijn macvlan-containers bovendien niet rechtstreeks bereiken, wat de reverse proxy lastig maakt. Niet nodig voor monitoring. Het servers-VLAN blijft een apart onderwerp voor het beperken van exposure. - Afgewezen: alle containers onder één IP. Pi-hole ziet dan één client voor alles, en het verkeer verlaat de NAS nog steeds met het adres uit
lan. Geen onderscheid per container en geen scheiding. - Afgewezen: niets doen. Alle containers blijven achter het NAS-adres.
Besluit
- Elke service met uitgaand verkeer krijgt
dns: 192.168.1.10in de compose. Bij een stack met meerdere services staat het adres één keer bovenaan als variabele (x-my-dns); bij een stack met één service kan het direct bij de service. - Uitzonderingen: services met
network_mode: hostof met het netwerk van een andere container (container:) kunnendns:niet gebruiken. Services zonder uitgaand verkeer (database, cache) hebben het niet nodig. De lijst en de uitvoering staan in de standaard voor containers. - Containers in het servers-VLAN gebruiken
dns: 192.168.5.10(aanvankelijk .2, op 25 okt veranderd, zie 26.015) (Pi-hole op de NAS, binnen dat VLAN), zie 26.015. - Geen tweede DNS-server toevoegen. Anders gaat een deel van het verkeer langs Pi-hole heen en klopt de monitoring niet meer.
Gevolgen
- Technisch:
- Pi-hole toont per container het Docker-adres van zijn stacknetwerk. In de Query Log is te filteren op Client (by IP) met het subnet van de stack (bijvoorbeeld
172.16.37.*voor stack 37). - Containers praten onderling nog steeds op naam.
dns:bepaalt alleen waar namen van buiten worden opgezocht.
- Operationeel:
- Een nieuwe container krijgt
dns:bij het aanmaken, volgens de standaard.
- Risico's:
- Is Pi-hole uit (herstart van de container, NAS-update), dan kunnen deze containers geen namen meer opzoeken. Anders dan bij
lanis er geen tweede DNS-server (zie hierboven). - Docker kiest het subnet van een stacknetwerk zelf, per netwerk uit zijn voorraad. Wordt een netwerk opnieuw aangemaakt, dan kan het adres van een container veranderen. Namen die aan een adres hangen verspringen dan mee. Daarom krijgt elke stack een vast subnet (
172.16.<stack-id>.0/24), zie de standaard voor containers en het IP-plan; netwerken zonder vast subnet vallen terug op een vangnet in172.26.0.0/15. - Containers in
host-modus (Plex, Pi-hole, Beszel-Agent) blijven achter het NAS-adres.
Evaluatie
- Heroverwegen als een container naar Pi-hole moet kunnen zonder dat de compose daar aanpassing voor hoeft (bijvoorbeeld bij een verhuizing naar het servers-VLAN), of als Pi-hole uitvalt vaker dan nu voorkomt.
homelab/besluiten/26.014-dns_voor_containers_via_pi-hole.txt · Last modified: by 127.0.0.1
