Gérer Traefik depuis le navigateur sans éditer manuellement les fichiers YAML

Si vous utilisez activement Traefik comme proxy inverse dans votre labo à la maison ou sur des serveurs de production, vous connaissez probablement sa principale limitation. Le tableau de bord intégré semble attrayant, mais il est entièrement statique. Vous pouvez consulter la liste des routes, mais vous ne pouvez pas ajouter un nouveau domaine ni ajuster un middleware directement depuis le navigateur. Vous devez ouvrir un terminal, vous connecter via SSH et modifier les fichiers YAML. Une espace mal placée — et tout votre trafic s'arrête.

Un développeur connu sous le pseudo chr0n6 a rencontré ce problème et a créé le projet Traefik Manager. C'est un panneau web permettant de gérer visuellement le routeur, ce qui vous évite de devoir plonger dans un éditeur de texte tard le soir.

Pourquoi remplacer l'édition familière des fichiers par une interface web

Toute la logique de Traefik repose sur les concepts de Routes, Services et Middlewares. Lorsque vous avez plus d'une douzaine de services, la maintenance de la configuration dynamique devient une corvée routinière.

Traefik Manager propose un constructeur visuel pour créer et modifier des fichiers de configuration dynamiques. L'outil ne se contente pas de générer du YAML à partir de zéro — il utilise la bibliothèque ruamel.yaml. Cela signifie que les commentaires manuels et les templates Go à l'intérieur des fichiers ne seront pas écrasés lors de l'enregistrement depuis l'interface.

L'interface gère plusieurs tâches courantes d'administration Traefik :

• Constructeur de routes HTTP, TCP et UDP avec support de règles complexes comme PathPrefix ou HostRegexp.
• Préréglages prêts à l'emploi pour les serveurs multimédias populaires comme Jellyfin, Plex et Emby, qui configurent les bons en-têtes de sécurité et les paramètres de streaming en un clic.
• Gestion des certificats TLS avec affichage de la date d'expiration.
• Éditeur Monaco intégré avec coloration syntaxique pour les cas où vous devez écrire une règle inhabituelle ou personnalisée.

Assistants de configuration des middlewares sans lire la documentation

Le détail le plus agréable du projet est les assistants paso à paso pour les Middlewares. Au lieu de chercher dans la documentation Traefik à chaque fois la syntaxe exacte des en-têtes d'autorisation ou de la limitation de débit des requêtes, vous sélectionnez le scénario souhaité parmi 24 assistants prêts à l'emploi.

Parmi les scénarios supportés :

• Autorisation Basic et Digest.
• Configuration Forward Auth pour travailler avec Authentik, Authelia et Gatekeeper.
• Configuration OIDC / SSO.
• Limitation de débit et listes d'IP autorisées.
• Remplacement, suppression ou ajout de préfixe d'URL.

Chaque assistant pose des questions claires dans un formulaire puis génère la section appropriée dans le fichier. Si vous utilisez un proxy via Cloudflare ou un autre service externe, l'utilitaire suggérera comment configurer correctement la profondeur des trusted hops afin que les adresses IP des clients ne se perdent pas en chemin.

Rollback des modifications et sauvegarde automatique Git

La principale crainte lors du changement des paramètres du proxy est de casser accidentellement l'accès au proxy lui-même. Traefik Manager dispose d'une protection contre ce scénario intégrée.

Avant chaque sauvegarde de fichier, le système effectue une sauvegarde locale ciblée avec un horodatage. Si quelque chose se passe mal, vous pouvez restaurer la version fonctionnelle précédente en appuyant sur un bouton.

Pour ceux qui préfèrent stocker la configuration dans des dépôts, il existe un mécanisme de push automatique Git intégré. Vous pouvez lier GitHub, GitLab, Gitea ou Forgejo. Après toute modification, le panneau commite et push automatiquement vers la branche. Il y a un visualiseur d'historique avec comparaison visuelle des différences directement dans l'interface, vous pouvez donc toujours voir qui et quand a modifié la configuration.

