Accueil » Formations » Administration système » Reverse proxy et HTTPS avec Traefik

Reverse proxy et HTTPS avec Traefik

Traefik Proxy est un reverse proxy et répartiteur de charge open source conçu pour les environnements de conteneurs. Placé en frontal de vos applications web, il reçoit toutes les requêtes HTTP et HTTPS, choisit l’application à laquelle les transmettre, gère les certificats TLS et applique des protections communes (authentification, en-têtes de sécurité, limitation de débit). Sa particularité est de se configurer automatiquement : il interroge Docker, Kubernetes ou un simple fichier et met à jour ses routes sans redémarrage dès qu’un service apparaît ou disparaît. Ce cours s’adresse aux administrateurs systèmes, techniciens et responsables informatiques de PME qui hébergent plusieurs applications sur un même serveur et veulent les publier proprement en HTTPS. Il suppose une connaissance de base de Linux, de Docker et de Docker Compose. Pour une présentation générale de l’outil, voir aussi notre article Traefik : le reverse proxy cloud-native.

Versions utilisées : le cours et les travaux pratiques s’appuient sur Traefik Proxy 3.7 (branche stable au moment de la rédaction, image traefik:v3.7) et sur la documentation officielle doc.traefik.io. La branche 2.11 reçoit encore des correctifs de sécurité, mais toute nouvelle installation doit partir de la v3. Les labels et options présentés ici ne s’appliquent pas tels quels à la v2 : consultez le guide de migration officiel avant de mettre à jour une ancienne installation.

1. Pourquoi un reverse proxy

Dans une PME, il est courant d’héberger sur un même serveur ou une même machine virtuelle plusieurs applications web : un outil de ticketing, un wiki, une supervision, un gestionnaire de mots de passe, une application métier. Chacune écoute sur son propre port (3000, 8080, 8443…). Exposer directement tous ces ports pose plusieurs problèmes : les utilisateurs doivent retenir des adresses avec numéro de port, chaque application gère (ou ne gère pas) son propre certificat TLS, et la surface d’attaque visible depuis l’extérieur augmente à chaque nouveau service.

Un reverse proxy résout ces problèmes en devenant le point d’entrée unique. Il écoute seul sur les ports 80 et 443, reçoit la requête du client, lit le nom d’hôte demandé (par exemple wiki.exemple.fr) ou le chemin, puis relaie la requête vers l’application interne concernée. Le client ne parle jamais directement à l’application.

Ce point de passage unique apporte plusieurs bénéfices :

  • Terminaison TLS centralisée : les certificats sont gérés à un seul endroit, avec une configuration TLS homogène.
  • Réduction de la surface exposée : seuls les ports 80 et 443 du proxy sont ouverts ; les applications restent sur un réseau interne.
  • Protections communes : authentification, filtrage par adresse IP, en-têtes de sécurité et limitation de débit s’appliquent sans modifier les applications.
  • Répartition de charge : plusieurs instances d’une même application peuvent se partager le trafic.
  • Visibilité : un journal d’accès unique et des métriques pour toutes les applications.

Les reverse proxies « classiques » comme Nginx ou HAProxy remplissent très bien ce rôle, mais leur configuration est un fichier que l’on édite à la main à chaque nouvelle application. Traefik a été conçu pour un monde où les services naissent et meurent en permanence (conteneurs, orchestrateurs) : c’est lui qui va chercher l’information.

2. Traefik en bref : configuration automatique et fournisseurs

Traefik est écrit en Go et distribué sous forme d’un binaire unique ou d’une image de conteneur officielle (traefik sur Docker Hub). Il est édité par Traefik Labs sous licence MIT ; l’éditeur propose aussi des offres commerciales (Traefik Hub) que nous n’abordons pas ici.

Son principe central est la notion de fournisseur (provider). Un fournisseur est une source de configuration que Traefik surveille en continu :

  • Docker : Traefik interroge l’API Docker, découvre les conteneurs et lit leurs labels pour savoir comment les publier.
  • Fichier (file) : un fichier ou un répertoire YAML/TOML, utile pour les services hors conteneurs et pour les réglages TLS.
  • Kubernetes : Ingress, Gateway API ou ressources propres à Traefik (CRD).
  • D’autres sources : Consul, etcd, Redis, HTTP, etc.

Quand un conteneur portant les bons labels démarre, Traefik reçoit l’événement Docker, construit la route correspondante et commence à servir l’application en quelques secondes. Quand le conteneur s’arrête, la route disparaît. Aucun redémarrage du proxy n’est nécessaire.

Traefik embarque également un tableau de bord web en lecture seule qui affiche les routes, services et middlewares actifs, avec leurs éventuelles erreurs de configuration. C’est l’outil de diagnostic le plus utile au quotidien, mais il doit être protégé (chapitre 10).

3. Les quatre briques : entryPoints, routeurs, middlewares, services

Toute la logique de Traefik repose sur quatre objets. Les comprendre, c’est comprendre 90 % de la configuration.

Schéma décrit : à gauche, le client envoie une requête vers le serveur. Elle entre dans Traefik par un entryPoint (port 80 ou 443). Un routeur examine la requête et, si sa règle correspond, la fait passer par une chaîne de middlewares (authentification, en-têtes…), puis la remet à un service qui la transmet à un ou plusieurs serveurs applicatifs à droite.

  • EntryPoint (point d’entrée) : un port réseau sur lequel Traefik écoute, par exemple web sur :80 et websecure sur :443. Les entryPoints font partie de la configuration statique.
  • Routeur (router) : il associe une règle (nom d’hôte, chemin, en-têtes…) à un service. Il précise sur quels entryPoints il écoute, s’il utilise TLS et quels middlewares appliquer.
  • Middleware : un traitement appliqué à la requête ou à la réponse avant d’atteindre le service : redirection, authentification, ajout d’en-têtes, suppression d’un préfixe de chemin, limitation de débit, filtrage IP… Les middlewares se combinent dans l’ordre où ils sont déclarés.
  • Service : il décrit comment joindre l’application réelle (une ou plusieurs URL de serveurs) et comment répartir la charge entre eux.

Avec le fournisseur Docker, Traefik crée automatiquement un service pour chaque conteneur exposé. Si le conteneur n’expose qu’un seul port, ce port est utilisé ; sinon on le précise avec le label traefik.http.services.<nom>.loadbalancer.server.port.

Bonne pratique : nommez explicitement vos routeurs, services et middlewares avec le nom de l’application (wiki, wiki-auth, wiki-headers). Le tableau de bord et les journaux deviennent immédiatement lisibles.

4. Configuration statique et configuration dynamique

Traefik distingue deux niveaux de configuration, et la plupart des erreurs de débutant viennent de leur confusion.

La configuration statique est lue une seule fois, au démarrage. Elle définit les entryPoints, les fournisseurs activés, les résolveurs de certificats (ACME), les journaux, les métriques et l’API. Elle peut être fournie par un fichier (/etc/traefik/traefik.yml par défaut), par des arguments de ligne de commande (--entryPoints.web.address=:80) ou par des variables d’environnement, mais une seule de ces méthodes à la fois. Toute modification impose un redémarrage du conteneur Traefik.

api:
  insecure: true
entryPoints:
  web:
    address: ":80"
providers:
  docker:
    exposedByDefault: false

La configuration dynamique décrit les routeurs, middlewares, services et certificats. Elle provient des fournisseurs et peut changer à chaud. Avec Docker, elle est portée par les labels des conteneurs :

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.whoami.rule=Host(`whoami.localhost`)"
  - "traefik.http.routers.whoami.entrypoints=web"

Avec le fournisseur fichier, elle est écrite en YAML dans un répertoire surveillé (option watch, activée par défaut) :

providers:
  file:
    directory: "/etc/traefik/dynamic"

L’option exposedByDefault du fournisseur Docker vaut true par défaut : tout conteneur serait alors publié automatiquement avec une règle générée à partir de son nom. En production, on la passe à false et on publie volontairement chaque application avec le label traefik.enable=true. Les moteurs compatibles avec l’API Docker, comme Podman et son socket compatible Docker, peuvent aussi servir de source au fournisseur Docker, avec quelques adaptations.

À retenir : un entryPoint ou un résolveur ACME se déclare dans la configuration statique ; un routeur, un middleware ou un certificat se déclare dans la configuration dynamique. Un label d’entryPoint posé sur un conteneur n’a aucun effet.

5. Les règles de routage

La règle d’un routeur est une expression qui décrit les requêtes qu’il accepte. Les matchers les plus utilisés sont :

  • Host(`wiki.exemple.fr`) : nom d’hôte demandé ;
  • PathPrefix(`/api`) : chemin commençant par un préfixe ;
  • Path(`/login`) : chemin exact ;
  • Header(`X-Env`, `test`) : présence d’un en-tête avec une valeur ;
  • Method(`POST`) et ClientIP(`10.0.0.0/8`).

Les matchers se combinent avec && (et), || (ou), ! (non) et des parenthèses, par exemple Host(`exemple.fr`) && PathPrefix(`/app2`). Les valeurs s’écrivent entre accents graves (backticks), ce qui impose des guillemets doubles autour du label entier dans un fichier Compose.

Priorité. Lorsque plusieurs routeurs correspondent à une même requête, Traefik retient par défaut celui dont la règle est la plus longue (en nombre de caractères). Ainsi, Host(`exemple.fr`) && PathPrefix(`/app2`) l’emporte naturellement sur Host(`exemple.fr`). On peut forcer l’ordre avec le label priority.

Préfixes de chemin. Quand une application est publiée sous un sous-chemin (/app2) alors qu’elle s’attend à être à la racine, on retire le préfixe avant de transmettre la requête avec le middleware stripPrefix. Toutes les applications ne supportent pas d’être servies ainsi (liens absolus, cookies) : un sous-domaine par application reste la solution la plus robuste.

6. HTTPS : certificats, options TLS et redirection

Pour servir une application en HTTPS, il faut un entryPoint sur le port 443, un routeur avec TLS activé et un certificat. Avec Docker, l’activation se fait par labels :

- "traefik.http.routers.whoami.entrypoints=websecure"
- "traefik.http.routers.whoami.tls=true"

Si aucun certificat ne correspond au nom demandé, Traefik présente un certificat auto-signé généré par défaut (« TRAEFIK DEFAULT CERT »). Le navigateur affiche alors une alerte : c’est le signe classique d’un certificat manquant ou d’un nom d’hôte mal écrit.

Les certificats peuvent être fournis de trois façons : déposés sous forme de fichiers (certificat interne, autorité d’entreprise), obtenus automatiquement auprès d’une autorité ACME comme Let’s Encrypt (chapitre 7), ou par un fournisseur externe. Les certificats fichiers et les options TLS se déclarent dans la configuration dynamique :

tls:
  certificates:
    - certFile: /etc/traefik/certs/lab.crt
      keyFile: /etc/traefik/certs/lab.key
  options:
    default:
      minVersion: VersionTLS12

L’option default s’applique à tous les routeurs TLS qui n’en précisent pas d’autre. Fixer la version minimale à TLS 1.2 élimine les protocoles obsolètes.

Redirection HTTP vers HTTPS. Plutôt que d’ajouter un middleware de redirection sur chaque routeur, on la déclare une fois pour toutes sur l’entryPoint web, dans la configuration statique :

entryPoints:
  web:
    address: ":80"
    http:
      redirections:
        entryPoint:
          to: websecure
          scheme: https
          permanent: true
  websecure:
    address: ":443"

Toute requête reçue en HTTP reçoit alors une réponse de redirection permanente vers la même adresse en HTTPS.

7. Let’s Encrypt et le protocole ACME

Pour un service exposé sur Internet avec un vrai nom de domaine, Traefik sait obtenir et renouveler automatiquement des certificats auprès d’une autorité compatible ACME, Let’s Encrypt en tête. On déclare un résolveur de certificats dans la configuration statique :

certificatesResolvers:
  le:
    acme:
      email: admin@exemple.fr
      storage: /letsencrypt/acme.json
      httpChallenge:
        entryPoint: web

Puis on y fait référence sur chaque routeur : traefik.http.routers.wiki.tls.certresolver=le. Au premier accès, Traefik prouve à l’autorité qu’il contrôle le domaine, obtient le certificat, le stocke dans acme.json et le renouvelle avant expiration.

Trois types de défi sont disponibles :

  • HTTP-01 (httpChallenge) : l’autorité appelle une URL sur le port 80 du domaine. Simple, mais le port 80 doit être joignable depuis Internet.
  • TLS-ALPN-01 (tlsChallenge) : la preuve passe par le port 443.
  • DNS-01 (dnsChallenge) : Traefik crée un enregistrement TXT chez votre fournisseur DNS via son API. C’est la seule méthode pour obtenir un certificat générique (*.exemple.fr) ou pour un serveur non exposé sur Internet.

Environnement de test. Let’s Encrypt applique des limites de débit. Pendant la mise au point, utilisez l’environnement de préproduction (staging), dont les certificats ne sont pas reconnus par les navigateurs mais dont les limites sont bien plus larges :

      caServer: https://acme-staging-v02.api.letsencrypt.org/directory

Une fois la configuration validée, retirez cette ligne et supprimez le fichier acme.json de test pour obtenir des certificats de production.

Bonne pratique : le fichier acme.json contient les clés privées de vos certificats et de votre compte ACME. Stockez-le sur un volume persistant (sinon chaque redémarrage redemande des certificats), restreignez ses droits et incluez-le dans vos sauvegardes.

8. Les middlewares de sécurité

Les middlewares permettent d’ajouter des protections sans toucher aux applications. Ils se déclarent une fois (par labels ou dans un fichier) puis s’attachent à un ou plusieurs routeurs avec le label traefik.http.routers.<routeur>.middlewares=a,b,c. Quand un middleware est déclaré dans le fournisseur fichier et utilisé depuis Docker, on le suffixe par son fournisseur : secheaders@file.

basicAuth protège une application par identifiant et mot de passe. Les mots de passe sont stockés sous forme de hachés (bcrypt, MD5 Apache, SHA-1) générés avec htpasswd. Dans un fichier Compose, chaque $ du haché doit être doublé ($$) pour ne pas être interprété comme une variable. L’option usersFile permet de lire les comptes depuis un fichier plutôt que depuis les labels. Pour des besoins plus avancés (authentification unique, double facteur), on utilise plutôt le middleware forwardAuth couplé à un fournisseur d’identité.

headers ajoute des en-têtes de sécurité aux réponses : HSTS (stsSeconds, stsIncludeSubdomains), frameDeny (interdit l’affichage dans une iframe), contentTypeNosniff (X-Content-Type-Options: nosniff), referrerPolicy, ainsi que des en-têtes personnalisés.

ipAllowList restreint l’accès à des plages d’adresses (sourceRange). Les autres clients reçoivent un refus (403 par défaut, modifiable avec rejectStatusCode). Si Traefik est lui-même derrière un autre proxy ou un équilibreur, l’adresse réelle du client se trouve dans l’en-tête X-Forwarded-For : on règle alors ipStrategy et, sur l’entryPoint, la liste forwardedHeaders.trustedIPs des proxys de confiance.

rateLimit limite le nombre de requêtes par client selon un algorithme de seau à jetons : average requêtes par period (1 s par défaut) en moyenne, avec une rafale maximale burst. Au-delà, les requêtes sont rejetées avec le code 429 (Too Many Requests). C’est une protection utile contre le bourrage d’identifiants sur une page de connexion.

Ces protections restent statiques. Pour bloquer dynamiquement les adresses qui attaquent vos services, Traefik peut être couplé à CrowdSec, l’IPS collaboratif, qui analyse les journaux d’accès et fait appliquer ses décisions par un composant de remédiation intégré au proxy.

Bonne pratique : regroupez vos middlewares communs (en-têtes, limitation de débit) dans le fournisseur fichier et appliquez-les à toutes les applications. L’ordre compte : placez le filtrage IP et la limitation de débit avant l’authentification.

9. Répartition de charge et contrôles de santé

Un service Traefik peut pointer vers plusieurs serveurs. Avec Docker, il suffit de lancer plusieurs réplicas d’un même service Compose (docker compose up -d --scale whoami=3) : Traefik détecte les conteneurs portant les mêmes labels et répartit les requêtes entre eux selon un tourniquet pondéré (weighted round robin).

Sans contrôle de santé, Traefik continue d’envoyer du trafic à un conteneur démarré mais dont l’application ne répond plus correctement. Le health check actif y remédie : Traefik appelle périodiquement une URL de chaque serveur et retire du pool ceux qui répondent en erreur, puis les réintègre lorsqu’ils redeviennent sains.

- "traefik.http.services.whoami.loadbalancer.healthcheck.path=/health"
- "traefik.http.services.whoami.loadbalancer.healthcheck.interval=5s"

D’autres fonctions existent : sessions persistantes par cookie (sticky sessions), services pondérés pour un déploiement progressif (canary), miroir de trafic. Elles sortent du cadre de ce cours d’introduction.

10. Sécuriser et exploiter Traefik

Le tableau de bord. L’option api.insecure=true publie l’API et le tableau de bord sans authentification sur l’entryPoint traefik (port 8080). Elle est pratique en laboratoire, jamais en production. La méthode recommandée consiste à activer l’API sans le mode insecure, puis à publier le service interne api@internal par un routeur protégé :

- "traefik.http.routers.dashboard.rule=Host(`traefik.exemple.fr`) && (PathPrefix(`/api`) || PathPrefix(`/dashboard`))"
- "traefik.http.routers.dashboard.service=api@internal"
- "traefik.http.routers.dashboard.middlewares=dashboard-auth"

Le tableau de bord est servi sous /dashboard/ : la barre oblique finale est obligatoire.

Le socket Docker. Pour découvrir les conteneurs, Traefik lit l’API Docker, généralement via /var/run/docker.sock. Or l’accès à ce socket équivaut à un accès administrateur à l’hôte : si Traefik, exposé sur Internet, était compromis, l’attaquant pourrait piloter Docker. La documentation recommande de placer un proxy de socket (par exemple tecnativa/docker-socket-proxy) qui n’autorise que les appels en lecture nécessaires, et de faire pointer Traefik vers lui avec l’option providers.docker.endpoint.

Journaux. Le journal applicatif (log.level : ERROR par défaut, INFO ou DEBUG pour diagnostiquer) et le journal d’accès (accessLog), qui trace chaque requête. Le format JSON facilite l’exploitation par un SIEM ou par CrowdSec.

Métriques et santé. Traefik expose des métriques au format Prometheus (metrics.prometheus) : nombre de requêtes par entryPoint et par service, codes de réponse, durées, état des serveurs soumis à un health check. L’option ping active un point de contrôle /ping qui répond OK ; la commande traefik healthcheck l’interroge et peut servir de HEALTHCHECK Docker.

Mises à jour. Traefik publie régulièrement des versions correctives, dont certaines corrigent des vulnérabilités. Épinglez une branche mineure (traefik:v3.7) plutôt que latest, suivez les annonces de sécurité de l’éditeur et lisez le guide de migration avant de changer de branche.

11. Synthèse et check-list d’exploitation

Traefik simplifie la publication d’applications conteneurisées : un seul point d’entrée, des routes déclarées au plus près des applications, des certificats automatiques et des protections communes. Avant de mettre une instance en production, vérifiez les points suivants :

  1. Image épinglée sur une branche maintenue (v3.x) et procédure de mise à jour documentée.
  2. exposedByDefault: false et publication explicite avec traefik.enable=true.
  3. Redirection HTTP vers HTTPS sur l’entryPoint web et minVersion: VersionTLS12.
  4. Résolveur ACME testé en staging, acme.json persistant, protégé et sauvegardé.
  5. Tableau de bord non exposé en mode insecure, protégé par authentification et, idéalement, par filtrage IP.
  6. Socket Docker monté en lecture seule ou, mieux, accédé via un proxy de socket.
  7. Middlewares communs appliqués : en-têtes de sécurité, limitation de débit sur les pages sensibles.
  8. Health checks sur les services répliqués.
  9. Journal d’accès activé et collecté, métriques et /ping supervisés, ports d’administration non publiés sur Internet.

Les huit travaux pratiques ci-dessous reprennent ces étapes dans un laboratoire unique, de l’installation à l’exploitation sécurisée.

Cadre d’usage : réalisez les travaux pratiques dans un laboratoire (machine virtuelle dédiée). Les tests de charge et de filtrage se font uniquement sur vos propres services ; pour le TP sur Let’s Encrypt, utilisez un domaine qui vous appartient.

Évaluation : Reverse proxy et HTTPS avec Traefik

Répondez aux questions puis vérifiez votre score. Une seule bonne réponse par question.

1. Dans Traefik, quel objet associe une règle (nom d’hôte, chemin) à un service ?
2. Où doit-on déclarer un nouvel entryPoint sur le port 443 ?
3. Pourquoi passer exposedByDefault à false pour le fournisseur Docker ?
4. Deux routeurs correspondent à la même requête : Host(`exemple.fr`) et Host(`exemple.fr`) && PathPrefix(`/app2`). Lequel est choisi par défaut pour /app2 ?
5. Quel défi ACME faut-il utiliser pour obtenir un certificat générique *.exemple.fr ?
6. Pourquoi utiliser l’environnement staging de Let’s Encrypt pendant la mise au point ?
7. Quel code HTTP renvoie le middleware rateLimit lorsqu’un client dépasse la limite ?
8. Quelle est la mesure recommandée pour limiter le risque lié au socket Docker monté dans Traefik ?

Pour aller plus loin sur le blog : Traefik : le reverse proxy cloud-native · CrowdSec : l’IPS collaboratif et open source · Uptime Kuma : la supervision de disponibilité

Défiler vers le haut