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.
- 01reconAdGuard Home déjà installé ? (alors vérifie et saute)
- 02reconqui tient le port 53 (systemd-resolved ?) et le port 3000
- 03reconrésolveur actuel du serveur (doit continuer à fonctionner)
- 04reconarchitecture (amd64, arm64, armv7…)
- 05agirTélécharger AdGuard Homevérif
- 06agirInstaller dans /opt/AdGuardHomevérif
- 07agirLibérer le port 53 (seulement si systemd-resolved le tient)destructifvérif
- 08agirInstaller le servicevérif
- 09agirL’assistant d’installation 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érifTélécharger AdGuard HomeVérifié par
tar -tzf /tmp/AdGuardHome.tar.gz | grep -c 'AdGuardHome/AdGuardHome$'attendu : 1 - 02vérifInstaller dans /opt/AdGuardHomeVérifié par
/opt/AdGuardHome/AdGuardHome --versionattendu : AdGuard Home, version v0.… - 03vérifLibérer le port 53 (seulement si systemd-resolved le tient)Vérifié par
getent ahosts static.adtidy.org | head -1attendu : une IP (le serveur résout toujours) - 04vérifInstaller le serviceVérifié par
systemctl is-active AdGuardHomeattendu : active - 05vérifL’assistant d’installation répondVérifié par
curl -sL -o /dev/null -w '%{http_code}' http://127.0.0.1:3000/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. Ne fais jamais pointer le résolveur du serveur vers AdGuard Home (pas de DNS=127.0.0.1 dans resolved). Pas de `curl | sh`. Dis à l’utilisateur de finir l’assistant via `ssh -L 3000:127.0.0.1:3000`, en gardant l’interface web sur 127.0.0.1:3000 et le DNS sur une IP LAN/VPN : n’ouvre jamais le port 53 au public (résolveur ouvert).
SEC.04
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.05
Bouton Deploy on Servor
Vous maintenez AdGuard Home 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-adguardhome)SEC.06
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.
- 03Pi-holePi-hole v6 (DNS + blocage de pubs) en conteneur, sur l’IP choisie. Destructif en écoute 0.0.0.0 (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.