Traefik v3 Dynamischer Konfigurations-Generator
Moderner Cloud-Nativer Reverse-Proxy

Traefik v3 Dynamischer Konfigurations-Generator

Produktionsreife Spezifikation und Referenz zur Erstellung dynamischer Traefik v2 und v3 Routing-, Middleware- und TLS-Konfigurationen.

Multi-Format: YAML • TOML • Docker Labels • IngressRoute
Voreinstellungen:
Regel-Assistent
Hostname
PathPrefix
Operator
Zertifikats-Resolver (ACME)
Tag des Monats
# Traefik v3 Dynamic Configuration
# Generated 100% Client-Side by ToolsAA Traefik Config Generator
# Documentation: https://doc.traefik.io/traefik/v3.0/

http:
  routers:
    # Global automatic HTTP -> HTTPS redirect router
    global-http-redirect:
      entryPoints:
        - "web"
      rule: "PathPrefix(`/`)"
      middlewares:
        - "redirect-to-https"
      service: "noop@internal"
      priority: 1
    api-router:
      entryPoints:
        - "websecure"
      rule: "Host(`api.toolsaa.com`) && PathPrefix(`/v1`)"
      service: "api-service"
      priority: 100
      middlewares:
        - "strip-api-prefix"
        - "api-rate-limit"
        - "security-headers"
      tls:
        certResolver: "letsencrypt"
        domains:
          - main: "api.toolsaa.com"
    auth-router:
      entryPoints:
        - "websecure"
      rule: "Host(`api.toolsaa.com`) && PathPrefix(`/auth`)"
      service: "auth-service"
      priority: 110
      middlewares:
        - "api-rate-limit"
        - "security-headers"
      tls:
        certResolver: "letsencrypt"
        domains:
          - main: "api.toolsaa.com"

  middlewares:
    redirect-to-https:
      redirectScheme:
        scheme: "https"
        permanent: true
    strip-api-prefix:
      stripPrefix:
        prefixes:
          - "/v1"
          - "/api/v1"
        forceSlash: false
    api-rate-limit:
      rateLimit:
        average: 100
        burst: 50
        period: "1s"
    security-headers:
      headers:
        sslRedirect: true
        stsSeconds: 31536000
        stsIncludeSubdomains: true
        stsPreload: true
        forceSTSHeader: true
        customFrameOptionsValue: "SAMEORIGIN"
        contentTypeNosniff: true
        contentSecurityPolicy: "default-src 'self'"

  services:
    api-service:
      loadBalancer:
        passHostHeader: true
        servers:
          - url: "http://10.0.1.10:8080"
          - url: "http://10.0.1.11:8080"
        healthCheck:
          path: "/healthz"
          interval: "10s"
          timeout: "3s"
        sticky:
          cookie:
            name: "traefik_api_sticky"
            secure: true
            httpOnly: true
            sameSite: "lax"
    auth-service:
      loadBalancer:
        passHostHeader: true
        servers:
          - url: "http://10.0.1.20:4000"
        healthCheck:
          path: "/status"
          interval: "15s"
          timeout: "2s"

tls:
  options:
    default:
      minVersion: "VersionTLS12"
      sniStrict: true
      cipherSuites:
        - "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256"
        - "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"
        - "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384"
        - "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
        - "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305"
        - "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305"
Konfigurierte Router
2 Aktive Regeln
Aktive Middlewares
3 Ketten
Traefik v3.x Bereit
Traefik v3.x Ready

100% Client-Seitige Generierung

Keine Server-Uploads oder Datenübertragungen. Alle Routing-Regeln und Backend-URLs werden sicher in der lokalen Sandbox erstellt.

Traefik v3 Konformität

Generiert native v3 Syntax inklusive ipAllowList, Backtick-Regeln und moderne TLS-Cipher-Suiten.

Multi-Format Export-Pipeline

Exportieren Sie Konfigurationen direkt als YAML, TOML, Docker Compose Labels und Kubernetes IngressRoute CRDs.

Technische Referenz & Architektur-Leitfaden

Traefik Config Generator Entwickler-Referenz — Referenz-Leitfaden

Produktionsreife Spezifikation und Referenz zur Erstellung dynamischer Traefik v2 und v3 Routing-, Middleware- und TLS-Konfigurationen.

Wichtige Parameter & Steuerelemente

