Ir para o conteúdo
Promovaweb

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
  1. Uma porta pública para vários containers
  2. O que muda numa VPS com vários apps
  3. Configuração de instalação e configuração de roteamento
  4. O lugar do Traefik nas stacks dos portais
  5. Limites do Traefik

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.
Os quatro domínios apontam para o mesmo IP da VPS, onde só o Traefik escuta as portas públicas. O Chatwoot e o Metabase usam a mesma porta 3000 sem conflito, porque cada um escuta dentro do próprio container.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.