Aller au contenu
local-cert
Parcourir la documentation

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.

ValeurOù la trouverDans ce guide
Directory ACMEfixe pour chaque instancehttps://certs.example.com/acme/directory
Key ID (kid)Clés & droits → Identifiants EABeab_XXXXXXXXXXXXXXXX
Clé HMACaffichée une seule fois à la créationCLE_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 nginx

3. 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-run

Variantes

  • 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/letsencrypt monté dans les deux, et remplacez le hook par docker exec nginx nginx -s reload.