Aller au contenu
local-cert
Parcourir la documentation

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.

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. 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: web

ou 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:ro

2. 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=localcert

Traefik 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 httpChallenge doit 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 DEBUG reproduisent l'erreur ACME renvoyée par local-cert — voir le tableau de dépannage dans Serveur ACME.