O que os middlewares fazem no caminho
Um middleware é uma peça do Traefik que altera a requisição entre o router e o service, antes que ela chegue ao app. Com middlewares, o Traefik redireciona o acesso HTTP para HTTPS, exige usuário e senha na frente de um painel, limita a taxa de requisições de cada origem e acrescenta cabeçalhos de segurança à resposta, sem nenhuma mudança no código do app.
Ficha e sumário da página
- Referência técnica
- Traefik v3.7.19
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Onde o middleware se prende
O middleware age na ida da requisição e, em alguns tipos, também na volta. O Headers, por exemplo, acrescenta cabeçalhos tanto à requisição que segue para o app quanto à resposta que o app devolve ao navegador.
Um middleware se prende a um router ou a um service. Preso ao router, ele vale para as requisições que satisfazem a condição daquele router. Preso ao service, ele vale para tudo o que o service atende, venha de qual router vier. Quando os dois existem, os middlewares do router rodam primeiro e os do service rodam depois.
Num container, duas labels montam o middleware: a primeira cria a peça com um nome seu, no formato traefik.http.middlewares.<nome>.<tipo>.<opção>. A segunda liga a peça ao router, no formato traefik.http.routers.<router>.middlewares=<nome>. Um middleware criado uma vez serve a vários routers pelo mesmo nome, por isso você não precisa repetir a mesma configuração em cada app.
RedirectScheme, BasicAuth, RateLimit e Headers
A documentação lista 24 middlewares HTTP no Traefik Proxy, em ordem alfabética do AddPrefix ao StripPrefixRegex. Numa VPS com apps self-hosted, quatro deles aparecem com mais frequência.
RedirectScheme troca o esquema da URL, como no envio de http:// para https://. Quando o redirecionamento vale para todos os apps, o lugar mais simples é o entrypoint da porta 80, descrito na página Como a rota funciona. O middleware faz sentido quando só um app precisa desse redirecionamento.
BasicAuth exige usuário e senha antes de repassar a requisição. A lista de usuários segue o formato do htpasswd, com a senha já cifrada. Dentro de um compose.yaml, cada cifrão dessa linha vira $$, porque o Docker Compose lê $ como início de variável. O BasicAuth atende bem painéis de uso interno, como o do Portainer ou o dashboard do próprio Traefik.
RateLimit mede as requisições de cada origem e recusa o excesso com 429 Too Many Requests, de acordo com três opções:
- average: a média de requisições aceita por período. O padrão
0desliga o limite. - period: o período dessa média, de um segundo por padrão.
- burst: o pico aceito de uma vez, com padrão
1.
Sem outra configuração, o RateLimit identifica a origem pelo endereço remoto da conexão.
Headers acrescenta cabeçalhos à requisição ou à resposta. O conjunto de segurança é o uso mais conhecido desse middleware:
- stsSeconds: liga o HSTS, que orienta o navegador a usar só HTTPS no domínio.
- frameDeny: recusa a exibição da página dentro de um
iframe. - contentTypeNosniff: orienta o navegador a respeitar o tipo de arquivo declarado pelo servidor.
Outros middlewares entram conforme o app:
- IPAllowList: aceita só as conexões vindas de uma lista de IPs.
- StripPrefix: remove o começo do caminho antes de repassar a requisição, útil para o app que não sabe que mora em
/painel. - Compress: comprime a resposta do app.
- ForwardAuth: delega a autenticação a outro serviço.
A ordem do encadeamento
A label middlewares do router aceita uma lista de nomes separados por vírgulas. O Traefik aplica os middlewares na ordem dessa lista, por isso, com a label abaixo, o painel recebe primeiro os cabeçalhos de segurança e só depois exige a senha:
labels: - traefik.http.routers.painel.middlewares=seguranca,painel-authRouter
painelA condição corresponde ao domínio do painel.
Headers
segurancaAcrescenta o HSTS e os demais cabeçalhos de segurança.
BasicAuth
painel-authExige usuário e senha. Sem eles, responde 401.
Service
painel:9000Recebe só a requisição que passou pelos dois middlewares.
A posição na lista muda o resultado, porque cada middleware enxerga só o tráfego que passou pelos anteriores. Um RateLimit colocado antes do BasicAuth mede também as tentativas com senha errada. Colocado depois do BasicAuth, ele mede só as requisições já autenticadas.
Quando o mesmo conjunto se repete em vários apps, o middleware Chain junta vários middlewares sob um nome só. Cada router cita a cadeia pelo nome, de modo que uma mudança na cadeia vale para todos os apps que a usam.
Middlewares que moram fora do container
Um middleware compartilhado pode morar no provider de arquivo, num YAML lido pelo Traefik. Nas labels de um app, ele aparece com o sufixo do provider, como em seguranca@file. Com isso, os cabeçalhos de segurança ficam num único arquivo, citado pelo nome em cada app.
Alguns middlewares da documentação, como APIKey, JWT, OIDC e WAF, levam a marca do Traefik Hub API Gateway, o produto comercial da Traefik Labs. Esses middlewares ficam fora do Traefik Proxy. A comunidade também publica plugins de middleware no catálogo de plugins do Traefik, à parte da lista oficial.
Com a requisição ajustada no caminho, falta o que faz o cadeado aparecer no navegador: os certificados HTTPS.