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.
- 01recondistro et version : apt (Debian/Ubuntu) ou dnf (RHEL/Fedora/Rocky/Alma) ?
- 02reconnginx présent ? quelle version ?
- 03reconun vhost pour ce domaine existe-t-il déjà (où) ? ne pas l’écraser
- 04reconl’upstream répond-il ? (000 = rien n’écoute)
- 05reconSELinux Enforcing ? (RHEL : httpd_can_network_connect requis)
- 06reconun pare-feu (ufw ou firewalld) est-il actif ?
- 07agirInstaller nginx (si absent)vérif
- 08agirÉcrire le vhostvérif
- 09agirActiver le vhostvérif
- 10agirRechargervérif
- 11agirOuvrir 80/443 (seulement si un pare-feu est actif)vérif
- 12agirLe proxy 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érifInstaller nginx (si absent)Vérifié par
nginx -v 2>&1attendu : nginx version: nginx/… - 02vérifÉcrire le vhostVérifié par
test -f /etc/nginx/sites-available/${domain} -o -f /etc/nginx/conf.d/${domain}.conf && echo okattendu : ok - 03vérifActiver le vhostVérifié par
nginx -t 2>&1 | tail -1attendu : test is successful - 04vérifRechargerVérifié par
systemctl is-active nginxattendu : active - 05vérifOuvrir 80/443 (seulement si un pare-feu est actif)Vérifié par
ufw status 2>/dev/null | grep -E "^(80|443)/tcp"; firewall-cmd --list-services 2>/dev/null; trueattendu : 80/tcp et 443/tcp ALLOW, ou http https dans firewalld, ou aucun pare-feu actif - 06vérifLe proxy répondVérifié par
curl -s -o /dev/null -w '%{http_code}' -H 'Host: ${domain}' http://127.0.0.1/attendu : le code de l’upstream (pas 502/504)
SEC.03
Les garde-fous
Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.
Valide toujours (nginx -t) avant reload ; si le test échoue, restaure la sauvegarde et arrête. N’écrase pas un vhost existant sans sauvegarde. Ne modifie pas les autres vhosts. Le TLS s’ajoute ensuite via setup-letsencrypt.
SEC.04
Les variables
Ce que vous choisissez avant de lancer — la recette s'occupe du reste.
| Nom | Signification |
|---|---|
| ${domain} | Domaine |
| ${upstream} | Upstream (host:port) |
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 nginx reverse proxy 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.
SEC.07
D'autres recettes serveur web
- 01nginxServeur web nginx, démarré, activé au boot et vérifié.
- 02CaddyCaddy avec HTTPS automatique pour un domaine.
- 03Apache httpdServeur web Apache, démarré, activé et vérifié.
- 04HAProxyLoad balancer HAProxy, démarré et vérifié.
- 05TraefikReverse proxy Traefik via Docker, avec le dashboard et TLS automatique.
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.