Gerador de Configuração Dinâmica Traefik v3
Proxy reverso moderno nativo da nuvem

Gerador de Configuração Dinâmica Traefik v3

Especificação de produção e guia prático para gerar configurações dinâmicas de roteamento, middlewares e TLS no Traefik v2 e v3.

Multi-Format: YAML • TOML • Docker Labels • IngressRoute
Predefinições:
Assistente de Regras
Nome do host
PathPrefix
Operador
Cert Resolver (ACME)
Domínios / SANs
Routers: 2•Middlewares: 3•Services: 2
# 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"
Format: yaml•Lines: 109•Chars: 2829•Bytes: 2829 B
Roteadores Configurados
2 Regras ativas
Middlewares Ativos
3 Cadeias
Pronto para Traefik v3.x
Traefik v3.x Ready

100% Execução Local no Navegador

Sem envios para servidores ou telemetria. Suas regras de proxy e credenciais são processadas com total sigilo na sua máquina.

Compatibilidade Rigorosa Traefik v3

Gera sintaxe moderna v3 com ipAllowList, regras com crases e conjuntos criptográficos TLS de última geração.

Exportação em Múltiplos Formatos

Exporte instantaneamente para arquivos YAML, TOML dinâmicos, rótulos Docker Compose e CRDs IngressRoute do Kubernetes.

Referência técnica e guia de arquitetura

Referência de Desenvolvimento do Traefik Config Generator — Guia de referência

Especificação de produção e guia prático para gerar configurações dinâmicas de roteamento, middlewares e TLS no Traefik v2 e v3.

Parâmetros principais e controles

rulestring

Expressão de roteamento do Traefik que valida atributos de requisições HTTP/TCP como Host, PathPrefix ou Headers através de operadores lógicos.

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

Portas de rede e listeners declarados na configuração estática aos quais o roteador se vincula (por exemplo, web ou websecure).

Padrão: ["websecure"]
certResolverstring

Identificador do resolvedor ACME definido na configuração estática responsável pela emissão e renovação automática de certificados Let's Encrypt.

Padrão: "letsencrypt"
healthCheckPathstring

Endpoint HTTP sondado periodicamente pelo Traefik para monitorar a integridade das instâncias backend antes do balanceamento.

Padrão: "/healthz"
passHostHeaderboolean

Define se o Traefik mantém o cabeçalho Host original enviado pelo cliente ao encaminhar requisições ao backend.

Padrão: true

Dicas profissionais e melhores práticas

Otimização de Prioridade

Em rotas com PathPrefix sobrepostos (ex.: /api e /api/v2), atribua uma prioridade numérica explícita à rota mais restritiva para evitar ambiguidades no roteamento.

Sequência de Middlewares

Ordene redirectScheme e ipAllowList antes de stripPrefix e rateLimit; a remoção antecipada de prefixos invalida políticas de autenticação e logs de acesso.

Flags de Cookies Persistentes

Ao habilitar sticky sessions em entrypoints TLS, associe um middleware de cabeçalhos de segurança para aplicar flags HttpOnly, Secure e SameSite=Lax ao cookie de sessão.

Problemas comuns e solução de problemas

Erro de sintaxe no roteador: crase inesperada ou parêntese ausente na regra Host ou PathPrefix

Utilize crases para delimitar domínios e caminhos (ex.: Host(`app.exemplo.com`)) em vez de aspas duplas, conectando múltiplas condições com && ou ||.

Serviço upstream retorna erro 404 Not Found ao receber requisições com PathPrefix

Contêineres backend frequentemente escutam na raiz (/); adicione o middleware stripPrefix à cadeia do roteador para remover o prefixo antes do encaminhamento.

Validação ACME HTTP-01 falha em roteadores associados exclusivamente ao websecure

O desafio HTTP-01 exige tráfego na porta 80; certifique-se de manter o entryPoint 'web' acessível ou alterne o resolvedor estático para o método DNS-01.

Perguntas frequentes (FAQ)

Quais são as diferenças de sintaxe nas regras de roteadores entre o Traefik v2 e v3?▼

O Traefik v3 adota validação sintática estrita e descontinua o uso de regras separadas por vírgulas. Condições como Host e PathPrefix devem ser estruturadas como funções unidas por && ou ||.

O gerador envia endereços de backend ou chaves de certificados para servidores externos?▼

Não. Todo o processamento ocorre localmente no motor JavaScript do seu navegador. Nenhum arquivo YAML, endereço IP, domínio ou credencial é transmitido externamente.

Como diferenciar roteadores TCP e HTTP configurados no mesmo entryPoint?▼

Roteadores HTTP inspecionam cabeçalhos de Camada 7 (Host, Path), enquanto roteadores TCP avaliam o SNI TLS de Camada 4 com HostSNI(`dominio.com`) ou capturam conexões brutas com HostSNI(`*`).

Como injetar as configurações dinâmicas geradas no Docker Compose ou Kubernetes?▼

Você pode carregar o arquivo YAML resultante pelo file provider do Traefik (providers.file.directory) ou converter as instruções em labels do Docker ou manifestos IngressRoute do Kubernetes.

Ferramentas e utilitários relacionados

Todas as ferramentas →
Referência de Desenvolvedor para Caddyfile GeneratorDesenvolvimento

Guia técnico e referência de configuração para geração de arquivos Caddyfile voltados a ambientes de produção.

Abrir ferramenta→
Guia do Desenvolvedor: Benchmark de Compressão Brotli & Gzip e Estimador de Economia de BandaDesenvolvimento

Analise payloads de texto, CSS e JS usando a API nativa CompressionStream, estimando taxas de compressão Brotli/Gzip e tempos de carregamento em redes móveis 3G/4G.

Abrir ferramenta→
Guia do Desenvolvedor do Conversor de Protobuf .proto para Interfaces e Enums TypeScriptDesenvolvimento

Analise definições de mensagens Protocol Buffers (proto2 e proto3), enums e campos aninhados em interfaces TypeScript limpas.

Abrir ferramenta→
Guia do Desenvolvedor: Gerador de Documentação OpenAPI e Swagger para MarkdownDesenvolvimento

Converta especificações OpenAPI 3.0 e Swagger 2.0 JSON/YAML em documentação de referência de API em GitHub Flavored Markdown limpa e estruturada.

Abrir ferramenta→
Conversor de GraphQL SDL para Esquema Prisma (Modelos e Relações)Desenvolvimento

Traduza tipos de objetos, enums e diretivas da linguagem de definição de esquema GraphQL (SDL) em modelos e relações limpas do Prisma ORM.

Abrir ferramenta→
Guia do Desenvolvedor: Gerador de Entidades TypeORM a partir de SQL DDL (Entidades TypeScript)Desenvolvimento

Converta instruções SQL CREATE TABLE DDL em classes de entidade TypeORM em TypeScript com decoradores @Column, @PrimaryGeneratedColumn, relações e índices.

Abrir ferramenta→