Jahresrückblick 2025 – unser neuer Blogbeitrag ist online! ✨

[MartinP]

Muss ich mir anschauen, die API habe ich noch nicht genutzt, habe die Basteleien bisher in der Web-Oberfläche von Pi-Hole gebaut ...

Möglicherweise muss ich da auch noch einmal von vorne anfangen, und PiHole komplett neu aufsetzen..

Läuft derzeit in einer sehr indirekten Installation Proxmox -> LXC-Container -> Docker ->PiHole

Solle MACVLAN benutzen, sonst könne man gar keine Randscharfe Zuordnung zu Clients gewährleisten.

[OliverIO]

@MartinP

nicht du sollst dich mit der api beschäftigen.
du sollst nur schauen wie du dein ziel mit der web oberfläche (=gui, graphical user interface) umsetzen kannst.

wenn du das beschreiben kannst, kann man schauen was man damit im adapter machen kann.

für macvlan musst du eigentlich nicht nneu installieren.
das ist reine docker konfiguration.
wie das mit Proxmox/LXC aussieht weiß ich allerdings nicht, da dann der Netzwerkverkehr nochmal durch eine weitere schicht durchgeführt wird.

ich gehe mal davon aus, das man in pihole irgendwas mit client zu gruppen zuordnung machen muss und dann clients dynamisch zu gruppen zuordnet oder wieder rausnimmt um dann blocking ein/auszuschalten

[BananaJoe]

@MartinP sagte in Neuer Adapter pi-hole2 für pihole>=V6:

Blocking nur für ein/mehrere Client-Device (sein Notebook, sein Gaming-PC, sein Smartphone) temporär generell aufheben
Temporär ein Profil aktivieren, was die Google-Adlinks generell durchlässt

Naja, Die Möglichkeit temporär Pi-Hole zu deaktivieren (für x Minuten oder Stunden) ist in der GUI eingebaut. Ob das über die API geht ... vermutlich.

Hier hat einer ein Bash-Skript gebaut welches Gruppen per API aktiviert oder deaktiviert:
https://gist.github.com/Data-Monkey/d88199a51feb715f7d67a47900c846bb
Ein Client kann ja in mehreren Gruppen sein, wenn der also zusätzlich in einer Gruppe ist bei der nicht gefiltert ist, könnte man das über diesen Weg ein- und ausschalten (vermutlich)

[OliverIO]

@BananaJoe sagte in Neuer Adapter pi-hole2 für pihole>=V6:

Naja, Die Möglichkeit temporär Pi-Hole zu deaktivieren (für x Minuten oder Stunden) ist in der GUI eingebaut. Ob das über die API geht ... vermutlich.

ja das geht und ist im aktuellen pihole adapter per datenpunkt eingebaut.

[OliverIO]

@BananaJoe sagte in Neuer Adapter pi-hole2 für pihole>=V6:

Hier hat einer ein Bash-Skript gebaut welches Gruppen per API aktiviert oder deaktiviert:
https://gist.github.com/Data-Monkey/d88199a51feb715f7d67a47900c846bb
Ein Client kann ja in mehreren Gruppen sein, wenn der also zusätzlich in einer Gruppe ist bei der nicht gefiltert ist, könnte man das über diesen Weg ein- und ausschalten (vermutlich)

woher weiß die gruppe dann was geblockt werden soll?
oder geht da nur alles blocken oder nix?

[BananaJoe]

@OliverIO sagte in Neuer Adapter pi-hole2 für pihole>=V6:

woher weiß die gruppe dann was geblockt werden soll?
oder geht da nur alles blocken oder nix?

Naja, du setzt den Client in 2 Gruppen.
In die Normale wo alles gefiltert wird,
und die eine wo nichts gefiltert wird.

Und die Gruppe bei der nichts gefiltert wird schaltet man an oder aus nach Bedarf.
In der Hoffnung das das "Rechtemanagement" von pi-hole addierend arbeitet,
Testen müsste man das.
Da es aber auch bei Blockieren funktioniert, könnte auch der umgekehrte Weg möglich sein

[OliverIO]

@BananaJoe

ok, das kann @MartinP dann testen und Rückmeldung geben.

Dann könnte man für jede Gruppe einen Bool Datenpunkt anlegen um die zu aktivieren/deaktivieren.
Falls die Zugehörigkeit zu einer Gruppe darüber bestimmt ob geblockt wird oder nicht könnte man ein sendTo Befehl machen, bei dem ein client dann (ggfs auch zeitbasiert) zwischen Gruppen hin und hergeschoben wird.

