13 KiB
Netzbeere - Übersetzte Pi-hole Weboberfläche
Netzbeere ist eine lustige Mischung aus zwei Welten: "Netz", das deutsche Wort für Web, und "Beere", das deutsche Wort für Berry, was einen spielerischen Hinweis auf den Lieblings-Raspberry Pi gibt. Mit diesem Projekt kannst du die leistungsstarken Funktionen von Pi-hole zur Werbung-Blockierung mit einem lokalisierten Touch genießen, was es noch zugänglicher und benutzerfreundlicher macht.

Die Pi-hole®-Weboberfläche (basierend auf AdminLTE) bietet einen zentralen Ort, um dein Pi-hole zu verwalten und die von FTLDNS™ generierten Statistiken anzusehen.
- Einfach zu verstehen: Einfache Diagramme und schöne Farben machen die Pi-hole-Statistiken leicht verständlich
- Reaktionsfähig: Sieht auf Desktop-PCs, Tablets und Mobilgeräten großartig aus
- Nützlich: Steuere und konfiguriere dein Pi-hole mit unseren Einstellungen
- Aufschlussreich: Nutze das Abfrageprotokoll, einschließlich langfristiger Statistiken, um Einblicke in die Aktivitäten deines Netzwerks zu erhalten

Installation
Die Weboberfläche ist standardmäßig aktiviert, wenn du Pi-hole installierst. Wenn du jedoch dieses Repository verwenden möchtest, kannst du einen der folgenden Schritte ausführen:
1. Klone und führe lokal aus
Klonen des offiziellen Repositories:
git clone --depth 1 https://github.com/pi-hole/pi-hole/blob/master/automated%20install/basic-install.sh
cd "Pi-hole/automated install/"
Ändere jetzt in Zeile 82 den Wert von webInterfaceGitUrl
auf https://gitea.zokki.net/zokki/netzbeere-web.git
.
Danach kannst du das Skript ausführen:
sudo bash basic-install.sh
2. Herrunterladen vom Skript
Lade das offizielle Installationsskript herunter:
wget -O basic-install.sh https://install.pi-hole.net
Ändere jetzt in Zeile 82 den Wert von webInterfaceGitUrl
auf https://gitea.zokki.net/zokki/netzbeere-web.git
.
Danach kannst du das Skript ausführen:
sudo bash basic-install.sh
3. Docker
Siehe das Pi-hole Docker Repository, um die offiziellen Docker-Images zu verwenden.
Aber du musst das Image selbst bauen und in der Dockerfile
Zeile 74 ändern, um https://gitea.zokki.net/zokki/netzbeere-web.git
anstelle von GitHub zu verwenden, um zu klonen.
4. Auf bereits laufenden Systemen
Bitte reinige das Verzeichnis /var/www/html/admin/
, und klone dann die Inhalte dieses Repositories direkt dorthin. Stelle sicher, dass die Inhalte des Repositories im admin
-Ordner selbst abgelegt werden, nicht in einem Unterordner.
TODOs:
- Die letzten Übersetzungen abschließen
- Das FTL/Backend muss übersetzt werden
Wie man eine neue Sprache hinzufügt
Die aktuellen Sprachen befinden sich in i18n/<lang>.ini. Du musst einfach die deutsche Übersetzung verwenden, die Datei kopieren, sie auf deine Sprache umbenennen und die Werte in deine Sprache übersetzen. Danach kannst du einen PR (Pull Request) öffnen oder es für dich selbst verwenden.
Nach der Installation: Zugriff auf die Weboberfläche und Einsicht in die Aktivitäten deines Netzwerks
Es gibt mehrere Möglichkeiten, auf das Dashboard zuzugreifen:
https://<IP_ADRESSE_DEINER_PI_HOLE>/admin/
https://pi.hole/admin/
(wenn Pi-hole als dein DNS-Server verwendet wird)https://pi.hole/
(wenn Pi-hole als dein DNS-Server verwendet wird)
[!TIPP] Du kannst auf die Weboberfläche mit den Protokollen
http://
oderhttps://
zugreifen.
Nachdem du dich eingeloggt hast, kannst du die Netzwerkstatistiken einsehen und Dinge wie folgendes sehen:
- Die Domains, die in deinem Netzwerk abgefragt werden
- Die Zeit, zu der die Abfragen gestartet wurden
- Die Anzahl der blockierten Domains
- Den Upstream-Server, an den die Abfragen gesendet wurden
- Die Art der Abfragen (
A
,AAAA
,CNAME
,SRV
,TXT
etc.)
Pi-hole ist kostenlos, aber wird durch deine Unterstützung betrieben
Es gibt viele wiederkehrende Kosten, die mit der Pflege von freier, Open-Source-Software, die die Privatsphäre respektiert, verbunden sind. Diese Kosten werden von unseren freiwilligen Entwicklern gedeckt, die aus eigener Tasche dazu beitragen. Dies ist nur ein Beispiel dafür, wie stark wir zu unserer Software stehen und wie wichtig es ist, sie in Stand zu halten.
Mache keinen Fehler: Deine Unterstützung ist absolut entscheidend, um uns zu helfen, weiterhin zu innovieren!
Spenden
Eine Spende über unsere Links unten zu senden ist extrem hilfreich, um einen Teil unserer monatlichen Ausgaben zu decken:
Alternative Unterstützung
Wenn du lieber nicht spenden möchtest (was okay ist!), gibt es andere Wege, wie du uns unterstützen kannst:
- Patreon Werde ein Patron und erhalte Belohnungen
- Digital Ocean Affiliate-Link
- Stickermule Verdiene einen $10-Gutschein nach deinem ersten Einkauf
- Amazon Affiliate-Link
- DNS Made Easy Affiliate-Link
- Erzähle von unserer Software und wie du davon profitiert hast
Beiträge über GitHub
Wir heißen alle willkommen, sich an Fehlerberichten, der Vorschlag neuer Funktionen und Pull Requests zu beteiligen.
Wenn du etwas beizutragen hast - sei es ein Tippfehler oder eine ganz neue Funktion - wir freuen uns darauf, es zu prüfen! Stelle nur sicher, dass du unsere Vorlage beim Einreichen deiner Anfrage ausfüllst; die Fragen, die sie stellt, helfen den freiwilligen Helfern, schnell zu verstehen, was du erreichen möchtest.
Präsentationen über Pi-hole
Mundpropaganda hilft unserem Projekt, immens zu wachsen, und wir machen es den Leuten leichter, dies zu tun.
Wenn du Pi-hole auf einer Konferenz, einem Meetup oder sogar in einem Schulprojekt präsentierst, nimm Kontakt mit uns auf, damit wir dir kostenloses Werbematerial zur Verfügung stellen können, das du deinem Publikum geben kannst!
Kontakt mit uns aufnehmen
Obwohl wir hauptsächlich über unser Discourse User Forum erreichbar sind, findest du uns auch auf verschiedenen Social Media Kanälen. Bitte prüfe zuerst die FAQ, bevor du eine neue Diskussion startest, da wir nicht die Zeit haben, auf jede Anfrage um Hilfe zu antworten.
- Häufig gestellte Fragen
- Pi-hole Wiki
- Feature Requests
- Discourse User Forum
- Gitter (Echtzeit-Chat)
- YouTube
Funktionen
Mobile-freundliche Oberfläche
Passwortschutz
Detaillierte Grafiken und Donut-Diagramme
Top-Listen der Domains und Clients
Das Abfrageprotokoll
Das Abfrageprotokoll zeigt kürzliche und langfristige Daten über benutzerdefinierte Zeiträume.
Du kannst dein Protokoll mit dem erweiterten Filter durchsuchen:

