Tutoriales de VPS
Cloudflare 524 en VPS: tiempos, Nginx y tareas asíncronas (2026)
Localiza el timeout real, compara rutas, registra tiempos Nginx y diseña tareas persistentes con reintentos seguros y resultados autorizados.

El sitio abre, pero exportar un informe, procesar imágenes o llamar a una API de IA acaba en Cloudflare Error 524: a timeout occurred. Suele fallar una conexión ya establecida porque el origen no termina a tiempo; el código por sí solo no demuestra que el VPS haya perdido la red.
Guarda hora, URL, método y Ray ID y relaciona los logs. Identifica el plazo antes de optimizar consultas, reparar capacidad, ajustar timeouts o pasar a una cola. 524 no demuestra que la tarea se haya detenido. No repitas continuamente peticiones que escriben datos.
La guía cubre VPS Linux con proxy Cloudflare, Nginx y aplicaciones. La revisión original fue el 15 de octubre de 2026; las referencias oficiales generales siguen indicando estos valores. Tunnel, Workers, proxies y ajustes de cuenta requieren sus comprobaciones.
| Síntoma | Qué investigar | Siguiente paso |
|---|---|---|
| Cloudflare muestra 524 | Conexión establecida; timeout de lectura o envío al origen | Procesamiento, carga y recursos |
| Cloudflare 522 | Conexión o confirmación al origen | Accesibilidad, firewall y capacidad |
| Nginx upstream timed out y 504 | Plazo de Nginx | Aplicación/base y location real |
| Solo una exportación/generación | Tarea larga, consulta, cola o API | Medir fases; optimizar o hacer asíncrono |
| Muchas rutas lentas | Workers/pools, CPU, I/O o memoria | Limitar trabajo caro y recuperar capacidad |
Combina página de error, estado y logs: varios proxies pueden transformar la respuesta original. Consulta Error 524.
La tabla general de Cloudflare indica:
- Proxy Read Timeout: 125 segundos, con 524; ajustable para zonas Enterprise.
- Proxy Write Timeout: 30 segundos, también con posible 524; no ajustable.
Escritura significa enviar datos desde Cloudflare al origen, no un máximo universal de 30 segundos por carga. Productos especiales difieren: la documentación 524 indica 6,5 segundos para escritura de Cloudflare Images. Consulta límites de conexión y el producto.
Cambiar proxy_read_timeout a 600s en el VPS no cambia Cloudflare. Workers, drivers, SDK, navegador y gateways pueden tener plazos menores. Mide duración y contrasta cuenta/producto; «unos dos minutos» no basta.
En Network del navegador guarda:
- URL, método y estado.
- Hora/zona, duración y primer byte.
cf-raye ID de petición/tarea.- Si se envió importación, pedido, exportación o generación.
Cloudflare pasa Ray ID al origen, donde puedes registrarlo. No garantiza unicidad: usa también hora, ruta e ID de aplicación. Consulta Ray ID.
Antes de repetir efectos, revisa tareas/registros. curl debe usar una ruta repetible sin escritura, no bucles de POST. Sustituye dominio y /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'
El health check no valida la ruta lenta. --max-time 160 es plazo del cliente, no ajuste del servidor. curl puede salir con 0 tras HTTP 524: revisa status. Un timeout propio de curl es distinto.
Los tiempos suelen ser acumulados, no fases independientes; primer byte incluye conexión. Consulta curl. Restringe cabeceras y elimina cookies/tokens antes de compartir.
Desde un equipo autorizado, --resolve conserva dominio, Host y SNI y selecciona IP. Sustituye 203.0.113.10 y usa misma ruta segura, método y condiciones:
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'
Una URL por IP con Host manual no sustituye HTTPS por dominio: SNI también selecciona certificado. --noproxy evita desvío por proxy local; cambia todo el dominio. Consulta --resolve para --resolve.
Un origen limitado a Cloudflare, con mTLS o sin entrada pública puede rechazar correctamente. Usa el servidor/red administrativa existente, sin abrir permanentemente el firewall. Origin CA puede necesitar confianza verificada como --cacert; conserva TLS. Consulta Origin CA.
- Ambas rutas lentas: origen o dependencia compartida.
- Solo proxy falla, directo termina tarde: participa el plazo de borde; la tarea larga sigue necesitando solución.
- Proxy con caché, directo sin ella: comparación desigual.
- Health check bien, negocio falla: continúa la ruta original.
Respalda configuración y conserva logs. log_format pertenece a http, incluso en un archivo incluido allí, no 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"}';
En el server existente añade:
access_log /var/log/nginx/cf524-timing.log cf524_timing;
Directorio, permisos y rotación deben existir. access_log en server cambia herencia: conserva destinos necesarios. El ejemplo excluye query, cuerpo y autenticación; rutas con datos sensibles necesitan anonimización/restricción. Consulta logs y escaping.
En systemd, valida y recarga:
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
Contenedores/paneles usan su proceso y rutas reales. Revisa:
request_time: tiempo total Nginx, con carga, espera y envío.upstream_connect_time: conexión al upstream.upstream_header_time: espera de cabeceras.upstream_response_time: tiempo de respuesta upstream.
Consulta variables upstream. Vacío/- puede indicar ausencia de upstream. Reintentos producen varios valores, no un único número. El origen puede continuar después del timeout y registrar más tarde o devolver 499 al cerrarse el cliente. Sigue cronología; no exijas ver 524 en su log.
Consulta métricas Linux del 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'
No encontrar logs no descarta presión.
| Prueba | Investigar | Respuesta posible |
|---|---|---|
| Aplicación empieza tarde | Workers ocupados/pool | Limitar concurrencia y usar cola |
| Base consume el tiempo | Plan, bloqueos y volumen | Índices, lotes, paginación |
| API externa no responde | Plazos SDK/proveedor/reintentos | Límites y evitar reintentos multiplicados |
| CPU/I/O sostenidos | Exportación, compresión, copias | Horarios, límites o capacidad |
| OOM/reinicio | Cuota host/contenedor y concurrencia | Presupuesto de recursos |
CPU ociosa puede significar espera de locks/pool/red. Una captura top no basta. Un agente debe ordenar proxy, inicio, conexión, dependencias y respuesta por ID antes de cambiar ajustes.
Identifica location/protocolo. proxy_pass es HTTP proxy; FastCGI/PHP-FPM usa sus directivas. proxy_read_timeout tiene 60 segundos por defecto entre lecturas, no para toda la respuesta. Consulta Nginx.
Una operación válida de 70 segundos cortada demostrablemente a 60 con 504 puede justificar 90 en ese location, si hay capacidad. No soluciona exportaciones de minutos ni amplía Cloudflare. Si algo de segundos tarda dos minutos, corrige cola/ejecución: ampliar retiene recursos más tiempo.
Para informes, lotes, transcodificación e IA:
- Enviar: autorizar/validar, persistir y encolar de forma fiable; devolver ID pronto.
- Ejecutar: workers separados registran cola, ejecución, éxito/fallo.
- Consultar: polling limitado con espera progresiva.
- Obtener: descarga/resultado autorizado al finalizar.
HTTP 202 Accepted significa aceptado, no completado; proporciona estado. Consulta RFC 9110: 202. Ejemplo:
{
"job_id": "report-job-123",
"status": "queued",
"status_url": "/api/jobs/report-job-123"
}
Es diseño de interfaz, no cola desplegable. Necesita persistencia, idempotencia, aislamiento, estados de timeout/fallo, limpieza y cancelación. Un hilo web sin persistir no basta. Si enviar agota tiempo, reconcilia por clave/tarea antes de duplicar. Consulta/descarga deben validar pertenencia; conocer ID no autoriza.
Cloudflare propone subdominio sin proxy para solicitudes largas, pero cambia exposición, certificados, autenticación y firewall/protección. Evalúalo y prefiere diagnóstico controlado o red administrativa. Origin CA puede no ser confiable al navegador. Cambiar todo el sitio en un incidente no demuestra reparación.
No. Enterprise permite lectura hasta 6000 segundos. Las reglas de caché requieren contenido realmente cacheable y capacidades de zona/regla admitidas. Consulta soluciones Cloudflare. No hagas públicos en caché datos personales o resultados privados.
Comprueba protocolo, flush y buffers. Caracteres arbitrarios corrompen JSON/archivos. Diseña streaming compatible y valida toda la ruta; polling suele ser más fácil de comprobar.
Sí. Espera del borde y resultado de negocio difieren. Revisa tarea/pedido/datos antes de repetir, con idempotencia y conciliación.
- Operación original: método, permisos y volumen equivalentes pasan.
- Ruta de borde: validación final con Cloudflare real.
- Capacidad: picos/colas, workers y pools aceptables.
- Resultado: exportación completa, sin duplicados y estados explícitos.
- Asíncrono: envío rápido, tareas trazables, fallos/cancelación terminales y acceso autorizado.
- Reversión: guarda archivos/valores, restaura, ejecuta
nginx -ty recarga normalmente. - Diagnóstico: decide qué logs conservar, protege datos y mantén rotación.
Observa volumen original y picos habituales. Menos 524 no demuestra que las tareas terminen correctamente.