Resumo

O Traefik 3.8.0-rc.1 amplia o suporte à Gateway API e acrescenta controle de timeout por roteador. A candidata muda a organização dos listeners e exige atualização dos recursos Kubernetes usados pelo provedor. Suas notas incluem correções acumuladas de outras publicações da linha 3.x, por isso a comparação deve considerar a versão instalada.

Novidades

Traefik 3.8.0-rc.1 — Roteadores: respondingTimeouts permite definir os tempos de leitura e escrita para um roteador específico, substituindo os valores do entry point nesse escopo.
Traefik 3.8.0-rc.1 — Gateway API: a versão inclui ListenerSet, espelhamento e repetição de requisições HTTPRoute. As políticas de TLS recebem suporte a certificados de cliente e referências ClusterTrustBundle.
Traefik 3.8.0-rc.1 — Middleware tap: requisições e respostas podem ser copiadas para serviços Traefik como registros JSON.
Traefik 3.8.0-rc.1 — Buffering: disableRequestBuffer e disableResponseBuffer permitem desativar separadamente os buffers de requisição e resposta.
Traefik 3.8.0-rc.1 — Domínios: Host e HostSNI aceitam o prefixo **. para subdomínios em vários níveis. O resolvedor ACME não emite um certificado para esse padrão.

Melhorias

Traefik 3.8.0-rc.1 — Certificados: reusePrivateKey permite reutilizar a chave privada no fluxo ACME. A opção peerCertSANs amplia a validação dos nomes alternativos do certificado nos transportes para backends.
Traefik 3.8.0-rc.1 — Kubernetes: a remoção de managedFields dos informers reduz o conteúdo mantido por esses componentes. Os listeners recebem roteadores próprios, com rotas filhas vinculadas ao listener correspondente.

Correções

Traefik 3.8.0-rc.1 — Autenticação: as notas incluem correções de isolamento e de liberação de conexões NTLM e Kerberos, inclusive no FastProxy.
Traefik 3.8.0-rc.1 — HTTP/3: os limites de leitura, o tempo ocioso e o tamanho máximo dos cabeçalhos são aplicados ao protocolo.
Traefik 3.8.0-rc.1 — Gateway API: as reescritas e os redirecionamentos preservam segmentos codificados do caminho. As condições de status pertencentes a outros controladores são conservadas.

Breaking changes

Traefik 3.8.0-rc.1 — Recursos Kubernetes: o provedor exige CRDs (Custom Resource Definitions) da Gateway API 1.6.1 e remove o suporte à 1.5.x. Atualize as definições e os manifests TCPRoute para gateway.networking.k8s.io/v1.
Traefik 3.8.0-rc.1 — Listeners TLS: os listeners HTTPS recebem opções próprias e não utilizam automaticamente as opções TLS padrão. Revise hosts compartilhados com outros provedores, pois conflitos podem desativar roteadores quando core.strictTLSOptions está habilitado.
Traefik 3.8.0-rc.1 — Seleção de Gateway: definir simultaneamente labelSelector e gatewayClass produz erro. Migre a seleção para gatewayClass, pois labelSelector está descontinuado.
Traefik 3.8.0-rc.1 — ConfigMap: strings no formato urn:k8s:configmap:<nome>:<chave> são resolvidas como referências. Uma referência inválida remove o Middleware da configuração de roteamento. Confira configurações de plugins que utilizavam esse texto literalmente.

Ponto de Atenção

Nesta pré-release, o uso de ListenerSet e ClusterTrustBundle exige permissões adicionais no Kubernetes. O ClusterTrustBundle depende também da API certificates.k8s.io/v1, disponível a partir do Kubernetes 1.37 segundo o guia.

Teste sugerido: atualize as definições de recursos num cluster de homologação e aplique um TCPRoute com versão v1. Confira o roteamento de dois listeners que compartilham o entry point e as opções de certificado aplicadas. Avalie o middleware tap somente com tráfego de teste, pois ele copia o conteúdo das requisições e respostas.

Notas da versão

O Traefik 3.8.0-rc.1 foi publicado em 30/10/2026 como pré-release. O guia de migração da linha 3.8 documenta os recursos e ajustes necessários.

Traefik 3.8.0-rc.1