homelab:services:pi-hole
Table of Contents
Pi-hole
- Wat: DNS-server met adblocker, als container op de NAS (stack 55 in Portainer).
- Doel: Inzicht in welke apparaten (vooral IoT) contact zoeken met internet, en advertenties blokkeren. De keuze staat in 26.004.
- Device: Synology DS423+
Afwijkende instellingen (met reden)
- Webinterface op poort 9090 in plaats van 8080. Reden: 8080 was al in gebruik.
- Settings → All settings → NTP (Network Time Sync):
ntp.ipv4.activeenntp.ipv6.activeuitgeschakeld. Reden: in de logs van de container stond dat de NTP-servers niet gevonden werden (dit staat ook in de handleiding waarop de installatie is gebaseerd). - Extra blocklists toegevoegd. Reden: clients vragen Pi-hole rechtstreeks, waardoor de adblock van de router niet meer meedoet.
- De upstream-DNS is niet naar de router gestuurd, zodat Pi-hole zelf de adblocking doet.
- De DHCP-instellingen van de router (optie 6) staan in de DNS- en DHCP-standaard.
- De NAS heeft een tweede adres in
iot: 192.168.3.9 (DHCP-reserveringmax-iotin de router, bewust zonder gateway). Reden: IoT-apparaten praten zo rechtstreeks met Pi-hole in hun eigen subnet, zonder routering of NAT. Zonder dit zag Pi-hole al het verkeer uitiotalsrouter.lan. In Pi-hole zelf is niets aangepast: het luistert al op alle interfaces (network_mode: hostenFTLCONF_dns_listeningMode: all). Zie 26.013. - Containers op de NAS gebruiken Pi-hole rechtstreeks (
dns: 192.168.1.10in hun compose) en staan in de Query Log met hun eigen Docker-adres, te filteren op Client (by IP). Zie 26.014 en de standaard voor containers. guest(en waarschijnlijk WireGuard) verschijnt in Pi-hole alsrouter.lan: dat verkeer loopt via de firewallzonelanmet NAT. Bewust zo gelaten, zie 26.013.
Netwerk
- Segment:
(adressen en VLAN's: zie het ip-plan). Pi-hole is bereikbaar op 192.168.1.10 (
lan) en op 192.168.3.9 (iot, de tweede aansluiting van de NAS). De NAS zelf gebruikt 8.8.8.8 en 8.8.4.4 als DNS, zie de DNS- en DHCP-standaard. - Netwerkmodus:
host(geen eigen Docker-bridge): Pi-hole luistert direct op het adres van de NAS. - Poorten: 53 (DNS) en 9090 (webinterface, ingesteld met
FTLCONF_webserver_port). - Extra rechten voor de container:
SYS_TIMEenSYS_NICE. - Firewallregel “DNS op Max-container-PiHole”: DNS naar 192.168.1.10 poort 53 vanuit elk segment.
Resources
- CPU: geen limiet
- RAM: gebruik ca. 65 MiB (momentopname
docker stats, 2026-10-18), geen limiet. Zie 26.012.
Opslag
- Configuratie:
/volume2/docker/pihole(submappenpiholeendnsmasq.d)
Backups
Zie de backupstandaard.
Beheer
- Updates: WUD-categorie C, alleen melden. Zie WUD. Een herstart van de container of de NAS laat
iotenguestzonder DNS, zie de noodprocedure hieronder. - Beheer van de container via Portainer.
- Bron voor de installatie: de handleiding van Marius Hosting.
Als Pi-hole uitvalt: DNS voor iot en guest herstellen
Wanneer: Pi-hole is niet bereikbaar (container gestopt of NAS uit, te zien in Portainer) en apparaten in iot en guest hebben geen DNS. lan hoeft niets: dat heeft de router als tweede DNS, wel kan het even trager zijn. Keuze en afwegingen: 26.013.
Alles gebeurt in LuCI. Open het via het IP-adres, dat heeft geen DNS nodig.
- Network → Interfaces → IoT → Edit → DHCP Server → Advanced Settings → DHCP-Options: vervang
6,192.168.3.9door6,192.168.3.1(de router iniot). Geen spatie voor de 6. - Network → Interfaces → guest → Edit → DHCP Server → Advanced Settings → DHCP-Options: vervang
6,192.168.1.10door6,192.168.4.1(de router inguest). - Voor snel effect: zet bij beide interfaces onder DHCP Server → General Setup de Lease time op
5m. Anders pakken apparaten de wijziging pas na ongeveer de helft van de leasetijd (nu 12 uur) op. - Klik per interface op Save en daarna op de pagina op Save & Apply.
- Apparaten pakken het nieuwe DNS-adres bij hun volgende vernieuwing van het adres. Versnellen kan door Wi-Fi uit en aan te zetten of het apparaat te herstarten (bij slimme apparaten: stroom eraf).
De router lost dan zelf op via de WAN-DNS (8.8.8.8 en 8.8.4.4): alles werkt weer, maar zonder blokkering en zonder inzicht in Pi-hole.
Terugzetten als Pi-hole weer werkt
iot: optie terug naar6,192.168.3.9.guest: optie terug naar6,192.168.1.10.- Lease time van beide terug op
12h. - Save & Apply. Apparaten die nu de router gebruiken, komen bij hun volgende vernieuwing terug bij Pi-hole (versnellen zoals hierboven).
Relaties
homelab/services/pi-hole.txt · Last modified: by 127.0.0.1
