Code : MO-PLT-019 | Version : 1.1 | Date : 26 juin 2026 | Auteur : C. Legrand
¶ MO-PLT-019 -- Gérer le filtrage DNS PiHole
¶ 1. Objet
Procédures de gestion quotidienne du filtrage DNS via PiHole : consultation du dashboard, analyse des requêtes bloquées, gestion de la whitelist et des blocklists.
¶ 2. Champ d'application
| Élément | Détail |
|---|---|
| Application | PiHole v6.4.1 |
| Accès | pihole.docker.bts.sio/admin |
| Hébergement | CT 200 docker-srv (10.0.112.20) |
| Authentification | Compte admin (Vaultwarden, collection Docker) |
| Durée estimée | 5-10 minutes |
¶ 3. Prérequis
- Accès réseau au service PiHole (VLAN pédagogique ou VPN)
- Identifiants admin PiHole (Vaultwarden)
- Navigateur web moderne
¶ 4. Points clés
- Dashboard : vue globale des requêtes DNS, taux de blocage, clients actifs
- Query log : historique des requêtes avec statut (autorisé/bloqué)
- Whitelist : déblocage de domaines légitimes bloqués par erreur
- Blocklists : gestion des listes de filtrage (ajout, suppression, mise à jour)
- 593 000 domaines bloqués par défaut (listes communautaires)
¶ 5. Contenu du mode opératoire
Le PDF complet (10 pages, 5 captures) couvre :
¶ 5.1 Connexion au dashboard PiHole
Accéder à pihole.docker.bts.sio/admin et saisir le mot de passe admin.
¶ 5.2 Consultation des statistiques de filtrage
Le dashboard affiche le nombre de requêtes DNS traitées, le taux de blocage, les domaines les plus sollicités et les clients actifs.
¶ 5.3 Analyse des requêtes bloquées
Le journal des requêtes (Query Log) permet d'identifier les domaines bloqués et de vérifier le comportement du filtrage.
¶ 5.4 Gestion de la whitelist
Ajout ou retrait de domaines dans la liste d'autorisation pour débloquer un site légitime.
¶ 5.5 Gestion des blocklists
Consultation, ajout ou suppression de listes de filtrage. Mise à jour manuelle des listes si nécessaire.
¶ Voir aussi
- MO-PLT-010 — Portail des services — accès à Pi-hole depuis Homer
- MO-PLT-007 — Gestion Portainer — redémarrage du conteneur Pi-hole
- MO-PLT-012 — Connexion Uptime Kuma — vérification de la disponibilité du service DNS
- MO-NET-004 — Routage inter-VLAN OPNsense — configuration du DNS DHCP vers Pi-hole