====== 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 [[homelab:besluiten:26.004-installatie_en_configuratie_pi-hole|26.004]]. * **GUI**: [[http://192.168.1.10:9090/admin|de webinterface van Pi-hole]] * **Device**: [[homelab:devices:synology_ds423|Synology DS423+]] * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}} ===== 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.active'' en ''ntp.ipv6.active'' uitgeschakeld. 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 [[homelab:standaarden:netwerk:dns-dhcp|DNS- en DHCP-standaard]]. * De NAS heeft een tweede adres in ''iot'': 192.168.3.9 (DHCP-reservering ''max-iot'' in 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 uit ''iot'' als ''router.lan''. In Pi-hole zelf is niets aangepast: het luistert al op alle interfaces (''network_mode: host'' en ''FTLCONF_dns_listeningMode: all''). Zie [[homelab:besluiten:26.013-dns-redundantie_en_dns-route_per_segment|26.013]]. * Containers op de NAS gebruiken Pi-hole rechtstreeks (''dns: 192.168.1.10'' in hun compose) en staan in de Query Log met hun eigen Docker-adres, te filteren op //Client (by IP)//. Zie [[homelab:besluiten:26.014-dns_voor_containers_via_pi-hole|26.014]] en de [[homelab:standaarden:containers|standaard voor containers]]. * ''guest'' (en waarschijnlijk WireGuard) verschijnt in Pi-hole als ''router.lan'': dat verkeer loopt via de firewallzone ''lan'' met NAT. Bewust zo gelaten, zie [[homelab:besluiten:26.013-dns-redundantie_en_dns-route_per_segment|26.013]]. ===== Netwerk ===== * Segment: {{tag>lan iot}} (adressen en VLAN's: zie het [[homelab:standaarden:netwerk:ip-plan|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 [[homelab:standaarden:netwerk:dns-dhcp|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_TIME'' en ''SYS_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 [[homelab:besluiten:26.012-limiteren_ram_containers|26.012]]. ===== Opslag ===== * Configuratie: ''/volume2/docker/pihole'' (submappen ''pihole'' en ''dnsmasq.d'') ===== Backups ===== Zie de [[homelab:standaarden:backups|backupstandaard]]. ===== Beheer ===== * Updates: WUD-categorie C, alleen melden. Zie [[homelab:services:wud|WUD]]. Een herstart van de container of de NAS laat ''iot'' en ''guest'' zonder DNS, zie de noodprocedure hieronder. * Beheer van de container via [[homelab:services:portainer|Portainer]]. * Bron voor de installatie: [[https://mariushosting.com/synology-install-pi-hole-with-portainer/|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 [[homelab:services:portainer|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: [[homelab:besluiten:26.013-dns-redundantie_en_dns-route_per_segment|26.013]]. Alles gebeurt in [[http://192.168.1.1/cgi-bin/luci/|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.9'' door ''6,192.168.3.1'' (de router in ''iot''). Geen spatie voor de 6. - //Network → Interfaces → guest → Edit → DHCP Server → Advanced Settings → DHCP-Options//: vervang ''6,192.168.1.10'' door ''6,192.168.4.1'' (de router in ''guest''). - 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 naar ''6,192.168.3.9''. ''guest'': optie terug naar ''6,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 ===== * Besluiten: \\ {{backlinks>.#homelab:besluiten}} * Services: \\ {{backlinks>.#homelab:services}} * Thema's: {{tag>dns container}} /* Beschikbare thematags (kies er 0 of meer, gescheiden met een spatie): backup bandbreedte container, vm dns, firewall, vpn guest, iot, lan, servers multi-user Uitleg en "Bij wijziging": resources:metadata:tags:thema Nieuwe tag? Maak een tagpagina en werk deze lijst bij in de templates voor services, devices en besluiten. */