Tutoriais de VPS
Cloudflare 524 no VPS: tempos, Nginx e tarefas assíncronas (2026)
Localize o timeout real, compare rotas, registre tempos Nginx e projete tarefas persistentes com tentativas seguras e resultados autorizados.

O site abre, mas exportar relatório, processar imagens ou chamar API de IA termina em Cloudflare Error 524: a timeout occurred. Normalmente uma conexão já estabelecida não concluiu a troca a tempo; o código sozinho não comprova queda da rede do VPS.
Guarde horário, URL, método e Ray ID e relacione logs da origem. Identifique o prazo antes de otimizar consultas, corrigir capacidade, alterar timeouts ou usar fila. 524 não comprova que a tarefa parou. Não repita continuamente requisições que escrevem dados.
O guia cobre VPS Linux com proxy Cloudflare, Nginx e aplicações. A revisão original foi em 15 de outubro de 2026; as referências oficiais gerais continuam indicando estes valores. Tunnel, Workers, proxies e ajustes da conta exigem verificações próprias.
| Sintoma | Investigar | Próximo passo |
|---|---|---|
| Cloudflare mostra 524 | Conexão estabelecida; timeout de leitura/envio à origem | Processamento, upload e recursos |
| Cloudflare 522 | Conexão/confirmação da origem | Acesso, firewall e capacidade |
| Nginx upstream timed out e 504 | Prazo do Nginx | Aplicação/banco e location real |
| Só exportação/geração falha | Tarefa longa, consulta, fila ou API | Medir etapas; otimizar ou tornar assíncrono |
| Muitas rotas lentas | Workers/pools, CPU, I/O ou memória | Limitar trabalho caro e recuperar capacidade |
Combine página, status e logs: vários proxies podem alterar a resposta original. Veja Error 524.
A tabela geral da Cloudflare indica:
- Proxy Read Timeout: 125 segundos, associado a 524; ajustável em zonas Enterprise.
- Proxy Write Timeout: 30 segundos, também pode gerar 524; não ajustável.
Escrita significa enviar dados da Cloudflare à origem, não máximo universal de 30 segundos por upload. Produtos especiais diferem: a documentação 524 informa 6,5 segundos para escrita do Cloudflare Images. Veja limites de conexão e o produto.
Alterar proxy_read_timeout para 600s no VPS não muda Cloudflare. Workers, drivers, SDKs, navegador e gateways podem ter prazos menores. Meça e compare conta/produto; «uns dois minutos» não basta.
No Network do navegador, guarde:
- URL, método e status.
- Horário/fuso, duração e primeiro byte.
cf-raye IDs da requisição/tarefa.- Se submeteu importação, pedido, exportação ou geração.
A Cloudflare envia Ray ID à origem, onde pode ser registrado. Não garante unicidade: use horário, caminho e ID da aplicação. Veja Ray ID.
Confira tarefas/registros antes de repetir efeitos. curl deve usar rota repetível sem escrita, não loops de POST. Troque domínio e /status:
umask 077
curl --silent --show-error \
--connect-timeout 10 --max-time 160 \
--dump-header /tmp/cf524-edge-headers.txt \
--output /dev/null \
--write-out 'status=%{http_code} remote=%{remote_ip} dns=%{time_namelookup} connect=%{time_connect} tls=%{time_appconnect} first_byte=%{time_starttransfer} total=%{time_total}\n' \
'https://example.com/status'
Health check não valida a rota lenta. --max-time 160 é prazo do cliente, não configuração do servidor. curl pode sair com 0 após HTTP 524: confira status. Timeout do próprio curl é diferente.
Tempos costumam ser acumulados, não etapas independentes; primeiro byte inclui conexão. Veja curl. Restrinja cabeçalhos e remova cookies/tokens antes de compartilhar.
Em máquina autorizada, --resolve preserva domínio, Host e SNI e escolhe IP. Troque 203.0.113.10 e use caminho seguro, método e condições iguais:
curl --silent --show-error \
--connect-timeout 10 --max-time 160 \
--noproxy 'example.com' \
--resolve 'example.com:443:203.0.113.10' \
--output /dev/null \
--write-out 'status=%{http_code} remote=%{remote_ip} first_byte=%{time_starttransfer} total=%{time_total}\n' \
'https://example.com/status'
URL por IP com Host manual não substitui HTTPS por domínio: SNI também seleciona certificado. --noproxy evita desvio por proxy local; altere todo o domínio. Veja --resolve para --resolve.
Origem limitada à Cloudflare, com mTLS ou sem entrada pública pode rejeitar corretamente. Use servidor/rede administrativa existente sem abrir permanentemente firewall. Origin CA pode exigir confiança verificada como --cacert; preserve TLS. Veja Origin CA.
- Ambas lentas: origem ou dependência compartilhada.
- Só proxy falha, direto termina tarde: prazo de borda participa; a tarefa longa ainda precisa de solução.
- Proxy com cache, direto sem: comparação desigual.
- Health check bom, negócio falha: continue pela rota original.
Faça backup e preserve logs. log_format pertence a http, inclusive em arquivo incluído ali, não server/location:
log_format cf524_timing escape=json
'{"time":"$time_iso8601","request_id":"$request_id",'
'"ray":"$http_cf_ray","method":"$request_method",'
'"uri":"$uri","status":"$status",'
'"request_time":"$request_time",'
'"upstream_connect_time":"$upstream_connect_time",'
'"upstream_header_time":"$upstream_header_time",'
'"upstream_response_time":"$upstream_response_time",'
'"upstream_status":"$upstream_status"}';
No server existente adicione:
access_log /var/log/nginx/cf524-timing.log cf524_timing;
Diretório, permissões e rotação precisam existir. access_log em server muda herança: preserve destinos necessários. O exemplo exclui query, corpo e autenticação; caminhos sensíveis exigem remoção/restrição. Veja logs e escaping.
No systemd valide e recarregue:
sudo nginx -t && sudo systemctl reload nginx
sudo tail -n 50 /var/log/nginx/cf524-timing.log
sudo tail -n 100 /var/log/nginx/error.log
Contêineres/painéis usam processos e caminhos próprios. Confira:
request_time: total Nginx, incluindo upload, espera e envio.upstream_connect_time: conexão ao upstream.upstream_header_time: espera de cabeçalhos.upstream_response_time: tempo da resposta upstream.
Veja variáveis upstream. Vazio/- pode significar nenhum upstream. Reintentos podem gerar vários valores, não um número único. A origem pode continuar após timeout, registrar depois ou retornar 499 ao fechar o cliente. Siga a cronologia; não exija 524 no log da origem.
Consulte métricas Linux do incidente:
date -u
uptime
free -h
df -h
df -i
vmstat 1 5
sudo journalctl -k --since '30 minutes ago' --no-pager |
grep -Ei 'out of memory|oom|killed process'
Logs ausentes não descartam pressão.
| Evidência | Investigar | Resposta possível |
|---|---|---|
| Aplicação começa tarde | Workers ocupados/pool | Limitar concorrência e usar fila |
| Banco consome o tempo | Plano, locks e volume | Índices, lotes, paginação |
| API externa demora | Prazos SDK/provedor/repetições | Limites e evitar tentativas multiplicadas |
| CPU/I/O sustentados | Exportação, compressão, backups | Horários, limites ou capacidade |
| OOM/reinício | Quota host/contêiner e concorrência | Orçamento de recursos |
CPU ociosa pode significar espera por lock/pool/rede. Uma captura top não basta. Um agente deve organizar proxy, início, conexão, dependências e resposta pelo ID antes de mudar opções.
Identifique location/protocolo. proxy_pass é proxy HTTP; FastCGI/PHP-FPM usa diretivas próprias. proxy_read_timeout tem padrão de 60 segundos entre leituras, não para resposta inteira. Veja Nginx.
Operação legítima de 70 segundos comprovadamente cortada aos 60 com 504 pode justificar 90 nesse location, com capacidade. Não resolve exportação de minutos nem amplia Cloudflare. Se algo de segundos leva dois minutos, corrija fila/execução: aumentar prende recursos por mais tempo.
Para relatórios, lotes, transcodificação e IA:
- Enviar: autorizar/validar, persistir e enfileirar confiavelmente; devolver ID rápido.
- Executar: workers separados registram fila, execução, sucesso/falha.
- Acompanhar: polling limitado com espera progressiva.
- Obter: download/resultado autorizado após conclusão.
HTTP 202 Accepted significa aceito, não concluído; forneça estado. Veja RFC 9110: 202. Exemplo:
{
"job_id": "report-job-123",
"status": "queued",
"status_url": "/api/jobs/report-job-123"
}
É desenho de interface, não fila pronta. Exige persistência, idempotência, isolamento, estados de timeout/falha, limpeza e cancelamento. Thread web sem persistência não basta. Se envio expira, reconcilie por chave/tarefa antes de duplicar. Consulta/download precisam validar dono; conhecer ID não autoriza.
A Cloudflare sugere subdomínio sem proxy para requisições longas, mas muda exposição, certificados, autenticação e firewall/proteções. Avalie e prefira diagnóstico controlado/rede administrativa. Origin CA pode não ser confiável ao navegador. Mudar todo o site no incidente não comprova correção.
Não. Enterprise permite leitura até 6000 segundos. Regras de cache exigem conteúdo realmente cacheável e capacidades de zona/regra suportadas. Veja soluções Cloudflare. Não torne públicos em cache dados pessoais/resultados privados.
Confira protocolo, flush e buffering. Caracteres arbitrários corrompem JSON/arquivos. Projete streaming compatível e valide a rota inteira; polling costuma ser mais fácil de testar.
Sim. Espera da borda e resultado do negócio diferem. Confira tarefa/pedido/dados antes de repetir, com idempotência e reconciliação.
- Operação original: método, permissões e volume equivalentes passam.
- Rota de borda: validação final com Cloudflare real.
- Capacidade: picos/caudas, workers, pools e filas aceitáveis.
- Resultado: exportação completa, sem duplicações e estados explícitos.
- Assíncrono: envio rápido, rastreabilidade, falha/cancelamento terminais e acesso autorizado.
- Reversão: preserve arquivos/valores, restaure, execute
nginx -te recarregue normalmente. - Diagnóstico: decida logs a manter, proteja dados e preserve rotação.
Observe volume original e picos usuais. Menos 524 não comprova tarefas concluídas corretamente.