Mailcow SOGo 504 Gateway Time-out: Como Resolver Agora

By HelpSysAdminMonitoramento e Troubleshooting (Diagnóstico)
Mailcow SOGo 504 Gateway Time-out

Introdução

O erro mailcow sogo 504 gateway time-out é um dos problemas mais comuns em ambientes Mailcow utilizando Docker. Quando esse erro aparece, normalmente o webmail deixa de responder, o login demora excessivamente e os usuários não conseguem acessar mensagens, calendários ou contatos.

Na maioria dos casos, o problema está relacionado a:

  • containers travados;
  • sobrecarga de CPU;
  • falta de memória RAM;
  • MariaDB lento;
  • Dovecot congestionado;
  • timeout do Nginx;
  • armazenamento insuficiente.

Entender a causa do mailcow sogo 504 gateway time-out é fundamental para restaurar rapidamente o funcionamento do servidor de e-mail.

Neste guia completo você aprenderá:

  • o que significa o erro;
  • principais causas;
  • como diagnosticar;
  • comandos úteis;
  • soluções rápidas;
  • otimizações preventivas.

O Que Significa o Erro 504 Gateway Time-out no SOGo?

O erro mailcow sogo 504 gateway time-out acontece quando o Nginx não consegue obter resposta do backend do SOGo dentro do tempo configurado.

O fluxo do Mailcow normalmente funciona assim:

Usuário → Nginx → SOGo → Dovecot → MariaDB

Se qualquer componente ficar lento:

  • o webmail trava;
  • o login demora;
  • páginas não carregam;
  • o erro 504 aparece.

Esse comportamento é muito comum em VPS pequenas ou servidores sobrecarregados.

Principais Causas do Erro 504 no SOGo

Container do SOGo travado

Uma das causas mais frequentes do mailcow sogo 504 gateway time-out é o container do SOGo entrar em estado:

  • unhealthy;
  • restarting;
  • exited.

Isso geralmente ocorre após:

  • falta de RAM;
  • uso excessivo de swap;
  • travamento do banco de dados;
  • sobrecarga do Docker.

MariaDB lento

O SOGo depende diretamente do banco de dados.

Quando o MariaDB apresenta lentidão:

  • login demora;
  • sincronização falha;
  • webmail trava;
  • timeout aparece.

O problema pode ocorrer por:

  • disco lento;
  • queries pesadas;
  • falta de índices;
  • memória insuficiente.

Problemas no Dovecot

O Dovecot é responsável pelo IMAP no Mailcow.

Quando o Dovecot fica lento:

  • mensagens não carregam;
  • caixas postais travam;
  • autenticação demora;
  • o mailcow sogo 504 gateway time-out pode aparecer.

VPS com pouca memória

Mailcow exige recursos relativamente altos.

Ambientes com:

  • 2 GB RAM;
  • 1 vCPU;
  • HDD lento;

normalmente apresentam instabilidade.

O Docker pode consumir rapidamente toda memória disponível, causando swap excessiva e travamento dos containers.

Como Diagnosticar o Erro 504 no SOGo

Verifique containers ativos

O primeiro passo é verificar os containers:

docker ps

Confira principalmente:

  • sogo-mailcow;
  • nginx-mailcow;
  • mysql-mailcow;
  • dovecot-mailcow;
  • redis-mailcow.

Se algum estiver reiniciando constantemente, o problema provavelmente já foi identificado.

Verifique logs do SOGo

Os logs ajudam muito no diagnóstico do mailcow sogo 504 gateway time-out.

Execute no diretorio do mailcow:

cd /opt/mailcow-dockerized/
docker compose logs --tail=200 sogo-mailcow

Mensagens comuns incluem:

connection timeout
worker crashed
mysql timeout
memcached unreachable

Analise uso de memória

Verifique RAM:

free -m

Cheque swap:

swapon --show

E monitore processos:

htop

Se o servidor estiver usando swap constantemente, o SOGo provavelmente ficará lento.

Verifique uso de CPU

Execute:

top

ou:

htop

Alta utilização de CPU no:

  • MariaDB;
  • Dovecot;
  • Redis;
  • Docker;

pode causar o mailcow sogo 504 gateway time-out.

Como Resolver o Erro 504 no Mailcow

Reinicie os containers

Em muitos casos isso resolve imediatamente.

Entre no diretório do Mailcow:

cd /opt/mailcow-dockerized

Depois execute:

docker compose restart sogo-mailcow
docker compose restart nginx-mailcow

Ou reinicie tudo:

docker compose restart

Reinicie toda stack Docker

Se o problema persistir:

docker compose down
docker compose up -d

Isso força a reconstrução da comunicação entre os containers.

Aumente timeout do Nginx

Outro método eficiente para resolver o erro 504 no SOGo é aumentar os limites do proxy reverso.

Crie:

/opt/mailcow-dockerized/data/conf/nginx/site.sogo.custom

Adicione:

