O que é o Traefik e para que serve
O Traefik Proxy é um proxy reverso de código aberto, mantido pela Traefik Labs sob licença MIT, que recebe as requisições da VPS nas portas 80 e 443 e entrega cada uma ao container certo pelo domínio da requisição. Ele encontra os apps sozinho, lendo as labels dos containers no Docker, e emite o certificado HTTPS de cada domínio pelo Let's Encrypt.
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
Uma porta pública para vários containers
Cada app escuta numa porta própria dentro do container: o n8n na 5678, o Chatwoot na 3000 e o Portainer na 9000. O navegador procura a porta 443 quando o endereço começa com https:// e a porta 80 quando começa com http://, por isso o visitante do seu app não digita porta nenhuma. Como só um processo consegue escutar a porta 443 do servidor, o Traefik ocupa essa porta e escolhe, a cada requisição, o container que vai responder:
VPS, portas 80 e 443O Traefik é o único processo que escuta a internet.n8n.seudominio.com.brVai para o container do n8n, na porta 5678.chat.seudominio.com.brVai para o container do Chatwoot, na porta 3000.metabase.seudominio.com.brVai para o container do Metabase, também na porta 3000.portainer.seudominio.com.brVai para o container do Portainer, na porta 9000.
A conexão HTTPS também termina no Traefik, que negocia a criptografia com o navegador usando o certificado do domínio. Do Traefik até o container, a requisição segue pela rede interna do Docker, que não fica exposta à internet, de modo que o app recebe a requisição sem precisar guardar certificado nenhum.
O que muda numa VPS com vários apps
Com um app só, você consegue publicar a porta dele direto na VPS. A partir do segundo app, a porta 443 precisa ser repartida, já que dois processos não escutam a mesma porta. O Traefik recebe todas as requisições nessa porta e distribui cada uma pelo domínio, sem que um app precise saber da existência dos outros.
Cada domínio também precisa de um certificado válido, emitido por uma autoridade que o navegador reconhece e renovado antes do vencimento. O Traefik solicita esses certificados ao Let’s Encrypt e renova cada um sem você entrar no servidor, mecanismo que a página Certificados HTTPS detalha.
Muda ainda o lugar onde a rota fica guardada. Num proxy configurado à mão, cada site ganha um arquivo na pasta do proxy, longe do Compose do app. Com o Traefik, a rota fica nas labels do próprio app e acompanha o container durante toda a vida dele:
Proxy configurado à mão
- Cada app novo exige um arquivo novo na configuração do proxy.
- O proxy recarrega a configuração depois de cada mudança.
- Outra ferramenta emite e renova o certificado de cada domínio.
- A remoção de um app inclui apagar o arquivo dele no proxy.
Traefik com o provider Docker
- Cada app declara a própria rota em labels, no Compose dele.
- O Traefik percebe o container novo e monta a rota sem reiniciar.
- O resolvedor ACME emite e renova o certificado de cada domínio.
- A rota some junto com o container quando ele para.
A descoberta automática vem dos providers. Um provider é uma fonte que o Traefik consulta para saber quais serviços existem, como o Docker, o Docker Swarm, o Kubernetes ou um arquivo de configuração. O Traefik lê a API do provider, encontra os serviços e monta as rotas com as informações declaradas neles. Quando um container sobe ou para, as rotas acompanham a mudança sem reinício do Traefik, como mostra a página Providers e labels.
Configuração de instalação e configuração de roteamento
O Traefik divide a configuração em duas partes com ciclos de vida diferentes. Essa divisão explica por que a stack do Traefik quase não muda enquanto as stacks dos apps ganham e perdem rotas ao longo do tempo.
A configuração de instalação, que a documentação antiga chamava de estática, define o que existe desde a partida do processo. Nela ficam as portas de entrada, chamadas entrypoints, os providers que o Traefik consulta e os resolvedores de certificado. Você escreve essa parte de um só jeito por vez, num arquivo de configuração, em argumentos de linha de comando ou em variáveis de ambiente, porque o Traefik não mistura as três formas. Num Compose, ela costuma aparecer como argumentos na chave command do serviço do Traefik.
A configuração de roteamento, antes chamada de dinâmica, reúne os routers, os services, os middlewares e os certificados que definem o caminho de cada requisição. Essa parte vem dos providers. As labels de um container, por exemplo, são configuração de roteamento lida pelo provider Docker. O Traefik recarrega essa configuração a quente, sem interromper requisições nem derrubar conexões abertas.
Por causa dessa divisão, a stack do Traefik guarda a configuração de instalação. A configuração de roteamento de cada app fica na stack do próprio app, por isso um app novo entra na VPS sem alteração nenhuma na stack do Traefik.
O lugar do Traefik nas stacks dos portais
Os portais da Promovaweb que publicam apps self-hosted usam o Traefik como a porta de entrada da VPS. O Traefik roda numa stack própria, com as portas 80 e 443 publicadas e o resolvedor do Let’s Encrypt ligado. Cada app mora em outra pasta, com o próprio Compose. Só o serviço web do app entra na rede Docker compartilhada que o Traefik alcança, enquanto o banco de dados do app fica fora dessa rede e sem rota nenhuma.
O Compose de estudo do n8n segue essa divisão. As redes, as portas de cada app e o conteúdo de cada stack estão na página O Traefik nas stacks dos portais.
Limites do Traefik
O Traefik não aponta o domínio para a VPS, tarefa que continua com o registro A no DNS do domínio. Sem esse registro apontado para a VPS, a requisição não chega ao servidor. O Traefik também não substitui o firewall, porque as portas que o sistema deixa abertas continuam abertas com ou sem ele.
O trabalho da aplicação também fica fora do Traefik. Ele não serve arquivos nem roda o seu código, apenas repassa cada requisição a um service, que é outro processo, como o container de um app. O uso do Traefik Proxy não exige licença paga. Os produtos comerciais da Traefik Labs, como o Traefik Hub, são vendidos à parte e ficam fora deste portal.
O próximo passo para entender o Traefik é seguir uma requisição por dentro dele, da porta de entrada até o app, na página Como a rota funciona.