Erklärung

Ihr habt keine Lust auf lästige Werbung und wollt diese am besten in eurem gesamten Netzwerk Zuhause ausschalten? Dann seid Ihr genau richtig. Ich erkläre euch heute wie Ihr Pi-hole auf eurer Synology unter DSM installieren könnt. Dazu gibt es insgesamt 4 Wege. Prinzipiell sind die Wege mit leichten Anpassungen für alle Systeme nutzbar. Das ist eben der große Vorteil den die Docker Container mit sich bringen.

Installation mit Portainer
Installation mit dem Container Manager
Installation mit dem Aufgabenplaner
Installation mit SSH

Ja aber was ist den nun Pi-hole?

Pi-hole ist eine freie Software mit der Funktion eines Tracking- und Werbeblockers sowie eines optionalen DHCP-Servers. Pi-hole basiert auf einem Linux-System und ist für den Einsatz auf Kleinstcomputern im Sinne eines eingebetteten Systems entwickelt worden. Verbreitet ist der Einsatz auf Computern der Raspberry-Pi-Serie. Die Software wird als DNS-Server in ein bestehendes Netzwerk integriert und steht damit allen Geräten im Netzwerk zur Verfügung, deren DNS-Einstellungen sich konfigurieren lassen.

Hinweis

Pi-hole ist hierbei ein DNS Server der alle Versuche abweist wenn die Werbung versucht sich zu verbinden. Sei es auf einer Nachrichtenseite oder in einem Spiel auf dem Smartphone. Die Werbung wird nahezu komplett geblockt. Es kann in seltenen Fällen passieren, dass einige Links die eigentlich Werbungen sind, nicht mehr korrekt angezeigt und geklickt werden können.

Vorgehen | How-To | Tutorial

Unten sind die Schritte aufgezeigt, die es euch ermöglichen Pi-hole zu installieren. Updates und Verbesserungen werde ich im Laufe der Zeit immer wieder in diesen Post integrieren.

Voraussetzungen

Ihr benötigt folgende Voraussetzungen für die Installation von Pi-hole:

Docker/Container Manager installiert. Wie das geht seht Ihr hier: Docker auf DSM im Synology NAS installieren
(Optional) Eine SSH-Software und die entsprechenden Zugriffsrechte. Siehe hier: SSH aktivieren
(Optional) Portainer um den Container komfortabel zu verwalten. Anleitung dazu findest du hier: Portainer installieren

Unterstützung

Hey! Unterstütze mich und hilf mir, weiter großartige Inhalte zu erstellen, indem du mir auf X und YouTube folgst – so bleibst du immer auf dem Laufenden! Deine Unterstützung bedeutet die Welt für mich und hilft dabei, die Community weiter auszubauen. 😊

Vielen lieben Dank.

Vorbereitung #1 – Anmeldung

Melde dich bitte zuerst auf deiner Synology im DSM an, um mit den nächsten Schritten fortzufahren. Öffne dafür einfach die URL deiner Synology im Browser. 😊

HTTPS [Yezz-Media.de]

http://ipvondeinernas:5000 # Ohne https
https://ipvondeinernas:5001 # mit https

# Beispiel mit meiner Synology
https://192.168.188.180:5001 # Das wird bei euch jedoch nicht funktionieren. Dies dient nur als Beispiel.

Jetzt füllt Ihr den „Benutzername / Username“ aus und klickt auf das Feld mit dem Pfeil nach rechts.

Jetzt füllt Ihr das „Passwort“ aus und klickt auf das Feld mit dem Pfeil nach rechts. Damit seid Ihr dann eingeloggt und könnt fortfahren.

Vorbereitung #2 – Ordner erstellen

Jetzt legen wir einen Ordner im Docker Standardverzeichnis an. Diesen könnt ihr natürlich frei wählen aber ich empfehle euch einen treffenden Namen zu geben. „pihole“ als Name klingt doch super.

Nun benötigen wir noch 2 weitere Ordner. Diese erstellen wir exakt wie die vorherigen, nur eben im Verzeichnis „pihole“.

Eure Ordner Struktur sollte danach folgend aussehen.

Installationswege

