netzbeere-web/README.de.md

13 KiB

Pi-hole Website
Netzwerkweites Blockieren von Werbung auf deiner eigenen Linux-Hardware



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.

Pi-hole Weboberfläche

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:

  1. https://<IP_ADRESSE_DEINER_PI_HOLE>/admin/
  2. https://pi.hole/admin/ (wenn Pi-hole als dein DNS-Server verwendet wird)
  3. https://pi.hole/ (wenn Pi-hole als dein DNS-Server verwendet wird)

[!TIPP] Du kannst auf die Weboberfläche mit den Protokollen http:// oder https:// 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.

Funktionen

Mobile-freundliche Oberfläche

Mobile friendly

Passwortschutz

Password protection

Detaillierte Grafiken und Donut-Diagramme

Pie charts

Top-Listen der Domains und Clients

Top domains/top clients

Das Abfrageprotokoll

Query log

Das Abfrageprotokoll zeigt kürzliche und langfristige Daten über benutzerdefinierte Zeiträume.

Du kannst dein Protokoll mit dem erweiterten Filter durchsuchen:

Query log advanced filter

Blockieren und Zulassen von Domains

Listen, Domains (blockieren oder zulassen) und Regex-Einträge können über Gruppen verwaltet werden.


Domain Management

Einstellungen - Pi-hole-Funktionen verwalten und konfigurieren

System Settings - Basic and Expert

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

Alle Einstellungen

Werkzeuge

  • Diagnose-Nachrichten;
  • Echtzeit-Logs anzeigen: pihole.log, FTL.log und webserver.log;
  • Deine Listen aktualisieren;
  • Eine Domain in deinen Listen suchen.

Live Pi-hole Log

Suche eine Domain in deinen Listen

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:

API-Dokumentation