Ga naar inhoud

🔧 Veelvoorkomende Problemen

Overzicht van veelvoorkomende problemen en hun oplossingen.

Snelle Diagnostiek

Stap 1: Wat werkt niet?

Symptoom Mogelijke oorzaak Ga naar
Geen internet DNS, router, ISP DNS Problemen
.hub sites niet bereikbaar Pi-hole, NPM DNS Problemen
Container werkt niet Docker Docker Problemen
Kan niet bij andere VLAN Firewall Netwerk Problemen
Service offline Container crashed Docker Problemen

Stap 2: Basis Checks

# 1. Heb ik netwerk?
ping 192.168.1.1

# 2. Werkt DNS?
nslookup google.com 192.168.1.13

# 3. Draaien de containers?
docker ps

# 4. Wat zeggen de logs?
docker logs pihole --tail 50

Top 5 Problemen

1. ".hub domeinen werken niet"

Snelle fix: 

# Test DNS
nslookup dashboard.hub 192.168.1.13

Mogelijke oorzaken: - Pi-hole container down → docker restart pihole - Apparaat gebruikt verkeerde DNS → Check DHCP settings - Local DNS record mist → Voeg toe in Pi-hole

Volledige handleiding →

2. "Service is offline / 502 Bad Gateway"

Snelle fix: 

# Herstart de service
docker restart service_naam

Mogelijke oorzaken: - Container crashed → Check logs - Poort conflict → Check docker ps - Netwerk probleem → Check docker network ls

Volledige handleiding →

3. "Kan niet bij NAS/server"

Snelle fix: 

# Test connectiviteit
ping 192.168.1.12

Mogelijke oorzaken: - VLAN probleem → Check welk VLAN je in zit - Firewall blokkeert → Check UniFi regels - Service niet actief → Check doel apparaat

Volledige handleiding →

4. "Internet werkt niet"

Snelle fix: 

# Bypass DNS
ping 8.8.8.8

# Test DNS
ping google.com

Conclusie: - 8.8.8.8 werkt, google.com niet → DNS probleem - Beide werken niet → Router/ISP probleem - Beide werken → Specifiek apparaat/site probleem

5. "Na reboot werkt X niet"

Checklist: 

# Docker services
docker ps  # Allemaal running?

# Herstart alle containers
cd ~/docker && docker compose up -d

# Check Tailscale
tailscale status

Diagnostische Commando's

Netwerk

# IP configuratie
ip addr

# Routing tabel
ip route

# DNS servers
cat /etc/resolv.conf

# Open poorten
netstat -tlnp
ss -tlnp

Docker

# Draaiende containers
docker ps

# Alle containers (ook gestopt)
docker ps -a

# Container logs
docker logs container_naam -f --tail 100

# Container resource gebruik
docker stats

Systeem

# Disk ruimte
df -h

# Geheugen
free -h

# CPU/processen
top
htop

# Systeem logs
journalctl -xe

Herstart Procedures

Enkel Service

docker restart service_naam

Alle Docker Services

cd ~/docker
docker compose down
docker compose up -d

Mini PC 1 (Docker host)

sudo reboot

Na reboot starten alle containers automatisch (restart: unless-stopped).

Mini PC 2 (Proxmox)

Via Proxmox UI: 1. Datacenter → Node → Reboot

Of via SSH: 

reboot

VMs en containers met "Start at boot" starten automatisch.

Wanneer Hulp Vragen

Als je er niet uitkomt:

  1. Verzamel informatie:
  2. Exacte foutmelding
  3. Relevante logs

  4. Wat deed je toen het misging

  5. Check documentatie:

  6. Deze docs site

  7. Officiële docs van de software

  8. Online zoeken:

  9. GitHub Issues
  10. Reddit
  11. Forums

Gerelateerd