O Traefik nas stacks dos portais
Nas stacks dos portais da Promovaweb, um único Traefik ocupa as portas 80 e 443 da VPS e atende o n8n, o Chatwoot, o Metabase e o Portainer, cada um no próprio subdomínio e com o próprio certificado. Cada app mora numa pasta com o próprio Compose e entra na rede proxy só pelo serviço web, por isso os bancos de dados dos apps ficam sem rota.
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
Por que um só Traefik para vários apps
Uma VPS com vários apps self-hosted tem um endereço IP e uma porta 443. O Traefik ocupa essa porta e reparte as requisições pelo domínio. Os apps não publicam porta nenhuma na VPS e recebem as requisições do Traefik pela rede interna do Docker.
Essa divisão deixa cada stack com uma tarefa. A stack do Traefik guarda o que vale para todos os apps: as portas de entrada, o provider Docker e o resolvedor do Let’s Encrypt. A stack de cada app guarda, em labels, o que é só dele, como o domínio, a porta interna e os middlewares. Quando você instala um app novo, só a pasta desse app muda. Quando um app sai da VPS, a rota dele some junto com o container.
O certificado segue a mesma divisão: cada router com a label do resolvedor ganha o próprio certificado, emitido e renovado pelo Traefik, sem nenhuma configuração de HTTPS dentro do app.
Duas redes em cada app
As stacks dos portais usam duas redes Docker. A rede proxy, criada uma vez na VPS fora de qualquer Compose, aparece como external em cada stack. O Traefik e o serviço web de cada app entram nela. Os serviços de apoio, como o banco de dados e o Redis, ficam numa rede interna da própria stack, fora do alcance do Traefik:
rede proxy (external)Criada uma vez na VPS. O Traefik e o serviço web de cada app entram nela.traefikPublica as portas 80 e 443 na VPS e lê os containers pelo provider Docker.n8nAtende na porta 5678. Também está na rede interna da stack do n8n.postgresBanco do n8n, só na rede interna.chatwootAtende na porta 3000. Também está na rede interna da stack do Chatwoot.postgres e redisBanco e fila do Chatwoot, só na rede interna.metabaseAtende na porta 3000, no próprio container.portainerAtende na porta 9000, em HTTP.
No Compose de um app, a divisão aparece na lista de redes de cada serviço: o serviço web declara as duas redes, ao passo que o banco declara só a rede interna.
services: app: networks: - proxy - interna banco: networks: - interna
networks: proxy: external: true interna:Com o app em duas redes, o Traefik precisa saber por qual delas repassar a requisição. A opção providers.docker.network=proxy, na stack do Traefik, define essa rede para todos os apps. Sem ela, o Traefik escolhe ao acaso uma das redes do container.
A porta interna de cada app
Cada imagem atende numa porta dentro do container, informada ao Traefik pela label loadbalancer.server.port do app:
| App | Porta interna | Fonte |
|---|---|---|
| n8n | 5678 |
documentação oficial do n8n |
| Chatwoot | 3000 |
documentação oficial do Chatwoot |
| Metabase | 3000 |
documentação oficial do Metabase |
| Portainer | 9000 (HTTP) |
documentação oficial do Portainer |
O Chatwoot e o Metabase usam a mesma porta 3000 sem conflito, porque a porta pertence a cada container, não à VPS. O Portainer também atende em 9443, com um certificado próprio. Atrás do Traefik, a porta usada é a 9000, porque o HTTPS fica com o Traefik e com o certificado do Let’s Encrypt.
O que fica em cada stack
A stack do Traefik é curta: o serviço publica as portas 80 e 443, monta o socket do Docker e guarda o acme.json num volume. Os argumentos de partida ligam o provider Docker com exposedByDefault=false, os entrypoints web e websecure, o redirecionamento da porta 80 para a 443 e o resolvedor letsencrypt. O .env dessa stack guarda o e-mail cadastrado no Let’s Encrypt e o domínio base.
A stack de cada app acrescenta dois itens ao Compose que o app já teria: a rede proxy no serviço web e as labels da rota. No n8n, as labels ficam assim:
labels: - traefik.enable=true - traefik.http.routers.n8n.rule=Host(`n8n.seudominio.com.br`) - traefik.http.routers.n8n.entrypoints=websecure - traefik.http.routers.n8n.tls.certresolver=letsencrypt - traefik.http.services.n8n.loadbalancer.server.port=5678Nos outros apps, mudam o nome do router e do service, o domínio e a porta da tabela. A página Providers e labels explica o que cada linha declara.
O mesmo desenho num cluster Swarm
Num cluster Swarm, o desenho se mantém com três diferenças:
- Provider: o Traefik usa o provider
swarme lê as labels dentro dedeploy.labels. - Porta: a label
loadbalancer.server.porté obrigatória, porque o Swarm não informa as portas dos serviços. - Rede: a rede compartilhada é uma rede
overlay, que alcança os serviços em todas as máquinas do cluster.
A ligação com os outros portais
Os portais da Promovaweb que publicam apps self-hosted partem dessa divisão. O Compose de estudo do n8n traz o Traefik na mesma VPS, com o .env completo e o HTTPS do Let’s Encrypt. Quando um portal mostra o Compose de um app, as labels e a rede proxy seguem o desenho desta página.
Quando um app não abre, a investigação percorre os mesmos pontos em qualquer stack: o router no dashboard, os logs do resolvedor e a porta do service. A página Dashboard, logs e métricas mostra onde ler cada um.
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.
Link de parceiro da Promovaweb.