certbot, acme.sh, lego
Les trois clients en ligne de commande. Ils suffisent à équiper n'importe quelle machine, et la plupart des intégrations des autres guides reposent sur l'un d'eux.
| 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 |
certbot
Port 80 libre sur la machine : mode autonome.
certbot certonly --standalone -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-emailPort 80 occupé : mode webroot, vers un dossier vide.
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"Les fichiers arrivent dans /etc/letsencrypt/live/nas.home.example.com/. Le serveur et l'EAB sont mémorisés dans le fichier de renouvellement : le timer certbot renew installé par le paquet renouvelle sans autre réglage. Vérifiez avec certbot renew --dry-run.
acme.sh
L'enregistrement du compte est une étape séparée, faite une fois par machine.
# 1. compte, avec l'EAB
acme.sh --register-account --server https://certs.example.com/acme/directory \
--eab-kid eab_XXXXXXXXXXXXXXXX --eab-hmac-key CLE_HMAC -m ops@example.com
# 2. émission (webroot vers un dossier vide)
mkdir -p /var/lib/acme-webroot
acme.sh --issue --server https://certs.example.com/acme/directory \
-d nas.home.example.com -w /var/lib/acme-webroot
# 3. installation des fichiers et commande de rechargement
acme.sh --install-cert -d nas.home.example.com \
--key-file /etc/ssl/private/nas.home.example.com.key \
--fullchain-file /etc/ssl/certs/nas.home.example.com.pem \
--reloadcmd "systemctl reload nginx"Avec le port 80 libre, remplacez -w … par --standalone (socat requis). Le renouvellement passe par la tâche cron installée par acme.sh ; le dossier webroot doit donc exister durablement, d'où un chemin hors de /tmp.
lego
lego --server https://certs.example.com/acme/directory \
--eab --kid eab_XXXXXXXXXXXXXXXX --hmac CLE_HMAC \
--email ops@example.com --accept-tos \
--http --domains nas.home.example.com \
runLes fichiers arrivent dans ./.lego/certificates/. lego n'installe pas de tâche planifiée : programmez vous-même la même commande terminée par renew --days 30. Avec le port 80 occupé, ajoutez --http.webroot /var/lib/acme-webroot.
Vérifier
openssl x509 -in /etc/letsencrypt/live/nas.home.example.com/fullchain.pem -noout -issuer -subject -enddateL'émetteur doit être Let's Encrypt (ou (STAGING) tant que local-cert est en environnement de test). Le certificat apparaît aussi dans Certificats.