Easypanel com aplicação fora do ar? Como diagnosticar erro 502, SSL, domínio e Traefik

Você entra no painel, encontra o container aparentemente saudável e, mesmo assim, a aplicação não abre pelo domínio. O navegador pode exibir 502 Bad Gateway, timeout, certificado inválido ou simplesmente não receber resposta. Em outros casos, a aplicação funciona internamente, mas não externamente.

Quando o Easypanel está fora do ar para o usuário, a causa nem sempre está no código. A requisição atravessa várias camadas: aplicação → container → Docker → rede → Traefik → SSL → DNS → Cloudflare → internet. Diagnosticar é descobrir até onde ela chega.

Container saudável não significa aplicação acessível

“Running” confirma que o processo principal do container está em execução. Um healthcheck verde confirma apenas o teste configurado — e esse teste pode avaliar uma rota, porta ou dependência diferente daquela usada pelo público.

Erro 502 Bad Gateway no Easypanel

Um Easypanel erro 502 indica, em geral, que um gateway recebeu a requisição, mas não conseguiu obter uma resposta válida do backend. Isso localiza o sintoma entre proxy e aplicação; não confirma sozinho a causa.

• Aplicação parou de responder ou reinicia continuamente.
• Porta de destino ou variável PORT está incorreta.
• Processo escuta somente em 127.0.0.1.
• Traefik não alcança o container pela rede Docker.
• Protocolo interno HTTP/HTTPS foi configurado incorretamente.
• Healthcheck valida um sinal que não representa a rota real.

Compare o horário do 502 com os logs da aplicação e do Traefik. Em seguida, confirme em qual endereço e porta o processo realmente escuta. Uma hipótese vira causa confirmada somente quando logs, configuração ou teste reproduzível demonstram a falha.

Domínio configurado, mas a aplicação não abre

Se o domínio no Easypanel não funciona, revise a entrada e a saída da rota:

• O registro A aponta para o IPv4 correto? Um registro AAAA antigo envia parte dos acessos a outro servidor?
• O servidor responde externamente e as portas 80 e 443 estão acessíveis?
• Firewall da VPS, provedor ou rede está bloqueando o tráfego?
• O hostname exato foi vinculado ao serviço e à porta interna corretos?
• Existe proxy da Cloudflare, cache ou regra de segurança no caminho?

DNS correto prova apenas que o nome resolve para um endereço. Não prova que a aplicação, o proxy ou o HTTPS estejam funcionando nesse destino.

Problemas de SSL no Easypanel

Quando o SSL do Easypanel não funciona, pode surgir um certificado padrão, expirado ou incompatível com o domínio. Também pode não haver certificado porque a validação do emissor falhou.

As hipóteses mais comuns são DNS apontando para o servidor errado, portas 80/443 bloqueadas, proxy da Cloudflare interferindo, tentativas excessivas atingindo limites de emissão ou falha do Traefik. O Let’s Encrypt informa que o desafio HTTP-01 ocorre na porta 80; portanto, essa porta precisa estar publicamente alcançável quando esse método é usado.

Traefik: a camada que muita gente esquece

O Easypanel usa o Traefik como proxy reverso. O fluxo simplificado é usuário → DNS → servidor → Traefik → aplicação. O proxy recebe a conexão, escolhe a rota pelo domínio, termina o TLS quando aplicável e encaminha o pedido à porta interna.

Assim, a aplicação pode responder dentro do container e continuar invisível ao público. Rotas conflitantes, porta errada, rede ausente, middleware, certificado ou configuração do domínio podem interromper o fluxo. Os logs do Traefik mostram se a requisição chegou e qual erro ocorreu ao tentar acessar o backend.

Easypanel + Cloudflare

Com Easypanel e Cloudflare, compare o que acontece na borda e na origem. Proxy ativado, DNS incorreto, WAF, regras de firewall, cache e redirecionamentos podem alterar o resultado. Um modo SSL incompatível com o HTTPS da origem também pode criar loop; no modo Flexible, por exemplo, a Cloudflare acessa a origem por HTTP, o que conflita com origens que sempre redirecionam para HTTPS.

Não desative a Cloudflare permanentemente. Use eventos, cabeçalhos e um teste controlado para separar falha de borda e falha de origem; depois restaure ou ajuste as proteções necessárias.

Quando o problema acontece depois de uma atualização

Se n8n, Evolution API e outra aplicação deixam de responder ao mesmo tempo após uma atualização ou mudança de DNS, é improvável que três aplicações independentes tenham quebrado juntas. Comece pelos componentes compartilhados: servidor, recursos, Docker, rede, Traefik, DNS e SSL.

Registre a mudança, o horário e quais serviços foram afetados. Isso ajuda a distinguir coincidência de causalidade e evita reverter aplicações saudáveis quando a falha está na infraestrutura comum.

Checklist rápido de diagnóstico

1. 1A VPS está online e responde externamente?
2. 2CPU, RAM, disco e inodes estão em níveis normais?
3. 3O container está executando sem reinícios recorrentes?
4. 4Os logs da aplicação mostram erro no horário da falha?
5. 5A aplicação responde internamente na porta esperada?
6. 6Domínio, protocolo e porta de destino estão corretos?
7. 7O Traefik está ativo e alcança a rede do serviço?
8. 8Registros A e AAAA resolvem para os IPs corretos?
9. 9Portas 80 e 443 estão acessíveis pela internet?
10. 10Certificado e Cloudflare estão coerentes com a origem?

O que não fazer durante uma indisponibilidade

Não reinstale tudo, apague containers ou volumes, recrie o banco, exclua certificados nem altere várias configurações simultaneamente. Também não atualize todas as aplicações nem desative a segurança de forma permanente apenas para testar.

Mudanças aleatórias eliminam evidências, ampliam o impacto e podem transformar uma falha simples de roteamento em perda de dados. Preserve volumes, registre o estado atual e faça uma alteração controlada por vez, com possibilidade de retorno.

Quando procurar suporte especializado

Procure suporte Easypanel quando uma aplicação de produção está parada, vários serviços falham, o container funciona mas o domínio não, ou os logs não permitem confirmar a causa. Erros de Traefik e SSL, mudanças que pioraram o cenário e risco para dados também justificam escalar o atendimento.

Ambientes com n8n, Evolution API, APIs e bancos exigem cuidado adicional com eventos pendentes, sessões e persistência. O objetivo inicial deve ser confirmar a camada defeituosa e preservar os dados antes de aplicar a correção.

Fontes técnicas oficiais

Conteúdo revisado em 20 de agosto de 2026. Interfaces e opções podem mudar conforme a versão instalada e a arquitetura do ambiente.

• Easypanel: domínios, porta de destino e escuta da aplicação
• Easypanel: domínios em serviços Compose
• Let’s Encrypt: desafios de validação e porta 80
• Cloudflare: modos SSL e loops de redirecionamento