Nginx
Nginx ne demande pas de certificats lui-même dans la plupart des installations : un client ACME tourne à côté, écrit les fichiers et recharge Nginx. certbot est le choix habituel.
| Valeur | Où la trouver | Dans ce guide |
|---|---|---|
| Directory ACME | fixe pour chaque instance | https://certs.example.com/acme/directory |
| Key ID (kid) | Clés & droits → Identifiants EAB | eab_XXXXXXXXXXXXXXXX |
| Clé HMAC | affichée une seule fois à la création | CLE_HMAC |
1. Obtenir le certificat
Nginx occupe le port 80 : utilisez le mode webroot vers un dossier vide. Il n'a pas besoin d'être servi par Nginx, local-cert ne vient pas y lire.
certbot
mkdir -p /var/lib/letsencrypt/webroot
certbot certonly --webroot -w /var/lib/letsencrypt/webroot -d nas.home.example.com \
--server https://certs.example.com/acme/directory \
--eab-kid eab_XXXXXXXXXXXXXXXX --eab-hmac-key CLE_HMAC \
--email ops@example.com --agree-tos --no-eff-email \
--deploy-hook "systemctl reload nginx"2. Brancher Nginx dessus
/etc/nginx/conf.d/nas.home.example.com.conf
server {
listen 443 ssl;
http2 on;
server_name nas.home.example.com;
ssl_certificate /etc/letsencrypt/live/nas.home.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/nas.home.example.com/privkey.pem;
location / {
proxy_pass http://192.168.1.50:5000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
server {
listen 80;
server_name nas.home.example.com;
return 301 https://$host$request_uri;
}vérifier et recharger
nginx -t && systemctl reload nginx3. Renouvellement
Le paquet certbot installe un timer qui lance certbot renew deux fois par jour. Le serveur ACME, l'EAB et le --deploy-hook sont mémorisés : Nginx est rechargé à chaque renouvellement. Test à blanc :
certbot
certbot renew --dry-runVariantes
- acme.sh plutôt que certbot : même principe, voir certbot, acme.sh, lego.
- Nginx en conteneur : faites tourner certbot sur l'hôte (ou dans son propre conteneur) avec
/etc/letsencryptmonté dans les deux, et remplacez le hook pardocker exec nginx nginx -s reload.