Ir para o conteúdo
Promovaweb
Portal independente da Promovaweb

Traefik Cada app da VPS no próprio domínio, com HTTPS.

O Traefik é um proxy reverso de código aberto que fica na entrada da VPS e encaminha cada visita ao app certo. Ele cria a rota quando o app sobe e renova o certificado antes de vencer, sem arquivo de proxy para você editar.

Código aberto sob licença MIT, mantido pela Traefik Labs. Assuntos conferidos na versão 3.7.19.

Veja como ele cria a rota e renova o certificado de cada domínio.
  1. RotasUm domínio novo entra no ar sem mexer em Nginx.
  2. CertificadosO HTTPS renova antes de vencer, sem você agendar nada.
  3. SegurançaSenha e limite de acesso antes de chegar ao app.
  4. ConfiguraçãoA rota fica nas labels do Compose de cada app.

O Traefik recebe cada visita e encaminha ao app do domínio

Um proxy reverso de código aberto que recebe todo o tráfego da VPS e repassa cada requisição ao app do domínio certo.

Um roteador na frente de todos os apps

O Traefik Proxy ocupa as portas 80 e 443 da VPS, recebe cada requisição que chega da internet e repassa ao container que responde por aquele domínio. O n8n, o Chatwoot e o Portainer continuam escutando nas portas internas deles, a 5678, a 3000 e a 9000, enquanto o visitante abre cada app pelo endereço com HTTPS, sem digitar porta nenhuma.

A diferença para um proxy configurado à mão está no lugar onde a rota fica escrita. O Traefik lê as labels de cada container pela API do Docker, monta a rota quando o container sobe e desfaz a rota quando ele para. Com o mesmo domínio declarado na label, o Traefik solicita o certificado ao Let's Encrypt e cuida da renovação.

A manutenção de proxy que o Traefik tira de você

  • Um arquivo de proxy para cada site. Num Nginx configurado à mão, cada app novo exige um arquivo na pasta do proxy e um recarregamento. Com o Traefik, o domínio fica numa label do Compose do app e a rota aparece quando o container sobe.
  • Certificado com data para vencer. O Let's Encrypt emite certificados de 90 dias. O Traefik renova cada um 30 dias antes do vencimento, sem tarefa agendada no servidor e sem outra ferramenta para emitir o HTTPS.
  • Dois apps querendo a porta 443. Dois processos não escutam a mesma porta. O Traefik fica com a 443 e reparte as requisições pelo domínio, por isso o Chatwoot e o Metabase usam a porta 3000 cada um no próprio container, sem conflito.
  • Painel exposto na internet. Um middleware exige usuário e senha ou limita as requisições de cada origem na frente do app, sem mudar uma linha do código dele.

Os labels do container dizem ao Traefik qual rota criar

Toda requisição HTTP percorre as mesmas peças, numa ordem fixa. O exemplo abaixo acompanha um n8n publicado em n8n.seudominio.com.br.

  1. EntradaO Traefik recebe a visita na porta 443 da VPS.
  2. RotaEle compara o domínio da requisição com a regra de cada app.
  3. AppO Traefik repassa a visita ao container do n8n.
A conexão HTTPS termina no Traefik. Do Traefik até o container, a requisição segue pela rede interna do Docker, por isso o app não guarda certificado nenhum.
Veja como ele escolhe o app pelo domínio

VPS com vários apps em Docker é o lugar do Traefik

  • Vários apps numa VPS com Docker. A partir do segundo app, a porta 443 precisa ser repartida pelo domínio, que é o trabalho principal do Traefik.
  • Stacks em Compose ou no Swarm. O provider Docker e o provider Swarm leem as labels dos serviços, por isso a rota acompanha o deploy de cada stack.
  • Uma VPS que ganha e perde apps. Instalar ou remover um app altera só a pasta dele. A stack do Traefik continua como estava.

Uma pasta de HTML sem containers dispensa o proxy

  • Só uma pasta de HTML para publicar. O Traefik repassa requisições a outro processo e não serve arquivos. Para um site estático sem outros apps na VPS, um servidor web como o Nginx faz o trabalho com uma peça a menos.
  • Servidor sem containers. A descoberta pelas labels depende do Docker, do Swarm ou do Kubernetes. Sem eles, cada rota volta para um arquivo YAML do provider de arquivo, escrito à mão como em outros proxies.

DNS, firewall e código do app seguem fora do proxy

  • O DNS do domínio. O registro A continua no seu provedor de DNS. Sem ele apontado para o IP da VPS, a requisição não chega ao Traefik.
  • O firewall da VPS. As portas abertas no sistema continuam abertas com ou sem o Traefik, que não substitui o firewall.
  • O código do app. O Traefik não roda o seu código nem serve arquivos. Ele repassa cada requisição a um service, que é outro processo, como o container do app.
Mantenedor
Traefik Labs. O Traefik Hub e os outros produtos comerciais da empresa são vendidos à parte e ficam fora deste portal.
Versão de referência
v3.7.19, a mesma usada nos assuntos deste portal.

Middlewares que ajustam a requisição sem mexer no app

Veja o que cada middleware faz

Cada domínio encontra o seu app

Você publica cada app no próprio domínio e deixa a renovação do certificado com o proxy. As rotas acompanham a entrada e a saída dos containers.

Changelog

Últimas versões do Traefik

Ver o changelog completo
  1. Traefik 3.8.0-rc.3Pre-releaseLer as notas
  2. Traefik 3.7.19StableLer as notas
  3. Traefik 2.11.63StableLer as notas
  4. Traefik 3.8.0-rc.2Breaking changeLer as notas

Portais relacionados

Sistemas ligados a este nas stacks e nos projetos, cada um com o próprio portal.

Continue na comunidade

Leve ao Discord da Promovaweb a rota que não abre ou o certificado que não sai. Com o log do Traefik na conversa, a comunidade compara o seu caso com stacks parecidas.

Uma VPS para o seu Traefik

O Traefik precisa das portas 80 e 443 livres e de acesso root para rodar o Docker. A VPS da StayCloud em São Paulo vem com acesso root, as portas livres e disco NVMe para os apps.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.