[BananaJoe]

@OliverIO Ein Client kann ja auch in mehreren Gruppen sein.
Theoretisch auch in einer "Keine Filterung" und "Blockiert".
Was gewinnt weis ich ohne Tests nicht, bei einer Firewall würde blockieren gewinnen oder die Reihenfolge entscheiden.
Dann bräuchte es das hin und herswitchen zwischen gruppen nicht

[OliverIO]

@BananaJoe

Aber ist alles Vermutung basierend auf Vermutung.
Wie gesagt:
Ausprobieren wie das über die über das Userinterface zu bedienen ist, dann kann man schauen wie man das über die API bewerkstelligt, so das es alle über die üblichen iobroker Methoden einfachst zu bedienen ist und auf Knöpfe/Schalter/etc. zu legen ist.

[BananaJoe]

So, mal eben remote zu Hause drauf und extra getestet,
Wenn ein Client sowohl in der Default-Gruppe ist (bei der Standardmäßig gefiltert wird) und in einer Gruppe bei der nicht gefiltert wird,
dann wird trotzdem gefiltert.
Erst wenn ich ihn aus Default herausnehme geht es.

Wie üblich gewinnt verbieten vor erlauben

[BananaJoe]

Da hatte ich auch einen Denkfehler. Die Blocklisten sind Gruppen zugeordnet, ist man Mitglied der Gruppe, wird diese auch angewandt.
Der Trick mit einer Gegenregel / Ausnahme die nur für die Gruppe gilt, funktioniert nicht

[OliverIO]

@BananaJoe

also wird eine funktion benötigt, die einen user von einer gruppe zu einer anderen schiebt. ggfs kann ein user auch in mehreren gruppen aktiv sein um evtl teilweise sperren aufrecht zu erhalten

default: alles wird gesperrt
gruppe 1: liste A (windows nach Hause telefonieren)
gruppe 2: liste B (listen mit google adsense etc. werbung)
gruppe 3: keine Liste, also keine Sperrung

Szenario1
user ist zu beginn in gruppe 1 und 2 um alles ungewünschte zu sperren
temporär soll user überhaupt keine sperre haben, also wird user von 1 nach 3 gesetzt und 2 gelöscht

Szenario2
oder einfach nur von 2 nach 3, 1 bleibt erhalten um nur ein teilweises blocken zu erlauben.
bspw windows telefoniert nach hause soll immer unterdrückt werden, aber google shopping manchmal deaktiviert werden um auf die gesponsorten links oder produktvorschläge zu klicken

default ist dann nur der fallback für die clients für die keine bersondere behandlung erfolgen soll.

@MartinP kannst du das verifizieren ob das für dich passen würde?

[Meister Mopper]

Da die API von Pi-hole v6 nicht den Abruf der insgesamt geblockten unique domains vorsieht, habe ich mich mal mit einer KI auf die Suche gemacht und eine Lösung vermittels Abfrage der sqlite3-Datenbank des Pi-hole gefunden.

Diese wird mit einem exec-Befehl vermittels Skript initiiert. Das funktioniert natürlich nur, wenn der Systemuser iobroker auch einen passwortfreien ssh-Zugriff vermittels Schlüssel auf den Pi-hole Server hat und im Javascript-Adapter exec aktiviert wurde.

Zur Erläuterung:
Ich habe zwei Pi-hole Server laufen, deshalb werden hier täglich zwei Datenpunkte befüllt (das muss dann nach eigenen Bedürfnissen angepasst werden).

Hier das Skript:

👀

// Konfiguration der Pi-hole Server und Datenpunkte
const piholeServers = [
   // Struktur: 0_userdata.0.Pihole.piholeX.UniqueGravityDomains
   { host: 'pihole', datapoint: '0_userdata.0.Pihole.pihole0.UniqueGravityDomains' },
   { host: 'rpifr24', datapoint: '0_userdata.0.Pihole.pihole1.UniqueGravityDomains' }
];

// Funktion zum Erstellen der Datenpunkte, falls diese noch nicht existieren
function createDataPoints() {
   piholeServers.forEach(server => {
       createState(server.datapoint, 0, {
           name: `Anzahl der einzigartigen Domains auf ${server.host}`,
           type: 'number',
           role: 'value',
           unit: 'Domains'
       });
   });
   console.log("Struktur der Pi-hole Datenpunkte erstellt oder geprüft.");
}