Gestion de plusieurs serveurs via l'agent

Si vous n'avez pas qu'un seul serveur mais une infrastructure de plusieurs hôtes, vous n'aurez pas besoin de déployer et d'ouvrir un panneau séparé sur chacun d'eux.

Le projet inclut Traefik Manager Agent (TMA), écrit en Go. Vous l'installez aux côtés de Traefik sur une machine distante, générez une clé API et la connectez à l'interface centrale. Un sélecteur de serveur apparaît en haut du panneau. À travers celui-ci, vous pouvez consulter les logs, modifier les routes et restaurer les configurations sur n'importe lequel des hôtes connectés.

De plus, l'agent n'a même pas besoin de paramètres Git directs — le serveur principal peut récupérer leurs configurations et les enregistrer dans des branches séparées de votre dépôt.

Monitoring, CrowdSec et sécurité

Le panneau n'est pas limité à la création de fichiers. Il peut collecter et afficher des analyses en direct.

L'onglet monitoring affiche l'état de tous les services, la version du proxy et les points d'entrée actifs. Il affiche également des avertissements sur les vulnérabilités découvertes (CVE) qui affectent votre version spécifique de Traefik. Cela vous aide à maintenir le conteneur à jour à temps.

Si CrowdSec fonctionne sur le serveur, le panneau se connecte à son LAPI. Depuis le navigateur, vous pourrez voir la liste des adresses bloquées, débloquer des IP spécifiques ou rediriger强制ement le trafic suspect via un captcha.

D'un point de vue sécurité pour le panneau lui-même, tout est bien pensé :

• Autorisation via bcrypt et authentification à deux facteurs TOTP.
• Support OIDC pour la connexion via un compte unique d'entreprise.
• Protection intégrée contre CSRF, les attaques de session et la limitation de débit.
• Jetons pour l'application mobile, qui mérite une mention spéciale.

Le développeur a également publié un client mobile pour Android (React Native) qui fonctionne via des clés API. Depuis votre téléphone, c'est pratique pour désactiver rapidement une route défaillante ou vérifier l'état des services en déplacement.

Démarrage rapide

Vous pouvez lancer le panneau avec littéralement une seule commande via le script d'installation officiel ou en utilisant un fichier Compose standard.

Exemple minimal docker-compose.yml :

services:
  traefik-manager:
    image: ghcr.io/chr0nzz/traefik-manager:latest
    container_name: traefik-manager
    restart: unless-stopped
    ports:
      - "5000:5000"
    environment:
      - COOKIE_SECURE=false
    volumes:
      - /path/to/traefik/dynamic.yml:/app/config/dynamic.yml
      - /path/to/traefik-manager/config:/app/config
      - /path/to/traefik-manager/backups:/app/backups

Après avoir exécuté docker compose up -d, vous naviguez vers http://localhost:5000 et suivez un assistant de configuration initial court.

Sous le capot

L'architecture du projet est simple et fiable. Le backend est écrit en Python 3.11 et Flask avec un serveur Gunicorn. Le frontend s'est passé des frameworks lourds : JavaScript vanilla, Tailwind CSS pour la mise en page, les icônes Phosphor et l'éditeur Monaco.

Toutes les ressources JS et CSS sont regroupées directement dans l'image Docker, donc le panneau fonctionne de manière autonome et ne fait aucune requête vers des CDN externes pendant le fonctionnement.

Résumé

Traefik Manager comble un besoin longtemps attendu dans la communauté. L'outil convient aux propriétaires de labs à la maison, aux petites équipes et aux administrateurs système qui en ont marre d'éditer manuellement les fichiers YAML.

Si votre Traefik sert plus de cinq services ou que vous gérez plusieurs nœuds, le projet mérite définitivement d'être testé. Les assistants pratiques de configuration des middlewares et le rollback intégré des modifications feront gagner beaucoup de temps lors de la configuration de votre réseau.