217 lines
8.9 KiB
Markdown
217 lines
8.9 KiB
Markdown
---
|
|
title: Mantræ
|
|
created: 2026-06-06
|
|
updated: 2026-06-06
|
|
type: app
|
|
tags: [catalogue, reverse-proxy, traefik, ui, dns, go, svelte]
|
|
confidence: medium
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Reverse+Proxy, https://github.com/MizuchiLabs/mantrae]
|
|
---
|
|
|
|
# 🚦 Mantræ
|
|
|
|
> **Web UI pour gérer la configuration dynamique de Traefik (routers, services, middlewares) avec intégration DNS automatique Cloudflare / PowerDNS / Technitium / Pi-hole**. Inspiré de Nginx Proxy Manager et Pangolin, 100 % Traefik-native.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [mizuchilabs.github.io/mantrae](https://mizuchilabs.github.io/mantrae/) |
|
|
| **GitHub** | [MizuchiLabs/mantrae](https://github.com/MizuchiLabs/mantrae) |
|
|
| **License** | MIT |
|
|
| **Langage** | TypeScript (41.9 %), Svelte (34.3 %), Go (20.7 %) |
|
|
| **Étoiles GitHub** | 491 ⭐ |
|
|
| **Dernière MAJ** | 2026-04-14 (v0.8.9) |
|
|
| **Catégorie** | [[cat-reverse-proxy|Reverse Proxy]], UI, Traefik, DNS |
|
|
|
|
## 📝 Description
|
|
|
|
**Mantræ** (par MizuchiLabs, mainteneur @d34dscene) est un **gestionnaire web de la configuration dynamique Traefik** : il présente une UI propre (Svelte) pour créer **routers, services, middlewares** sans éditer de YAML, et **intègre la gestion DNS automatique** avec 4 providers (Cloudflare, PowerDNS, Technitium, Pi-hole) pour pousser les records en même temps que les routes.
|
|
|
|
⚠️ **Note importante** : Mantræ n'est **pas** un dashboard Traefik (il ne monitore pas l'état des routes). C'est un **gestionnaire de configuration** : Traefik se connecte à Mantræ pour fetcher sa dynamic config. La nuance est importante.
|
|
|
|
⚠️ **Note de roadmap** : depuis 2025, le développement a été **transféré** vers [Tether](https://github.com/MizuchiLabs/tether) (même équipe). Mantræ reste maintenu pour les correctifs mais les nouvelles features vont sur Tether.
|
|
|
|
**Caractéristiques principales** :
|
|
|
|
- ✅ **Web UI Svelte** moderne, dark/light mode, ergonomique
|
|
- ✅ **Gestion routers** : règles Host/Path/Headers, entrypoints, TLS
|
|
- ✅ **Gestion middlewares** : rate-limit, basicauth, headers, redirect, stripPrefix, etc.
|
|
- ✅ **Gestion services** : load balancer, weighted, mirroring
|
|
- ✅ **DNS auto** : Cloudflare, PowerDNS, Technitium, Pi-hole (push du record A/CNAME quand un nouveau router est créé)
|
|
- ✅ **Agent `mantraed`** : déploie un agent sur chaque host Docker qui **synchronise les labels** des containers vers Mantræ (alternative aux labels Docker classiques)
|
|
- ✅ **Authentification intégrée** : user/password + sessions
|
|
- ✅ **API REST** documentée (OpenAPI)
|
|
- ✅ **Binaire Go standalone** : installation simple, pas de runtime Node requis en production
|
|
|
|
**Public cible** : utilisateurs de Traefik qui veulent **une UI web dédiée** pour gérer leur config **sans dépendre de Docker labels** exclusivement. Particulièrement adapté pour des setups **non-Docker** (Traefik en binaire natif sur VM) où l'auto-discovery Docker n'est pas utilisable.
|
|
|
|
## 🚀 Installation
|
|
|
|
### Option 1 : Docker Compose (recommandé)
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
version: '3.8'
|
|
services:
|
|
mantrae:
|
|
image: ghcr.io/mizuchilabs/mantrae:latest
|
|
container_name: mantrae
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8080:8080"
|
|
volumes:
|
|
- ./data:/data # base SQLite + config
|
|
environment:
|
|
- TZ=Europe/Paris
|
|
networks:
|
|
- proxy
|
|
|
|
networks:
|
|
proxy:
|
|
external: true
|
|
```
|
|
|
|
### Variante Traefik (exposer Mantræ derrière Traefik)
|
|
|
|
```yaml
|
|
# docker-compose.yml (variante)
|
|
version: '3.8'
|
|
services:
|
|
mantrae:
|
|
image: ghcr.io/mizuchilabs/mantrae:latest
|
|
container_name: mantrae
|
|
restart: unless-stopped
|
|
volumes:
|
|
- ./data:/data
|
|
environment:
|
|
- TZ=Europe/Paris
|
|
labels:
|
|
- "traefik.enable=true"
|
|
- "traefik.docker.network=proxy"
|
|
- "traefik.http.routers.mantrae.rule=Host(`traefik.example.com`)"
|
|
- "traefik.http.routers.mantrae.entrypoints=websecure"
|
|
- "traefik.http.routers.mantrae.tls.certresolver=letsencrypt"
|
|
- "traefik.http.services.mantrae.loadbalancer.server.port=8080"
|
|
- "traefik.http.routers.mantrae.middlewares=auth@docker"
|
|
networks:
|
|
- proxy
|
|
|
|
networks:
|
|
proxy:
|
|
external: true
|
|
```
|
|
|
|
### Option 2 : Binaire natif (install script)
|
|
|
|
```bash
|
|
curl -fsSL https://raw.githubusercontent.com/mizuchilabs/mantrae/main/install.sh | sh
|
|
mantrae --version
|
|
mantrae # démarre le serveur
|
|
```
|
|
|
|
### Configuration Traefik (statique) pour consommer Mantræ
|
|
|
|
```yaml
|
|
# traefik.yml (statique)
|
|
providers:
|
|
http:
|
|
endpoint: "http://mantrae:8080/api/v1/traefik-config"
|
|
pollInterval: 10s
|
|
```
|
|
|
|
### Variante : agent `mantraed` pour la découverte Docker
|
|
|
|
```yaml
|
|
# Sur chaque host avec Docker
|
|
version: '3.8'
|
|
services:
|
|
mantraed:
|
|
image: ghcr.io/mizuchilabs/mantraed:latest
|
|
container_name: mantraed
|
|
restart: unless-stopped
|
|
volumes:
|
|
- /var/run/docker.sock:/var/run/docker.sock:ro
|
|
environment:
|
|
- MANTRAE_URL=https://traefik.example.com
|
|
- MANTRAE_API_KEY=your-api-key
|
|
```
|
|
|
|
## ⚙️ Configuration Initiale
|
|
|
|
1. **Lancer Mantræ** et accéder à `http://YOUR_HOST:8080`.
|
|
2. **Créer le compte admin** au premier démarrage.
|
|
3. **Configurer un provider DNS** (optionnel mais typique) : Cloudflare API token ou PowerDNS API.
|
|
4. **Configurer Traefik** pour pointer sur `http://mantrae:8080/api/v1/traefik-config`.
|
|
5. **Créer un router** depuis l'UI : Host, port backend, middlewares, DNS auto (si configuré).
|
|
6. **Créer un service** (load balancer si multi-backend) ou laisser Mantræ le déduire du router.
|
|
7. **Attacher des middlewares** (rate-limit, headers, etc.).
|
|
8. **Tester** : un curl sur le host configuré doit renvoyer le service backend.
|
|
|
|
> 💡 **Reset password oublié** : `mantrae reset --password newpassword`
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
|
|
- [[app-traefik]] — UI native de Traefik (lecture seule)
|
|
- [[app-nginx-proxy-manager]] — concurrent direct sur l'idée (UI complète Nginx)
|
|
- [[app-pangolin]] — UI orientée tunnels/ressources, intègre Traefik
|
|
- [[app-middleware-manager]] — concurrent direct (focus middlewares)
|
|
- **GloboDNS** (DNS) — pas un proxy manager
|
|
- **Portainer** (Docker) — orienté containers, pas proxy
|
|
|
|
### Propriétaires (ce que Mantræ remplace)
|
|
|
|
- **Cloudflare Workers + Dashboard**
|
|
- **AWS API Gateway** (en partie)
|
|
- **Cloudflare Access** (UI auth)
|
|
- **Kong Manager EE** (édition enterprise)
|
|
- **Traefik Enterprise** (abandonné)
|
|
|
|
### Comparaison rapide
|
|
|
|
| Critère | Mantræ | Middleware Manager | Nginx Proxy Manager | Pangolin |
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|
| Reverse proxy | Traefik | Traefik | Nginx | Traefik (managé) |
|
|
| Routers/Services UI | ✅ | Partiel | ✅ (Hosts) | ✅ (Resources) |
|
|
| Middlewares UI | ✅ | ✅ (full) | Partiel | Limité |
|
|
| DNS auto | ✅ (4 providers) | ❌ | ❌ | Partiel |
|
|
| Agent Docker | ✅ (mantraed) | ❌ | ❌ | ❌ |
|
|
| Licence | MIT | MIT | MIT | Custom |
|
|
| Stabilité | ⚠️ (v0.8, dev → Tether) | ✅ (v4.5) | ✅ (v2.x) | ✅ |
|
|
|
|
**Verdict** : **Mantræ** pour qui veut **DNS auto + UI Traefik native + agent Docker** dans un seul outil. **Middleware Manager** pour qui veut la **gestion de middlewares la plus complète**. **Nginx Proxy Manager** pour la **stabilité long terme** sur Nginx. **Pangolin** pour la couche **tunnels + auth** au-dessus.
|
|
|
|
> ⚠️ **À surveiller** : la transition vers **Tether** est en cours. Pour un nouveau projet, vérifier l'état de Tether vs Mantræ avant de partir.
|
|
|
|
## 🔐 Sécurité
|
|
|
|
- **Auth UI** : user/password + sessions, obligatoire
|
|
- **API key `mantraed`** : rotation possible depuis l'UI Mantræ
|
|
- **Bind sur localhost** ou derrière reverse proxy HTTPS : ne pas exposer le port 8080 directement
|
|
- **DNS provider tokens** : scope minimum (Zone:DNS:Edit par exemple sur Cloudflare, pas Global API Key)
|
|
- **Permissions `./data`** : `chmod 700`, backups réguliers (DB SQLite)
|
|
- ⚠️ **Mantræ écrit la config dynamique** : un attaquant qui compromet l'UI peut rediriger tout le trafic → **2FA recommandé** + restriction IP sur l'UI
|
|
- **HTTPS obligatoire** : l'UI contient des secrets (API keys DNS)
|
|
- **Agent `mantraed` en `ro` sur le Docker socket** : limiter la surface d'attaque
|
|
|
|
## 📚 Ressources
|
|
|
|
- [Documentation Mantræ](https://mizuchilabs.github.io/mantrae/)
|
|
- [GitHub MizuchiLabs/mantrae](https://github.com/MizuchiLabs/mantrae)
|
|
- [Discussion : transition vers Tether](https://github.com/MizuchiLabs/mantrae/discussions/253)
|
|
- [Repo Tether (successeur)](https://github.com/MizuchiLabs/tether)
|
|
- [Reddit r/selfhosted: Traefik UI](https://www.reddit.com/r/selfhosted/comments/1jlaz0t/discovered_traefik_http_provider_gui/)
|
|
- [Sponsor @d34dscene sur Ko-fi](https://ko-fi.com/d34dscene)
|
|
|
|
## Pages Liées
|
|
|
|
- [[cat-reverse-proxy]] — Catégorie Reverse Proxy
|
|
- [[app-traefik]] — Le reverse proxy sous-jacent
|
|
- [[app-middleware-manager]] — Concurrent direct (HHF Technology)
|
|
- [[app-pangolin]] — Voisin (tunnels + auth)
|
|
- [[comparatif-reverse-proxy]] — Comparaison détaillée
|
|
- [[dns-automation]] — Concepts DNS-as-code
|