SEC.01
Le playbook
Le run démarre en lecture seule : les sondes de reconnaissance décident de la suite. Les étapes qui suivent sont adaptées à la distribution et à l'état trouvés — une vraie machine est rarement propre.
- 01reconDocker et le plugin compose présents (prérequis)
- 02reconPi-hole déjà installé (natif ou conteneur) ? alors vérifie et saute
- 03reconqui tient le port 53 et sur quelle adresse (systemd-resolved sur 127.0.0.53 ?)
- 04reconrésolveur actuel du serveur (doit continuer à fonctionner)
- 05reconl’IP d’écoute demandée existe bien sur une interface
- 06reconfuseau horaire
- 07agirGénérer le mot de passe adminvérif
- 08agirLibérer le port 53 (seulement si l’IP d’écoute est 0.0.0.0)destructifvérif
- 09agirÉcrire /opt/pihole/compose.yamlvérif
- 10agirLancer Pi-holevérif
- 11agirLe DNS répondvérif
- 12agirL’interface web répondvérif
SEC.02
Ce qu'elle vérifie
Chaque étape embarque sa propre vérification. Le run ne continue que si elle passe, donc ce que la recette annonce comme fait est ce qui est réellement sur le serveur.
- 01vérifGénérer le mot de passe adminVérifié par
stat -c %a /opt/pihole/.envattendu : 600 - 02vérifLibérer le port 53 (seulement si l’IP d’écoute est 0.0.0.0)Vérifié par
getent ahosts download.docker.com | head -1attendu : une IP (le serveur résout toujours) - 03vérifÉcrire /opt/pihole/compose.yamlVérifié par
docker compose -f /opt/pihole/compose.yaml config -q && echo okattendu : ok - 04vérifLancer Pi-holeVérifié par
docker inspect -f '{{.State.Health.Status}}' piholeattendu : healthy (attendre jusqu’à ~60 s) - 05vérifLe DNS répondVérifié par
dig +short +time=3 @${listen_ip} example.com | head -1attendu : une IP - 06vérifL’interface web répondVérifié par
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:${web_port}/admin/attendu : 200
SEC.03
Les garde-fous
Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.
Ne casse jamais la connectivité du serveur : pas de changement de la route par défaut, de /etc/resolv.conf ou des règles qui laissent sortir l’agent Servor et la session SSH. Compare la route par défaut et la résolution DNS avant/après. Si Docker manque : arrête-toi et indique la recette « Docker Engine ». Ne fais jamais pointer le résolveur du serveur lui-même vers Pi-hole. N’ouvre jamais le port 53 au public (résolveur ouvert) : écoute sur une IP LAN/VPN, ou 127.0.0.1. Un Pi-hole natif existant → vérifie et saute. Le mot de passe admin est dans /opt/pihole/.env : indique ce chemin, ne l’affiche pas.
SEC.04
Les variables
Ce que vous choisissez avant de lancer — la recette s'occupe du reste.
| Nom | Signification |
|---|---|
| ${listen_ip} | IP d’écoute DNS |
| ${web_port} | Port local de l’interface web |
SEC.05
Comment une recette s'exécute dans Servor
Servor est zero-knowledge : la plateforme ne peut rien exécuter seule. Quand vous lancez cette recette, un run lit la reconnaissance, planifie les étapes et demande votre validation. Chaque commande approuvée est signée par votre navigateur — avec une clé que le serveur ne voit jamais — puis relayée telle quelle à l'agent, qui vérifie la signature localement avant d'exécuter.
recherche par intention — tapez « firewall », obtenez ufw
- 01Reconnaissance en lecture seule avant tout changement
- 02Chaque commande signée par votre navigateur, validée par vous
- 03Chaque étape vérifiée avant de continuer, chaque run conservé dans l'historique
SEC.06
Bouton Deploy on Servor
Vous maintenez Pi-hole ou un projet qui en dépend ? Ajoutez ce bouton à votre README ou à votre site : en un clic, vos utilisateurs l'installent sur leur propre serveur.
Fond sombre
Fond clair[](https://servor.app/deploy/install-pihole)SEC.07
D'autres recettes réseau
- 01TailscaleVPN mesh Tailscale : auth key ou lien de connexion, sans toucher au DNS du serveur.
- 02WireGuardServeur VPN WireGuard + un premier client, sans toucher au routage. Destructif : interface réseau.
- 03AdGuard HomeDNS filtrant AdGuard Home, interface en local. Destructif : peut libérer le port 53.
- 04OpenVPNServeur OpenVPN via le script road-warrior (angristan), premier client créé. Destructif : réseau.
- 05Résolveur DNS (Unbound)Résolveur DNS récursif validant (DNSSEC) Unbound, sur localhost.
Recette vérifiée
Lancez cette recette sur votre serveur
Connectez un serveur, lancez la recette, et validez chaque étape pendant que Servor exécute et vérifie. Plan gratuit, sans carte bancaire.