Ga naar inhoud

🛡️ Pi-hole

Pi-hole is een netwerk-brede ad blocker die fungeert als DNS server voor het hele Hamming netwerk.

Algemene Info

Item Waarde
Container pihole
Image pihole/pihole:latest
IP Adres 192.168.1.13
DNS Poort 53
Web Interface pihole.hub of 192.168.1.13:8080
Upstream DNS Unbound (lokaal, :5335)

Functies

  • ✅ Ad blocking - Blokkeert advertenties en trackers netwerk-breed
  • ✅ DNS server - Centrale DNS voor alle VLANs
  • ✅ Local DNS - Eigen .hub domeinen
  • ✅ Query logging - Zie welke apparaten wat opvragen
  • ✅ Blocklists - Aanpasbare blokkeerlijsten

Configuratie

Upstream DNS (Unbound)

Pi-hole stuurt alle DNS queries door naar Unbound, een lokale recursive DNS resolver. Dit betekent dat DNS queries niet naar externe servers gaan (zoals Google of Cloudflare).

Client → Pi-hole → Unbound → Root DNS servers

Local DNS Records

De volgende .hub domeinen zijn geconfigureerd:

Domein IP Adres
dashboard.hub 192.168.1.13
pihole.hub 192.168.1.13
status.hub 192.168.1.13
portainer.hub 192.168.1.13
npm.hub 192.168.1.13
guacamole.hub 192.168.1.13
duplicati.hub 192.168.1.13
docs.hub 192.168.1.13

Blocklists

Standaard blocklists plus aanbevolen toevoegingen:

  1. Steven Black's Unified Hosts - Ads + malware
  2. Firebog Ticked Lists - Gecureerde collectie

Beheer

Web Interface

  1. Ga naar pihole.hub
  2. Login met je wachtwoord
  3. Dashboard toont statistieken

CLI Commando's

# Pi-hole status
docker exec pihole pihole status

# Blocklists updaten
docker exec pihole pihole -g

# DNS cache legen
docker exec pihole pihole restartdns

# Tijdelijk uitschakelen (5 minuten)
docker exec pihole pihole disable 5m

Local DNS Record Toevoegen

  1. Ga naar Pi-hole → Local DNS → DNS Records
  2. Voeg domein toe (bijv. nieuw.hub)
  3. Vul IP adres in (bijv. 192.168.1.13)
  4. Klik Add

Of via CLI: 

docker exec pihole pihole -a addcustomdns nieuw.hub 192.168.1.13

Troubleshooting

DNS werkt niet

Symptomen

  • Websites laden niet
  • .hub domeinen werken niet
  • "DNS_PROBE_FINISHED_NXDOMAIN" errors

Oplossing:

  1. Check of Pi-hole draait: 

    docker ps | grep pihole

  2. Check of Unbound draait: 

    docker ps | grep unbound

  3. Test DNS direct: 

    nslookup google.com 192.168.1.13

  4. Herstart containers: 

    docker restart unbound pihole

.hub domeinen werken niet

Symptomen

  • dashboard.hub geeft "site niet gevonden"
  • Externe sites werken wel

Oplossing:

  1. Check of je apparaat Pi-hole als DNS gebruikt: 

    # Linux/Mac
cat /etc/resolv.conf

# Windows
ipconfig /all

  2. DNS moet 192.168.1.13 zijn

  3. Check Local DNS records in Pi-hole

Te veel geblokkeerd

Website werkt niet door blocking

Oplossing:

  1. Ga naar Pi-hole → Query Log
  2. Zoek het geblokkeerde domein
  3. Klik op "Whitelist" naast het domein

Of via CLI: 

docker exec pihole pihole -w geblokkeerd-domein.com

Docker Compose

pihole:
  image: pihole/pihole:latest
  container_name: pihole
  restart: unless-stopped
  ports:
    - "53:53/tcp"
    - "53:53/udp"
    - "8080:80/tcp"
  environment:
    TZ: 'Europe/Amsterdam'
    WEBPASSWORD: 'jouw_wachtwoord'
    PIHOLE_DNS_: 'unbound#5335'
  volumes:
    - ./pihole/etc:/etc/pihole
    - ./pihole/dnsmasq:/etc/dnsmasq.d
  networks:
    - dns-net
    - proxy-net
  depends_on:
    - unbound

Gerelateerd