Ir para o conteúdo
Promovaweb

O Portainer atrás do Traefik com HTTPS

O Traefik é o proxy reverso que publica o painel do Portainer num domínio com HTTPS. Ele recebe a conexão na porta 443 e a encaminha à porta 9000 pela rede Docker, sem publicar essa porta do Portainer na VPS.

Ficha e sumário da página

Referência técnica
Portainer 2.45.3
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. Por que o painel fica atrás do proxy
  2. As labels do container do Portainer
  3. A porta 9000 dentro da rede
  4. O que o Portainer exige do proxy
  5. O domínio do painel e o certificado

Por que o painel fica atrás do proxy

A instalação oficial do Portainer publica a porta 9443 na VPS, com um certificado autoassinado gerado pelo próprio Portainer. O navegador abre o painel com o aviso de certificado não confiável, porque nenhuma autoridade reconhecida emitiu esse certificado. O domínio próprio, como portainer.seudominio.com.br, recebe um certificado do Let’s Encrypt que o Traefik renova sem intervenção.

O Traefik já ocupa as portas 80 e 443 da VPS nas stacks dos portais da Promovaweb. O Portainer entra nesse desenho como mais um app: o container dele fica na rede Docker compartilhada com o Traefik, sem nenhuma porta publicada no servidor. Toda requisição chega pelo Traefik, que termina o HTTPS e repassa a requisição em HTTP pela rede interna, como explica a página Como a rota funciona.

As labels do container do Portainer

O guia oficial do Portainer para o Traefik usa o provider Docker, que lê as labels de cada container. As labels do serviço do Portainer declaram dois routers. O primeiro atende o painel. O segundo atende o túnel dos Edge Agents, num domínio separado:

docker-compose.yml, labels do serviço portainer

Router do painel

traefik.enable=
Liga a leitura das labels deste container pelo Traefik.
traefik.http.routers.frontend.rule=
Host com o domínio do painel.
traefik.http.routers.frontend.entrypoints=
websecure, a porta 443.
traefik.http.routers.frontend.tls.certresolver=
O resolvedor ACME que emite o certificado.
traefik.http.services.frontend.loadbalancer.server.port=
9000, a porta HTTP do Portainer na rede interna.

Router do túnel Edge

traefik.http.routers.edge.rule=
Host com o domínio do túnel.
traefik.http.routers.edge.entrypoints=
websecure, também na porta 443.
traefik.http.routers.edge.tls.certresolver=
O mesmo resolvedor do painel.
traefik.http.services.edge.loadbalancer.server.port=
8000, o servidor de túnel do Portainer.
As labels do guia oficial Deploying Portainer behind Traefik Proxy, com o nome do resolvedor usado no exemplo. No guia oficial, o domínio aparece fixo em cada label. Nos Compose de estudo dos portais, ele vem do .env da stack.

Cada router aponta para um service próprio, porque o mesmo container atende duas portas internas. A label traefik.http.routers.frontend.service=frontend liga o router do painel ao service da porta 9000. A label equivalente do router do túnel faz a mesma ligação com o service da porta 8000. O guia oficial completa a stack do Traefik com o redirecionamento de toda requisição HTTP para HTTPS, o mesmo redirectscheme descrito na página Middlewares.

O router do túnel só faz falta com Edge Agents no modo Standard. Numa VPS única, com o Docker local conectado pelo socket, o router do painel basta. Para usar o domínio separado do túnel, o agente precisa receber o endereço externo correspondente. A Business Edition oferece esse campo na interface, enquanto a documentação da Community Edition remete ao ajuste da issue 6251 do projeto. A página Ambientes e agentes explica as conexões.

A porta 9000 dentro da rede

O Portainer atende HTTP na porta 9000 e HTTPS na 9443, conforme os valores padrão das flags --bind e --bind-https. A instalação oficial publica só a 9443 na VPS, mas o HTTP continua ligado dentro do container: no código da versão 2.45.3, uma instalação nova grava a configuração de SSL com o HTTP ativo. O Traefik usa essa porta 9000 pela rede Docker, sem publicação no servidor.

Apontar o Traefik para a 9000 mantém um só HTTPS na cadeia, o que o Traefik negocia com o navegador. A flag --http-disabled desliga o HTTP do Portainer. Com ela ligada, o router precisaria falar HTTPS com a porta 9443, que usa o certificado autoassinado. Nos portais, o Portainer fica com o HTTP interno e o Traefik cuida do certificado.

O que o Portainer exige do proxy

A documentação do Portainer reúne os cuidados com proxy reverso numa página própria. O primeiro é o cookie de autenticação. O Portainer marca o cookie como Secure quando acredita que a conexão do navegador usa HTTPS, o que acontece quando o próprio Portainer serve TLS na 9443 ou quando o proxy envia o cabeçalho X-Forwarded-Proto: https. O navegador descarta um cookie Secure recebido numa conexão HTTP. O sintoma é o login que falha com o erro 401, ou a sessão que cai logo depois de entrar.

A combinação que provoca esse erro tem um padrão conhecido: o navegador chega ao proxy em HTTP, pela porta 80, enquanto o proxy fala com o Portainer em HTTPS, pela 9443. Com o Traefik redirecionando todo HTTP para HTTPS e repassando à 9000, a visão do Portainer sobre o esquema da conexão coincide com a do navegador.

O Portainer também envia o cabeçalho Content-Security-Policy com frame-ancestors 'none', que recusa o painel dentro de um iframe. Um proxy que injeta scripts ou reescreve o conteúdo das páginas quebra a interface. A flag --no-csp desliga esse cabeçalho, com o alerta da documentação de que a mudança reduz a proteção do painel.

Na Business Edition, os logs de autenticação registram a origem de cada login. Atrás de um proxy, essa origem aparece como o IP do Traefik, a menos que o Portainer suba com --trusted-proxies e a faixa de IPs da rede do proxy. Com a flag, o Portainer lê o IP real no cabeçalho X-Forwarded-For enviado pelo Traefik.

O domínio do painel e o certificado

O certificado do domínio do Portainer sai do mesmo resolvedor ACME que atende os outros apps da VPS. O registro A do domínio precisa apontar para o IP do servidor. O resolvedor guarda o certificado no arquivo de armazenamento do Traefik, com permissão 600. O ciclo de emissão e renovação está na página Certificados HTTPS.

Com o painel no domínio, o endereço do Portainer fica sem porta explícita. A configuração inicial exige o token de setup antes da criação do administrador. Depois dela, o acesso usa a autenticação do painel. Quando nenhuma porta do Portainer está publicada na VPS, o navegador chega pela rota HTTPS do Traefik. O conjunto de redes, o lugar do Portainer entre as stacks e a divisão entre a rede do proxy e as redes internas de cada app estão na página O Traefik nas stacks dos portais.

Para revisar uma configuração de Docker ou de proxy com acompanhamento técnico, o Desenvolvimento Colaborativo da Dev Side Studio oferece trabalho ao vivo sobre o ambiente do seu projeto.

Continue na comunidade

Leve ao Discord da Promovaweb o erro da stack ou a conexão com o agente que falhou. Com o log e a edição do Portainer, a comunidade pode comparar a configuração.

Uma VPS para o seu Portainer

O painel precisa alcançar o Docker que executa suas stacks. Uma VPS da StayCloud oferece acesso root para manter o Docker e publicar o Portainer atrás do Traefik.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.