Traefik
Traefik (v2 et v3) gère une CA personnalisée et l'EAB dans ses resolvers de certificats. Il suffit d'en déclarer un qui pointe sur local-cert.
| 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. Déclarer le resolver
Dans la configuration statique, en fichier :
traefik.yml
entryPoints:
web:
address: ":80"
websecure:
address: ":443"
certificatesResolvers:
localcert:
acme:
caServer: https://certs.example.com/acme/directory
email: ops@example.com
storage: /letsencrypt/localcert.json
eab:
kid: eab_XXXXXXXXXXXXXXXX
hmacEncoded: CLE_HMAC
httpChallenge:
entryPoint: webou en arguments, pour un conteneur :
docker-compose.yml (extrait)
services:
traefik:
image: traefik:v3
command:
- --entrypoints.web.address=:80
- --entrypoints.websecure.address=:443
- --providers.docker=true
- --certificatesresolvers.localcert.acme.caserver=https://certs.example.com/acme/directory
- --certificatesresolvers.localcert.acme.email=ops@example.com
- --certificatesresolvers.localcert.acme.storage=/letsencrypt/localcert.json
- --certificatesresolvers.localcert.acme.eab.kid=eab_XXXXXXXXXXXXXXXX
- --certificatesresolvers.localcert.acme.eab.hmacencoded=CLE_HMAC
- --certificatesresolvers.localcert.acme.httpchallenge.entrypoint=web
volumes:
- ./letsencrypt:/letsencrypt
- /var/run/docker.sock:/var/run/docker.sock:ro2. L'utiliser sur un routeur
labels du service
labels:
- traefik.enable=true
- traefik.http.routers.nas.rule=Host(`nas.home.example.com`)
- traefik.http.routers.nas.entrypoints=websecure
- traefik.http.routers.nas.tls.certresolver=localcertTraefik demande le certificat au premier démarrage du routeur, puis le renouvelle seul (30 jours avant l'échéance par défaut).
À savoir
- L'entrypoint désigné par
httpChallengedoit exister, mais il ne recevra aucune requête de validation : inutile de l'exposer hors du LAN. - L'émission prend une à trois minutes. Pendant ce temps Traefik sert son certificat par défaut ; c'est normal.
- Pour un joker, déclarez les noms sur le routeur avec
tls.domains[0].main/sans. Si Traefik refuse le joker en HTTP-01, émettez-le par l'API. - En cas d'échec, les journaux de Traefik au niveau
DEBUGreproduisent l'erreur ACME renvoyée par local-cert — voir le tableau de dépannage dans Serveur ACME.