rulestring

Traefik-Routing-Ausdruck zum Abgleich eingehender HTTP/TCP-Anfrageattribute wie Host, PathPrefix oder Header mittels boolescher Operatoren.

Standard: Host(`api.example.com`) && PathPrefix(`/v1`)
entryPointsstring[]

Netzwerk-Ports und Listener aus der statischen Traefik-Konfiguration, an die dieser Router gebunden wird (z. B. web oder websecure).

Standard: ["websecure"]
certResolverstring

Bezeichner des in der statischen Konfiguration deklarierten ACME-Zertifikats-Resolvers für automatische Let's Encrypt-Ausstellungen.

Standard: "letsencrypt"
healthCheckPathstring

Upstream-HTTP-Endpunkt, der periodisch zur Überprüfung des Backend-Zustands vor der Lastverteilung abgefragt wird.

Standard: "/healthz"
passHostHeaderboolean

Gibt an, ob Traefik den ursprünglichen Host-Header des Clients unverändert an den Upstream-Dienst weiterleitet.

Standard: true

Profi-Tipps & Best Practices

Regel-Prioritäts-Optimierung

Setzen Sie bei überlappenden PathPrefix-Routen (z. B. /api und /api/v2) einen expliziten Integer-Priority-Wert auf die spezifischere Route, um Fallback-Konflikte zu vermeiden.

Middleware-Reihenfolge-Kette

Platzieren Sie redirectScheme und ipAllowList vor stripPrefix und rateLimit; eine vorzeitige Pfadbereinigung verfälscht Authentifizierungsprüfungen und Zugriffs-Logs.

Sichere Sticky-Cookie-Flags

Koppeln Sie bei aktivierten Sticky-Sessions auf HTTPS-Routern eine Headers-Middleware ein, um HttpOnly, Secure und SameSite=Lax für das Session-Cookie zu erzwingen.

Häufige Fallstricke & Fehlerbehebung

Router-Syntaxfehler: Unerwartetes Backtick oder fehlende Klammer im Host- oder PathPrefix-Ausdruck

Umschließen Sie Domänen und Pfade zwingend mit Backticks (z. B. Host(`app.domain.com`)) statt Anführungszeichen und verknüpfen Sie Ausdrücke mit && oder ||.

Upstream-Dienst liefert 404 Not Found beim Routing über PathPrefix

Backend-Container erwarten Anfragen oft auf Root (/); binden Sie eine stripPrefix-Middleware an den Router ein, um das Pfadsegment vor der Weiterleitung abzutrennen.

ACME HTTP-01-Challenge schlägt auf reinen websecure-Routern fehl

Die HTTP-01-Validierung erfordert Port 80; stellen Sie sicher, dass der Port 'web' erreichbar ist, oder wechseln Sie auf den DNS-01-Challenge-Resolver.

Häufig gestellte Fragen (FAQ)

Welche Syntaxunterschiede bestehen zwischen Traefik v2 und v3 Router-Regeln?▼

Traefik v3 erzwingt eine striktere Funktionssyntax und entfernt veraltete kommagetrennte Matcher. Ausdrücke wie Host und PathPrefix müssen als standardisierte Funktionsaufrufe über && oder || verbunden werden.

Werden vertrauliche Daten wie Upstream-IPs oder TLS-Zertifikate an externe Server übertragen?▼

Nein. Die Generierung erfolgt vollständig lokal in der JavaScript-Laufzeit Ihres Browsers. Es werden weder Konfigurationsdateien, IPs noch Domänennamen an entfernte Server übermittelt.

Wie werden TCP- und HTTP-Router auf demselben EntryPoint voneinander abgegrenzt?▼

HTTP-Router analysieren Layer-7-Header wie Host und Path, während TCP-Router Layer-4-TLS-SNI über HostSNI(`domain.com`) auswerten oder mittels HostSNI(`*`) unverschlüsselten TCP-Traffic erfassen.

Wie lassen sich die generierten Konfigurationen in Docker Compose oder Kubernetes importieren?▼

Sie können die dynamic YAML-Ausgabe über Traefiks File-Provider (providers.file.directory) laden oder Direktiven in Docker-Container-Labels bzw. Kubernetes IngressRoute-CRDs überführen.

Verwandte Werkzeuge & Dienstprogramme

Alle Werkzeuge →