proxy_connect_timeout 300;
proxy_send_timeout 300;
proxy_read_timeout 300;
send_timeout 300;

Depois reinicie:

docker compose restart nginx-mailcow

Como Corrigir Problemas de Banco de Dados

Verifique processos do MariaDB

Entre no container:

docker compose exec mysql-mailcow mysql -u root -p

Depois execute:

SHOW PROCESSLIST;

Se houver queries travadas, o SOGo ficará aguardando resposta.

Otimize o MariaDB

Algumas otimizações importantes:

  • aumentar innodb_buffer_pool_size;
  • usar SSD NVMe;
  • reduzir swap;
  • habilitar cache adequado.

Essas melhorias ajudam a reduzir o mailcow sogo 504 gateway time-out em servidores movimentados.

Como Resolver Problemas no Dovecot

Verifique logs IMAP

Execute:

docker compose logs --tail=100 dovecot-mailcow

Procure:

  • deadlock;
  • timeout;
  • auth failed;
  • index corruption.

Reconstrua índices

Índices corrompidos podem causar lentidão extrema.

Você pode reconstruir os índices IMAP para restaurar desempenho.

Problemas de Disco no Mailcow

Verifique espaço disponível

Cheque armazenamento:

df -h

Cheque inode:

df -i

Quando o disco enche:

  • MariaDB trava;
  • Docker falha;
  • SOGo congela;
  • o erro 504 aparece.

DNS Lento Também Pode Gerar Timeout

Poucos administradores percebem isso.

DNS lento pode causar:

  • login travado;
  • autenticação lenta;
  • timeout no SOGo.

Teste:

time nslookup google.com

Use DNS rápidos:

1.1.1.1
1.0.0.1

Requisitos Recomendados Para Mailcow

Ambiente pequeno

UsuáriosRAM
até 10 usuários4 GB

Ambiente médio

UsuáriosRAM
até 50 usuários8 GB

Ambiente grande

UsuáriosRAM
100+ usuários16 GB ou mais

Quanto melhor a infraestrutura, menor a chance de enfrentar erros de timeout no SOGo.

Otimizações Preventivas

Para evitar novos problemas:

  • monitore Docker;
  • utilize SSD NVMe;
  • acompanhe logs regularmente;
  • configure swap adequadamente;
  • monitore CPU e RAM;
  • otimize MariaDB;
  • mantenha Mailcow atualizado.

Comandos Rápidos de Diagnóstico

Verificar containers

docker ps

Verificar memória

free -m

Verificar armazenamento

df -h

Verificar logs do SOGo

docker compose logs --tail=50 sogo-mailcow

Solução Rápida Que Resolve a Maioria dos Casos

Execute:

cd /opt/mailcow-dockerized

docker compose restart sogo-mailcow nginx-mailcow dovecot-mailcow redis-mailcow memcached-mailcow

Na maioria dos cenários, isso já restaura o funcionamento do webmail.

Conclusão

O erro 504 no SOGo normalmente está relacionado a problemas de desempenho, containers travados ou infraestrutura insuficiente.

As principais causas incluem:

  • falta de RAM;
  • MariaDB lento;
  • Dovecot congestionado;
  • timeout do Nginx;
  • armazenamento cheio.

Com os diagnósticos corretos e ajustes adequados, é possível resolver rapidamente o problema e manter o Mailcow estável mesmo em ambientes maiores.

Além disso, investir em otimização preventiva reduz drasticamente a ocorrência de novos erros 504 no SOGo.

FAQ

Por que o SOGo apresenta erro 504 Gateway Time-out?

No Mailcow, o erro 504 ocorre quando o servidor Nginx não recebe uma resposta do serviço SOGo ou PHP-FPM a tempo. As causas comuns são falta de memória RAM, excesso de e-mails na caixa de entrada ou número insuficiente de workers configurados.

Como aumentar o tempo de resposta (timeout) no Mailcow?

Você deve ajustar as diretivas proxy_read_timeout e fastcgi_read_timeout nas configurações do Nginx dentro do volume de dados do Mailcow (data/conf/nginx/), além de verificar se o serviço backend não está sobrecarregado.

Como verificar logs do SOGo no Mailcow?

Use o comando:
cd /opt/mailcow-dockerized/
docker compose logs --tail=200 sogo-mailcow

[Precisa de ajuda com algum problema? 
Nossa equipe está disponível 24 horas por dia, 7 dias por semana .]

Veja Mais:
Otimização de Servidor Compartilhado: Arquitetura e Tuning

Como Escolher Entre cPanel e DirectAdmin

Gerenciamento de Hospedagem Web: DirectAdmin vs cPanel e a Economia de Recursos

CloudLinux LVE Manager: Como Limitar CPU e RAM

Onde ficam as configurações PHP-FPM no DirectAdmin? (Guia 2026)

CloudLinux LVE: Como Limitar CPU e RAM por Usuário (cPanel e DirectAdmin)