Hilfe & Dokumentation
Hier finden Sie alles, um NetPause erfolgreich einzurichten und zu nutzen.
📘 AdGuard Home – Grundlagen
NetPause benötigt ein bestehendes AdGuard Home. Stellen Sie sicher, dass:
- AdGuard Home installiert und erreichbar ist.
- Sie einen Administrator-Zugang (Benutzername/Passwort) haben.
- Unter Clients die Geräte angelegt sind, die Sie später steuern wollen.
🧠 Wie die Zeitsteuerung funktioniert
Die App prüft minütlich, ob die aktuelle Uhrzeit in einem Ihrer definierten Sperrintervalle liegt. Ist das der Fall, werden in AdGuard Home zwei Arten von Regeln gesetzt:
- Eine Sperrregel für das gesamte Internet:
||*^$client=GERÄT - Ausnahmeregeln für die von Ihnen freigegebenen Seiten:
@@||domain^$client=GERÄT
Außerhalb der Intervalle werden diese Regeln vollständig entfernt – das Gerät hat wieder normalen Zugriff.
⏰ Sinnvolle Zeitintervalle
Sie können für jedes Gerät beliebig viele Intervalle angeben. Einige Beispiele:
- Nachtruhe: 21:00 – 07:00 (funktioniert auch über Mitternacht)
- Schulzeit: 08:00 – 13:00
- Lernzeit: 14:00 – 16:00
- Dauerhaft sperren: 00:00 – 23:59
Sobald die aktuelle Uhrzeit in einem dieser Intervalle liegt, wird das Gerät gesperrt.
📱 Geräte richtig konfigurieren (der wichtigste Schritt!)
Damit NetPause überhaupt eingreifen kann, muss der gesamte DNS-Verkehr des Geräts über Ihren AdGuard Home Server laufen. Achten Sie auf folgende Punkte:
- Feste IP-Adresse – entweder per Router-Reservierung oder manuell im Gerät.
- DNS-Server – tragen Sie die IP Ihres AdGuard Home Servers ein (und keine externen DNS wie 8.8.8.8).
- IPv6 deaktivieren – viele Geräte nutzen sonst IPv6-DNS und umgehen die Sperre.
- DNS over HTTPS (DoH) / DNS over TLS (DoT) – deaktivieren, da diese Verbindungen verschlüsselt sind und AdGuard Home sie nicht sieht.
Im Zweifel prüfen Sie mit einem Blick in das Abfrageprotokoll von AdGuard Home, ob die Anfragen des Geräts dort auftauchen.
🪟 Windows richtig einstellen
- Statische IP konfigurieren (in den Netzwerkeinstellungen von Windows oder per Router-Reservierung).
- DNS-Server unter IPv4 manuell auf die AdGuard-IP setzen.
- IPv6 deaktivieren:
- In den Adaptereinstellungen das Häkchen bei „Internetprotokoll Version 6 (TCP/IPv6)“ entfernen.
- Oder via Registry:
Windows-Taste + R →
regedit
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters
DWORD-Wert (32-Bit)DisabledComponents=0xff(hexadezimal für 255)
- DoH deaktivieren (falls aktiviert – in Windows meist nicht nötig):
- Via Registry:
Windows-Taste + R →
regedit
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Dnscache\Parameters
DWORD-Wert (32-Bit)EnableAutoDoh=0
- Via Registry:
📱 Android konfigurieren
- WLAN-Einstellungen → Netzwerk lange drücken → „Netzwerk ändern“.
- „Erweiterte Optionen“ anzeigen → IP-Einstellungen auf Statisch.
- Bei DNS 1 und DNS 2 die IP Ihres AdGuard Home Servers eintragen.
- Unter Privates DNS (in den Systemeinstellungen) die Option „Aus“ wählen.
🍏 iPhone / iPad einrichten
- Einstellungen → WLAN → (i) neben Ihrem Netzwerk.
- IP konfigurieren → Manuell – vergeben Sie eine statische IP (oder notieren Sie die aktuelle und reservieren Sie sie im Router).
- DNS konfigurieren → Manuell – vorhandene Einträge löschen und Ihre AdGuard-IP hinzufügen.
- Stellen Sie sicher, dass iCloud Private Relay deaktiviert ist (falls aktiv).
🐧 Linux (mit NetworkManager)
Wenn Sie einen Linux-Rechner direkt steuern möchten, können Sie die DNS-Einstellungen z.B. so setzen (als root):
# Verbindungsname herausfinden nmcli connection show # IPv6 deaktivieren, DNS setzen sudo nmcli connection modify "Verbindungsname" ipv6.method "disabled" sudo nmcli connection modify "Verbindungsname" ipv4.ignore-auto-dns yes sudo nmcli connection modify "Verbindungsname" ipv4.dns "192.168.1.100" # Verbindung neu starten sudo nmcli connection down "Verbindungsname" && sudo nmcli connection up "Verbindungsname"
(Ersetzen Sie „Verbindungsname“ und die IP durch Ihre Werte.)
🛡️ Umgehung durch DNS over HTTPS (DoH) verhindern
Manche Browser (Firefox, Chrome) oder Betriebssysteme (Android 9+) versuchen, verschlüsseltes DNS zu nutzen, um die Sperre zu umgehen. Die effektivste Lösung ist, diese Verbindungen auf AdGuard Home-Ebene zu blockieren.
Fügen Sie dazu die DoH-Blocklist von HaGeZi in AdGuard Home ein:
- Öffnen Sie AdGuard Home → Filter → Benutzerdefinierte Filter.
- Klicken Sie auf Filter hinzufügen.
- Geben Sie einen Namen ein, z.B. „DoH-Blocklist“.
- Fügen Sie folgende URL ein:
https://raw.githubusercontent.com/hagezi/dns-blocklists/main/adblock/doh.txt - Speichern Sie den Filter und warten Sie auf die Aktualisierung.
Damit werden bekannte DoH-Server blockiert, und das Gerät kann nicht mehr darauf ausweichen.
🕒 Zeitzone des Servers prüfen
Die automatische Steuerung basiert auf der Systemzeit Ihres Servers. Wenn die Sperrzeiten nicht korrekt greifen, liegt es oft an einer falschen Zeitzone.
# Aktuelle Zeitzone anzeigen timedatectl # Zeitzone setzen (z.B. für Deutschland) sudo timedatectl set-timezone Europe/Berlin sudo dpkg-reconfigure --frontend noninteractive tzdata
❓ Häufige Probleme – und was Sie tun können
-
Die Sperre hat keine Wirkung:
Prüfen Sie im Abfrageprotokoll von AdGuard Home, ob die DNS-Anfragen des Geräts dort auftauchen. Wenn nicht, verwendet das Gerät einen anderen DNS-Server (z.B. über DoH oder fest eingetragene externe DNS). Korrigieren Sie die Geräteeinstellungen wie oben beschrieben. -
Ein Gerät wird nicht erkannt:
Der Client-Name in AdGuard Home muss exakt mit dem Namen in der App übereinstimmen. Achten Sie auf Groß-/Kleinschreibung und eventuelle Anhänge (z.B. „-“ oder Leerzeichen). -
Regeln werden nicht gesetzt:
Prüfen Sie die Log-Dateien der App:/var/www/html/AdGuardParental/kinderschutz.logundcron-error.log. Dort steht, ob der Cron-Job läuft und ob die Verbindung zu AdGuard Home klappt. -
Sperrzeiten passen zeitlich nicht:
Stimmt die Zeitzone des Servers? Kontrollieren Sie mitdatedie aktuelle Systemzeit. -
Fehler „Keine AdGuard-Konfiguration“:
Hinterlegen Sie Ihre Zugangsdaten in den Einstellungen. Die URL muss dabei vollständig sein (z.B.http://192.168.1.100:80). -
Passwort für die App vergessen?
Löschen Sie die Datei/var/www/keys/users.enc– dann startet die App neu und Sie können einen neuen Admin-Benutzer anlegen. Alle anderen Einstellungen (AdGuard-Zugangsdaten, Geräte) bleiben erhalten.