// Hauptfunktion zum Abrufen und Aktualisieren der Daten
function updatePiHoleData() {
   console.log("Starte tägliche Pi-hole Datenaktualisierung...");

   // SQL-Befehl: Jetzt werden die inneren doppelten Anführungszeichen escaped,
   // während die einfachen Anführungszeichen ('gravity_count') direkt stehen bleiben können,
   // da sie vom äußeren Doppel-Anführungszeichen-Kontext geschützt werden.
   const sqlQuery = "SELECT value FROM info WHERE property = 'gravity_count';"; 

   piholeServers.forEach(server => {
       // ENDGÜLTIGE LÖSUNG: Äußeres JS-Kommando in Backticks.
       // Das SSH-Kommando wird von doppelten Anführungszeichen (`"`) umschlossen.
       // Die innere Anführungszeichenstruktur muss von der Datenbank die einfachen Anführungszeichen erhalten.
       const command = `ssh thomas@${server.host} "sudo pihole-FTL sqlite3 /etc/pihole/gravity.db \\"${sqlQuery}\\""`;
       // HINWEIS: Dies ist die robusteste Form der Verschachtelung, die die innere einfache Anführungszeichenkette
       // an die SQLite-Engine weitergibt, indem die äußeren Doppel-Anführungszeichen escaped werden.

       require('child_process').exec(command, function(error, stdout, stderr) {
           if (error) {
               console.error(`Fehler bei SSH-Verbindung zu ${server.host}: ${error.message}`);
               console.error(`[${server.host}] Fehlerdetails: ${stderr}`);
               return;
           }
           if (stderr) {
               console.error(`Stderr von ${server.host}: ${stderr}`);
           }
           
           const domainCount = parseInt(stdout.trim(), 10);
           
           if (!isNaN(domainCount)) {
               setState(server.datapoint, domainCount, true);
               console.log(`[${server.host}] Domainanzahl erfolgreich aktualisiert: ${domainCount}`);
           } else {
               console.error(`[${server.host}] Konvertierung der Domainanzahl fehlgeschlagen: ${stdout}`);
           }
       });
   });
}

// 1. Datenpunkte beim Skriptstart erstellen/prüfen
createDataPoints();

// 2. Skript beim Start einmalig ausführen
updatePiHoleData();

// 3. Täglich um 01:25 Uhr morgens aktualisieren
// Die Cron-Syntax ist: 'Minuten Stunden * * *'
schedule('25 1 * * *', updatePiHoleData);

Vielleicht hilft es ja anderen Nerds (Huch, die Emojis können noch nicht eingefügt werden ggg).

[OliverIO]

@Meister-Mopper

vergleiche bitte dein Ergebnis mal mit der folgenden Abfrage.
top-domains hat eine count Eigenschaft. die standardmäßig auf 10 eingestellt ist, was dann auch auf dem pihole-dshboard angezeigt wird.
wenn man die zahl dann hoch genug einstellt, dann kann man das zurückgegebene array zählen.
das ist wahrscheinlich simpler wie per exec und ssh auf die Datenbank zuzugreifen.

sendTo(
    'pi-hole2.0',
    'piholeapi',
    {
        method: 'GET',
        endpoint: '/stats/top_domains?blocked=true&count=999999',
    },
    function (data) {
        console.log(data.domains.length);
    },
);

[Meister Mopper]

@OliverIO

Da komme ich leider nicht weiter, weil ich in der Pi-hole GUI keinen Token angeboten bekomme.

Spoiler

Auch mit dem ssh sudo grep -r 'WEBPASSWORD' /etc/pihole/ gefundenen Webpassword bekomme ich einen http 400 Fehler.

[OliverIO]

@Meister-Mopper

welches token?

die api gui, sowie der adapter funktioniert mit dem passwort.
das token wird automatisiert abgerufen.

adapter:

und die lokale api gui:

da ist manchmal eine kleine herausforderung die auswahl zu beginn richtig einzustellen

zunächst die folgende url anwählen
http://pihole/api/docs/#
bzw
http://<ip>/api/docs/#

dann wichtig, nicht https sondern http auswählen
und das passwort oben in das feld eintragen und login drücken.
wenn das erfolgreich grün wird, dann merkt sich die seite erst mal das passwort bis zum nächsten kompletten refresh der seite
wenn dann ein api zugriff nicht funktioniert, dann bei url noch die ip-adresse eintragen

aber das beispiel war ja eigentlich direkt für ein skript im javascript adapter gedacht.
wenn der adapter richtig eingerichtet ist und daten vom pihle bekommt, dann musst du dich da auch nicht nochmal extra anmelden