Ab jetzt gibt es 3 Wege wie Sie „Pi-hole“ installieren können. Ich empfehle Ihnen den ersten Weg (Portainer). Bei diesem Weg ist die Wartung um einiges besser als bei den anderen Wegen. Alle Wege führen jedoch zum Ziel und haben Ihre Daseinsberechtigung.

Installation mit Portainer
Installation mit dem Container Manager
Installation mit SSH | Aufgabenplaner

Weg 1 – Portainer

Zuerst müssen wir uns dazu in Portainer einloggen und unsere Umgebung im Webinterface aktivieren. Solltest du Portainer noch nicht installiert haben, so lege ich dir gerne meine Anleitung ans Herz. Darin findest du den genauen Weg wie du Portainer auf deiner Synology in DSM installierst.

Portainer installieren

Rufe nun also die Weboberfläche von Portainer auf. Gebt jetzt den „Benutzernamen“ und das „Passwort“ ein und klickt auf „Login„.

HTTPS [Yezz-Media.de]

http://ipvondeinernas:9000

# Beispiel mit meiner Synology
http://192.168.188.180:9000 # Das wird bei euch jedoch nicht funktionieren. Dies dient nur als Beispiel.

Danach klickt Ihr auf „Live connect“ um euch mit der aktuellen Umgebung zu verbinden.

Jetzt erstellen wir einen neuen Stack. Das ist quasi der Überbegriff für das neue Programm welches wir hinzufügen wollen.

Stacks >>> + Add stack

Jetzt geben wir unseren Namen für das Projekt ein und fügen den Inhalt der YML Datei hinzu. Ich habe dies schon für euch vorbereitet.

Name: pihole

YAML – [Yezz-Design.de]

################################################
##                                            ##
##     URL/Author: Yezz-Media.de              ##
##     E-Mail: info@yezz-media.de             ##
##     Bitte bewertet meine Arbeit.           ##
##             Vielen Dank                    ##
##                                            ##
################################################
---
name: ym-pihole
services:
    pihole:
        image: pihole/pihole # Das zu downloadende Image
        network_mode: host
        container_name: ym-pihole # Der anzuzeigende Containername
        volumes:
            - /volume1/docker/pihole/dnsmasq.d:/etc/dnsmasq.d
            - /volume1/docker/pihole/pihole:/etc/pihole
        environment:
            - WEB_PORT=8080
            - WEBPASSWORD=yezz-design # Bitte ändert das Password; Info in der Notiz
            - WEB_BIND_ADDR=192.168.188.180 # Bitte auf euren Port ändern; Info in der Notiz
            - DNSMASQ_USER=root
            - DNSMASQ_LISTENING=local
            - TZ=Europe/Berlin # Eure Zeitzone
        restart: unless-stopped

Benutzt gerne den gleichen Namen den Ihr auch für den Ordner genutzt habt. Damit ist es einfacher diesen später zu warten und wiederzufinden.

Anmerkung: Bitte ändert unbedingt das Passwort von „WEBPASSWORD“ zu einem sicheren von euch gewählten Passwort.

Anmerkung: Bitte ändert unbedingt die IP von „WEB_BIND_ADDR“ zu eurer IP von eurer Synology.

Nachdem Ihr die Daten korrekt eingegeben habt, könnt Ihr die Daten „deployen“ also freigeben.

Nachdem Ihr draufgeklickt habt, wird im Hintergrund das Image heruntergeladen und alle Daten installiert. Im Grunde seid Ihr jetzt hiermit durch. Glückwunsch. Hier geht es weiter wenn Ihr Pi-hole einrichten wollt. >> KLICK <<

Weg 2 – Container Manager

Wenn Ihr Pi-hole über den Container Manager installieren wollt, dann müsst Ihr nur noch diesen Weg hier gehen und eine compose.yml erstellen oder schon fertig haben. Gerne könnt Ihr natürlich auch meine benutzen.

Zuerst öffnet Ihr den Container Manager über das Hauptmenü und geht auf „Projekt“ und danach auf „Erstellen“.

Nun müsst ihr alle Daten für das Projekt mit angeben. Also den Namen des Projektes, auf welchem Pfad die Konfigurationsdateien liegen sollen (dies kann auch einfach im Installationspfad sein) sowie auch die Quelle. In unserem Fall ist die Quelle eine selbst erstellte YAML Datei. Den Code zu der Datei könnt Ihr hier entnehmen:

YAML – [Yezz-Design.de]

################################################
##                                            ##
##     URL/Author: Yezz-Media.de              ##
##     E-Mail: info@yezz-media.de             ##
##     Bitte bewertet meine Arbeit.           ##
##             Vielen Dank                    ##
##                                            ##
################################################
---
name: ym-pihole
services:
    pihole:
        image: pihole/pihole # Das zu downloadende Image
        network_mode: host
        container_name: ym-pihole # Der anzuzeigende Containername
        volumes:
            - /volume1/docker/pihole/dnsmasq.d:/etc/dnsmasq.d
            - /volume1/docker/pihole/pihole:/etc/pihole
        environment:
            - WEB_PORT=8080
            - WEBPASSWORD=yezz-design # Bitte ändert das Password; Info in der Notiz
            - WEB_BIND_ADDR=192.168.188.180 # Bitte auf euren Port ändern; Info in der Notiz
            - DNSMASQ_USER=root
            - DNSMASQ_LISTENING=local
            - TZ=Europe/Berlin # Eure Zeitzone
        restart: unless-stopped

Beim nächsten Schritt müsst ihr nun auswählen ob die Webstation eure Ports ändern und mitunter von außen erreichbar machen soll. Dies ist in unserer Konfikuration jedoch nicht erforderlich.

Jetzt noch die Zusammenfassung akzeptieren.

Und wir sehen im letzten Schritt eine Art Konsolenfenster mit dem Fortschritt der Installation.

Schon haben wir es geschafft und wir haben einen neuen Container im Container-Manager verfügbar. Bitte beachtet hierbei, dass die Installation gut und gerne mal 10 Minuten und mehr dauern kann, je nachdem wie schnell eure Internetleitung ist und wie stark eure Synology ausgelastet ist. Wie du die Einrichtung von „Pi-hole“ fortsetzt findest du hier.

Einrichtung von „Pi-hole“

Weg 3 – SSH / Aufgabenplaner

Um ein Projekt über SSH zu erstellen müssen Sie natürlich SSH auf Ihrem NAS eingerichtet haben. Wie das geht haben wir hier schon einmal zusammen erklärt.

SSH Aktivieren / Deaktivieren

Die Installation über den Aufgabenplaner benutzt den gleichen Code wie über SSH. Der große Vorteil ist hier, dass man kein extra Programm installieren muss. Für den Weg des Aufgabenplaners gehen Sie bitte nach dieser Anleitung –Anleitung für den Aufgabenplaner– vor. Wenn Sie dort an der Stelle 12 angekommen sind, so können Sie das Script aus diesem Beitrag entnehmen. Sie finden dies etwas weiter unten oder über diesen Link.

Zuerst verbinden wir uns über den SSH – Login mit unserem NAS. Dazu schreiben Sie ssh und ein Leerzeichen. Danach folgt Ihr benutzername@ipvomnas. Danach müsst Ihr natürlich euer Passwort eingeben und schon sind wir eingeloggt.

SSH – [Yezz-Media.de]

ssh benutzer@ipvomnas 

ssh Yezz@192.168.188.180 #das wäre der Befehl wenn ich mich verbinden würde. Dies wird jedoch bei Ihnen nicht funktionieren.

Jetzt vergeben wir an uns die Admin-Rechte. Das machen wir mit dem sudo Befehl. Bitte beachtet, dass wir danach komplette Root rechte haben und eine Menge kaputt machen können. Seid bitte extrem sorgsam wenn Ihr dies nutzt.

SSH – [Yezz-Media.de]

sudo -i

Nach der Eingabe müssen wir erneut das Passwort eingeben. Nur um sicher zu gehen.

Jetzt können wir auch schon unser Skript einfügen. Achtet darauf die Kopierfunktion aus dem Codebereich zu nutzen um keine Formatierungsfehler zu übernehmen.

So sieht dies dann in der Konsole aus wenn Ihr alles richtig gemacht habt.

Einrichtung von „Pi-hole„

Für die Einrichtung geht es weiter in Teil 2

Pi-Hole jetzt richtig installieren. Perfekte Anleitung für Synology DSM und Docker! *Update 2025