Blockieren und Zulassen von Domains
Listen, Domains (blockieren oder zulassen) und Regex-Einträge können über Gruppen verwaltet werden.
Einstellungen - Pi-hole-Funktionen verwalten und konfigurieren

Systemeinstellungen:
- Systeminformationen
- DNS-Antwortmetriken
- DNS-Cache-Metriken
\color{red}{\normalsize\textsf{[Expert]}}
- DHCP-Servermetriken
\color{red}{\normalsize\textsf{[Expert]}}
- Aktionen (Buttons)
\color{red}{\normalsize\textsf{[Expert]}}
DNS-Einstellungen:
- Upstream-DNS-Server (einschließlich benutzerdefinierter DNS-Server)
- Schnittstelleneinstellungen
\color{red}{\normalsize\textsf{[Expert]}}
- Erweiterte DNS-Einstellungen
\color{red}{\normalsize\textsf{[Expert]}}
- DNS-Domain-Einstellungen
\color{red}{\normalsize\textsf{[Expert]}}
- Ratenbegrenzung
\color{red}{\normalsize\textsf{[Expert]}}
- Bedingtes Weiterleiten
\color{red}{\normalsize\textsf{[Expert]}}
DHCP-Einstellungen:
- Allgemeine DHCP-Einstellungen
- Erweiterte DHCP-Einstellungen
\color{red}{\normalsize\textsf{[Expert]}}
- Aktuelle Tabelle der aktiven DHCP-Leases
- Statische DHCP-Konfiguration
\color{red}{\normalsize\textsf{[Expert]}}
- Erweiterte Beschreibung (Hilfetext)
\color{red}{\normalsize\textsf{[Expert]}}
Weboberfläche - API-Einstellungen:
- Theme-Einstellungen
- Erweiterte Einstellungen
\color{red}{\normalsize\textsf{[Expert]}}
- Ausnahmen (Domains und Clients, die von Dashboard-Tabellen ausgeschlossen werden sollen)
\color{red}{\normalsize\textsf{[Expert]}}
- Aktuelle Tabelle der aktiven Sitzungen
\color{red}{\normalsize\textsf{[Expert]}}
Privatsphäre-Einstellungen:
- Abfrage-Protokollierung
- Abfrage-Anonymisierung ("Privacy Level")
\color{red}{\normalsize\textsf{[Expert]}}
- Datenschutzbezogene Datenbank-Einstellungen
\color{red}{\normalsize\textsf{[Expert]}}
Teleporter:
- Exportiere die Pi-hole-Konfiguration
- Importiere eine zuvor exportierte Konfiguration
Lokale DNS-Einstellungen:
- Lokale DNS-Einträge
- Lokale CNAME-Einträge
Alle Einstellungen (nur im Expertenmodus sichtbar):
- Erweiterte Einstellungsseite, die alle verfügbaren Optionen enthält
Werkzeuge
- Diagnose-Nachrichten;
- Echtzeit-Logs anzeigen:
pihole.log
,FTL.log
undwebserver.log
; - Deine Listen aktualisieren;
- Eine Domain in deinen Listen suchen.
API
Die REST-API kann unter /api
aufgerufen werden und gibt Daten im JSON-Format zurück.
Eine lokale API-Dokumentation findest du unter /api/docs
: