Traefik est un reverse proxy et un répartiteur de charge écrit en Go qui lit sa configuration de routage directement depuis Docker, Kubernetes, Consul ou Nomad au lieu d'un fichier écrit à la main. La version actuelle est la 3.7.11, la licence est MIT, et les certificats Let's Encrypt sont commandés et renouvelés par le processus serveur lui-même.
D'où Traefik tire sa configuration
La différence entre Traefik et un proxy classique tient à un concept : le provider. Dans nginx ou HAProxy, le fichier de configuration est l'unique source de vérité sur les routes, et chaque changement signifie modifier ce fichier et recharger le processus. Traefik sépare la configuration en deux couches aux cycles de vie complètement différents.
La couche statique contient ce qui est fixé au démarrage du processus et ne peut pas changer sans redémarrage : quels ports écoutent, quelles sources de configuration sont activées, comment l'autorité de certification est jointe. La couche dynamique contient les routeurs, les services et les middlewares, c'est-à-dire tout ce qui change à chaque déploiement. Cette seconde couche ne vient pas d'un fichier, elle vient d'un provider.
Un provider est un adaptateur vers un système précis. Le provider Docker se branche sur le socket du démon et surveille les événements de démarrage et d'arrêt des conteneurs, en lisant les labels qui commencent par traefik.. Le provider CRD de Kubernetes lit les ressources IngressRoute du groupe traefik.io/v1alpha1. Il existe aussi des providers pour Consul, Nomad, ECS et Redis, plus un provider de fichier simple pour quand tu veux vraiment écrire les routes à la main. Plusieurs providers peuvent tourner en même temps et leurs résultats s'additionnent.
L'effet pratique est qu'un nouveau conteneur qui porte le bon jeu de labels commence à recevoir du trafic sans toucher au proxy. Il n'y a ni commande reload, ni modèle qui génère un fichier, ni étape dans le pipeline de déploiement qui pourrait corrompre ce fichier. Le lissage des rafales d'événements est géré par providers.providersThrottleDuration avec une valeur par défaut de 2 secondes, donc dix conteneurs qui démarrent en même temps produisent une reconstruction de la table de routage plutôt que dix.
Le prix de cette commodité est réel aussi. La configuration cesse de vivre à un seul endroit. Elle se disperse entre des fichiers docker-compose.yml, des manifestes Kubernetes et des annotations, et répondre à « pourquoi cet hôte va-t-il là où il va » demande d'ouvrir le tableau de bord de Traefik ou l'API plutôt qu'un seul fichier texte.
Version, licence et la troisième vérification
La version actuelle sur la troisième branche est la 3.7.11 du 21 août 2026. Le fait que trois lignes soient maintenues en parallèle se voit le 3 août, quand 3.7.10, 3.6.25 et 2.11.55 sont toutes sorties le même jour, une version pour chacune. Le code se construit avec go 1.26.0 déclaré dans go.mod.
J'ai vérifié la licence à trois endroits, car c'est la source d'erreurs la plus courante dans les audits de dépendances.
La première source est le fichier du dépôt. github.com/traefik/traefik le garde sous le nom LICENSE.md, pas LICENSE, et il contient le texte MIT complet avec la mention « Copyright (c) 2016-2020 Containous SAS; 2020-2025 Traefik Labs ». Containous est l'ancien nom de la société qui s'est rebaptisée Traefik Labs en 2020, et cette trace apparaît directement dans l'en-tête.
La deuxième source est le registre de paquets. C'est ici que cela devient désagréable, et cela mérite sa propre section plus bas, car le paquet npm nommé traefik ne vient pas de Traefik Labs.
La troisième source est le contenu de l'artefact réellement distribué, et ici le résultat est partagé. L'archive traefik_v3.7.11_linux_amd64.tar.gz de la section des versions pèse environ 48 Mo et contient exactement trois entrées : CHANGELOG.md, LICENSE.md et le binaire traefik d'environ 176 Mo décompressé. Le texte de la licence est donc présent, contrairement à de nombreux projets qui livrent des binaires nus. L'image de conteneur officielle, en revanche, ne le porte pas. Le Dockerfile du dépôt traefik/traefik-library-image pour la variante alpine décompresse l'archive avec une commande qui n'en extrait qu'une seule entrée : tar xzvf /tmp/traefik.tar.gz -C /usr/local/bin traefik. LICENSE.md et CHANGELOG.md restent dans l'archive jetée. Si ton scanner d'images cherche un fichier de licence dans les couches, il n'en trouvera pas pour traefik:v3.7.11, même si le projet est clairement MIT. Tu dois alors consigner la licence manuellement ou la prendre dans les labels OCI que l'image définit bel et bien, dont org.opencontainers.image.source qui pointe vers le dépôt.
Le piège du nom : le paquet npm traefik
Le paquet traefik du registre npm n'est pas publié par Traefik Labs. La version la plus récente est la 1.0.0 sortie le 2 août 2021, toute l'entrée du registre n'a pas changé depuis mai 2022, et le champ repository.url pointe vers github.com/hello-seam/node-traefik. C'est une surcouche non officielle d'une seule personne.
Contrairement à plusieurs autres imitations, celle-ci contient du code : quatorze fichiers et environ 14,8 ko décompressés. index.js exporte une fonction start qui convertit un objet de configuration en TOML via json2toml et lance le binaire comme processus enfant. Le problème se trouve ailleurs. Le fichier download-traefik.js a la version à récupérer codée en dur et la demande à l'interface de programmation de GitHub sans authentification.
// node_modules/traefik/download-traefik.js, version 1.0.0 from 2021
const releaseVersionToUse = "2.4.9"
const releaseAPIUrl =
`https://api.github.com/repos/traefik/traefik/releases/tags/v${releaseVersionToUse}`Installer le paquet en 2026 récupère donc Traefik 2.4.9 de 2021, une version vieille de cinq ans et en retard de deux branches majeures par rapport à ce qui est maintenu. Le téléchargement se fait dans le script install, donc il s'exécute automatiquement pendant npm install, et la requête non authentifiée vers GitHub se heurte aux limites de débit à la première coïncidence dans un environnement d'intégration continue.
Une curiosité à part concerne la licence. Le paquet npm déclare "license": "MIT" et inclut un fichier LICENSE.md, mais son contenu est le texte de la licence de Traefik copié avec la mention « Copyright (c) 2016-2020 Containous SAS; 2020-2021 Traefik Labs ». Un outil qui collecte les métadonnées de licence depuis node_modules signalera donc dans ton projet un composant couvert par les droits de Traefik Labs, même si quelqu'un d'autre a écrit le code de la surcouche. C'est un cas où les trois sources disent « MIT » et où le tableau reste trompeur.
# this is NOT the package from Traefik Labs
npm view traefik version # 1.0.0
npm view traefik repository.url # git+https://github.com/hello-seam/node-traefik.git
npm view traefik time.modified # 2022-05-22T03:25:33.105Z
# this is how the real Traefik is installed
docker pull traefik:v3.7.11
curl -sL https://github.com/traefik/traefik/releases/download/v3.7.11/traefik_v3.7.11_linux_amd64.tar.gz \
| tar -xz traefik LICENSE.mdTraefik est un programme Go distribué sous forme d'un seul binaire ou d'une image de conteneur. Il n'existe pas de canal npm officiel, pas de paquet PyPI officiel, et aucune raison pour qu'un proxy entre dans ton projet via package.json.
Configuration statique et dynamique
La configuration statique va dans un fichier, dans des variables d'environnement ou dans des options de ligne de commande. Par défaut, le processus cherche un fichier sous quatre chemins de base, dans cet ordre : /etc/traefik/traefik, $XDG_CONFIG_HOME/traefik, $HOME/.config/traefik et ./traefik, en essayant les extensions toml, yaml et yml. Un emplacement personnalisé est donné par l'option --configFile.
# /etc/traefik/traefik.yml, the static layer
entryPoints:
web:
address: ":80"
websecure:
address: ":443"
providers:
docker:
endpoint: "unix:///var/run/docker.sock"
exposedByDefault: false
network: "proxy"
watch: true
certificatesResolvers:
letsencrypt:
acme:
email: admin@example.com
storage: /letsencrypt/acme.json
httpChallenge:
entryPoint: webUn champ de cet exemple mérite une attention particulière. providers.docker.exposedByDefault vaut true par défaut, ce qui veut dire que sans cette ligne Traefik exposera sur Internet chaque conteneur visible sur le socket du démon, y compris ta base de données et ta file. La règle par défaut est Host({{ normalize .Name }}), le nom du conteneur utilisé comme nom d'hôte. Mettre false inverse la logique : seuls les conteneurs qui portent le label traefik.enable=true sont routés.
La couche dynamique pour Docker, ce sont les labels. Le nom du routeur et le nom du service dans un label sont arbitraires et ne servent qu'à lier ensemble des entrées apparentées.
services:
traefik:
image: traefik:v3.7.11
ports:
- "80:80"
- "443:443"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- ./traefik.yml:/etc/traefik/traefik.yml:ro
- ./letsencrypt:/letsencrypt
networks: [proxy]
api:
image: ghcr.io/example/api:1.4.2
labels:
- traefik.enable=true
- traefik.http.routers.api.rule=Host(`api.example.com`)
- traefik.http.routers.api.entrypoints=websecure
- traefik.http.routers.api.tls.certresolver=letsencrypt
- traefik.http.services.api.loadbalancer.server.port=8080
- traefik.docker.network=proxy
networks: [proxy]Dans Kubernetes, la même description prend la forme d'une ressource personnalisée. Le groupe est traefik.io/v1alpha1, et avant la première utilisation tu dois appliquer les définitions de ressources et les règles d'accès du répertoire dynamic-configuration du dépôt.
apiVersion: traefik.io/v1alpha1
kind: IngressRoute
metadata:
name: api-route
namespace: apps
spec:
entryPoints:
- websecure
routes:
- kind: Rule
match: Host(`api.example.com`) && PathPrefix(`/v1`)
priority: 10
services:
- kind: Service
name: api
port: 8080
passHostHeader: true
tls:
certResolver: letsencryptLe champ priority tranche les collisions entre règles. Sans lui, Traefik trie les règles selon la longueur de leur forme textuelle, ce qui peut surprendre quand deux routes correspondent à la même requête.
Certificats ACME et leurs limites
Les certificats sont gérés par un mécanisme appelé le certificate resolver. Tu en déclares un une fois dans la couche statique et tu y fais ensuite référence par son nom depuis une route via tls.certresolver. Les champs obligatoires sont email et storage, où storage vaut par défaut acme.json dans le répertoire de travail.
Tu choisis l'un des trois défis. httpChallenge.entryPoint nomme un point d'entrée qui écoute sur le port 80 et doit être joignable de l'extérieur. tlsChallenge utilise TLS-ALPN-01 sur le port 443. dnsChallenge.provider passe par un enregistrement TXT dans la zone DNS, et seule cette voie donne des certificats génériques (wildcard), car écrire un enregistrement DNS demande des identifiants pour le fournisseur, transmis via des variables d'environnement selon la liste tenue par la bibliothèque Lego.
L'autorité par défaut est https://acme-v02.api.letsencrypt.org/directory, le type de clé par défaut est RSA4096, et Traefik suppose des certificats de 90 jours et commence le renouvellement 30 jours avant l'expiration. Pour les autorités qui émettent des certificats avec une autre durée de validité, il y a certificatesDuration, donné en heures, avec une valeur par défaut de 2160.
Voici la limitation la plus importante de la variante gratuite, et il faut la connaître avant de concevoir un déploiement. Le magasin acme.json est un simple fichier sur disque, pas un magasin distribué avec des garanties de cohérence. Deux réplicas de Traefik qui lisent le même fichier via un volume partagé se le disputeront et commanderont chacun leurs propres certificats, ce qui épuise les limites de l'autorité. La réponse du fournisseur est une fonctionnalité appelée Distributed Let's Encrypt, disponible uniquement dans Traefik Hub payant. Dans la variante ouverte, les bonnes sorties sont un seul réplica qui termine le TLS, des certificats émis en dehors de Traefik et injectés comme secrets, ou un mécanisme externe comme cert-manager dans Kubernetes.
Traefik Proxy, Hub et Enterprise
La documentation et le site du produit mélangent trois produits au même niveau de navigation, donc il est très facile d'écrire un exemple qui utilise une fonctionnalité que la version gratuite n'a tout simplement pas.
| Fonctionnalité | Traefik Proxy (MIT) | Traefik Hub API Gateway | Traefik Hub API Management |
|---|---|---|---|
| Découverte automatique des services | oui | oui | oui |
| HTTP/2, HTTP/3, TCP, UDP, gRPC, WebSockets | oui | oui | oui |
| Métriques et traces OpenTelemetry | oui | oui | oui |
| Déploiements canary, tableau de bord de vue ingress | oui | oui | oui |
| OIDC, LDAP, JWT, HMAC, clés d'API, Open Policy Agent | non | oui | oui |
| Pare-feu applicatif web natif | non | oui | oui |
| Let's Encrypt distribué, limitation de débit distribuée | non | oui | oui |
| Cache HTTP, tableau de bord de vue cluster, multi-cluster | non | oui | oui |
| FIPS 140-2 et 140-3 | non | oui | oui |
| Portail développeur, versionnage et forfaits d'API | non | non | oui |
| Mode isolé (air-gapped), simulation d'API | non | non | oui |
Il n'y a pas de grille tarifaire. La page traefik.io/pricing aligne trois colonnes, mais Traefik Proxy porte un bouton de téléchargement et une offre de support séparée pour la version ouverte, tandis que les deux variantes Hub n'affichent que « Get pricing ». Aucun chiffre, aucun palier, aucune information sur l'unité de facturation. Un devis doit être obtenu par une conversation avec les ventes, ce qui, pour comparer avec des concurrents, signifie des semaines plutôt que des minutes.
Traefik Enterprise, décrit il y a un an comme un produit séparé, porte maintenant une bannière sur sa propre page qui indique clairement qu'il a été déplacé dans Traefik Hub. La documentation à doc.traefik.io/traefik-enterprise/ répond encore, donc les déploiements existants ont un endroit où chercher, mais un nouveau projet n'a aucune raison d'y aller. C'est aussi un signal sur le risque de verrouillage chez le fournisseur : la ligne payante a changé de nom et de forme, et les clients ont dû migrer.
Pour être juste, Traefik Proxy seul est complet. Reverse proxy, répartiteur de charge, contrôleur ingress, middlewares avec redirections, en-têtes, authentification basique et limitation du débit des requêtes par instance, plus un catalogue de plugins écrits en Go. Pour un seul serveur ou un seul cluster, c'est l'ensemble complet. Les variantes payantes ne commencent à avoir du sens qu'avec plusieurs clusters et des exigences de conformité.
Traefik face à Caddy et nginx
Caddy résout une partie du même problème : il est aussi écrit en Go, il récupère aussi les certificats tout seul et il veut aussi remplacer le duo nginx plus certbot. La différence tient à l'origine de la liste de routes.
| Critère | Traefik Proxy 3.7 | Caddy 2 | nginx avec certbot |
|---|---|---|---|
| Source des routes | providers : Docker, Kubernetes, Consul, Nomad, fichier | Caddyfile ou JSON via l'API d'administration | fichiers dans un répertoire de configuration |
| Réaction à un nouveau conteneur | automatique, sans rechargement | modifier le fichier et recharger | modifier le fichier et recharger |
| Certificats | certificatesResolvers avec stockage dans un fichier | intégrés, activés par défaut | processus séparé et planificateur |
| Toute la configuration dans un fichier | non, les routes vivent dans les labels | oui | oui |
| Licence | MIT | Apache 2.0 | BSD 2 clauses |
| Variante payante | Traefik Hub, prix sur demande | aucune, financé par le sponsoring | aucune dans le cœur |
Le choix se règle par la volatilité de l'environnement, pas par le goût de la syntaxe. Avec un ensemble fixe de quelques services dont les adresses changent une fois par trimestre, le fichier de Caddy est simplement meilleur : il tient sur un écran, va dans le dépôt, peut être relu en une minute, et pendant une panne toute la vérité est visible à un seul endroit. Traefik dans cette configuration ajoute un démon qui surveille des événements pour détecter un changement qui n'arrive de toute façon pas.
Avec des dizaines de conteneurs qui montent et descendent au rythme des déploiements, les proportions s'inversent. Générer un fichier Caddy à partir d'un modèle et le recharger à chaque changement reproduit exactement le mécanisme que Traefik a intégré, mais avec ton propre code à maintenir et qui peut échouer en silence. Un label à côté d'un conteneur vit à côté de la définition du service, donc le déploiement et la route changent dans une seule révision.
Il vaut aussi la peine de noter que de nombreuses plateformes de déploiement tranchent ce choix pour toi. Coolify installe Traefik comme proxy par défaut et ajoute lui-même les labels aux conteneurs lancés. Railway et Fly.io ont leurs propres couches réseau et la question n'y apparaît jamais. Si les services derrière le proxy sont surtout PostgreSQL et Redis, c'est-à-dire des protocoles autres que HTTP, il te faut un routeur TCP avec une règle HostSNI plutôt qu'un simple routeur HTTP.
Erreurs courantes
Laisser exposedByDefault à sa valeur par défaut. L'effet est une adresse publique pour chaque conteneur du réseau, y compris ceux qui n'étaient pas censés quitter l'hôte.
Monter /var/run/docker.sock en écriture. L'accès au socket du démon équivaut à des droits d'administrateur sur l'hôte, donc un proxy exposé à Internet avec un tel volume est un risque sérieux. Le minimum est le suffixe :ro, mieux encore un courtier qui limite l'étendue des appels.
Deux réplicas sur un même fichier acme.json. Le résultat est des commandes de certificats en double et l'épuisement de la limite hebdomadaire de l'autorité, après quoi le domaine reste sans certificat valide jusqu'à la fermeture de la fenêtre de limite.
Le conteneur et Traefik sur des réseaux Docker différents. La route est créée, le tableau de bord la montre, et la réponse est une erreur de passerelle car le proxy n'a aucun moyen d'atteindre l'adresse cible. Le label traefik.docker.network ou le champ providers.docker.network règle la question.
Omettre loadbalancer.server.port quand l'image expose plus d'un port. Traefik devine alors le port et se trompe.
Exposer le tableau de bord avec api.insecure=true sur un point d'entrée public. Le tableau de bord montre toute la table de routage et la configuration des middlewares, c'est-à-dire une carte de ton infrastructure.
Porter la configuration de la deuxième branche vers la troisième sans lire le guide de migration. Les noms de providers, la syntaxe des règles et certains champs ont subi des changements non rétrocompatibles, et un ancien fichier peut démarrer avec une partie des routes silencieusement ignorée.
FAQ
Le paquet npm nommé traefik est-il le Traefik officiel ?
Non. La version 1.0.0 du 2 août 2021 vient du dépôt hello-seam/node-traefik et est une surcouche non officielle d'une seule personne. Elle contient du code qui fonctionne, mais elle a Traefik 2.4.9 codé en dur et le récupère via une requête non authentifiée vers l'interface de GitHub. La distribution officielle est un binaire de la section des versions ou l'image traefik.
Quelle est la licence de Traefik et où la trouver ?
MIT, dans le fichier LICENSE.md à la racine du dépôt, avec une mention de copyright pour Containous SAS et Traefik Labs. Le fichier est aussi dans l'archive de la version, mais il est absent de l'image de conteneur officielle, car le Dockerfile n'extrait que le binaire de cette archive.
Traefik peut-il gérer les certificats automatiques sur plusieurs réplicas ?
Pas dans la version ouverte. Le magasin acme.json est un fichier et il n'y a aucune coordination entre instances à l'intérieur. La fonctionnalité Distributed Let's Encrypt appartient à Traefik Hub payant. Avec plusieurs réplicas, il est plus sensé d'émettre les certificats en dehors du proxy, par exemple avec cert-manager.
Combien coûte Traefik Hub ?
La grille tarifaire n'est pas publique. La page de tarifs n'affiche qu'un bouton « Get pricing » pour les deux variantes Hub, sans tarif, sans palier et sans unité de facturation. Un devis doit venir du service commercial.
Traefik ou Caddy pour un serveur avec quelques services ?
Avec un ensemble fixe de services, Caddy passe généralement devant, car toute la configuration tient dans un court fichier. Traefik commence à rapporter quand les services montent et descendent seuls et que la liste de routes change à chaque déploiement.
Traefik fait-il passer du trafic autre que HTTP ?
Oui. En plus des routeurs HTTP, il y a des routeurs TCP avec des règles basées sur HostSNI et des routeurs UDP. Cela te permet de placer aussi des services de base de données derrière un point d'entrée unique, même si sans nom dans le SNI tu ne peux pas distinguer plusieurs services sur un même port.
Sources : le dépôt du projet, la page des tarifs, l'entrée du paquet dans le registre npm.