Cómo Solucionar el Error de cURL Timeout usando el Módulo "Outgoing Connections" en cPanel

Introducción

¿Tu sitio web (ya sea WordPress, Prestashop o un desarrollo a medida) muestra un error del tipo cURL error 28: Connection timed out o experimenta fallos al intentar conectar con pasarelas de pago (Stripe, PayPal), APIs de terceros o servidores de licencias externas?

Este inconveniente ocurre habitualmente cuando el firewall de tu cuenta de hosting restringe las conexiones salientes no autorizadas para proteger el servidor de posibles abusos o scripts maliciosos. Para darte un control total y autónomo, disponemos del módulo Outgoing Connections (Conexiones Salientes) directamente dentro de tu panel de control cPanel.

En esta guía te enseñamos paso a paso cómo revisar qué conexiones se están bloqueando y cómo permitir una dirección IP externa para solucionar los problemas de cURL timeout al instante.

Paso 1: Averiguar la IP o Dominio de Destino

Antes de abrir la conexión, necesitas saber con qué dirección IP o servidor intenta comunicarse tu sitio web:

• En WordPress: Ve a Herramientas > Salud del sitio. El propio error de cURL te indicará la URL de destino (por ejemplo, api.wordpress.org, api.stripe.com, etc.).
• En archivos de registro (Logs): Revisa el archivo error_log en la carpeta raíz de tu aplicación para encontrar las líneas exactas del error de timeout.
• Obtener la IP: Si el error solo te muestra un dominio, puedes conocer su dirección IP ejecutando un comando ping dominio.com desde la terminal de tu ordenador, o utilizando una herramienta online como DNSChecker.org.

Paso 2: Entrar al Módulo "Outgoing Connections" en cPanel

1. Accede a tu panel de control cPanel.
2. Escribe "Outgoing Connections" (o "Conexiones Salientes" si tienes el panel configurado en español) en el buscador superior.
3. Haz clic sobre el módulo, el cual suele ubicarse en la sección de Seguridad (Security) o Avanzado (Advanced).

Paso 3: Identificar los Intentos de Conexión Bloqueados

Dentro de la interfaz del módulo, verás dos apartados principales:

• Conexiones Permitidas (Allowed Connections): El listado de direcciones y puertos con vía libre para conectarse al exterior.
• Historial / Conexiones Bloqueadas (Blocked Logs): Una tabla cronológica que registra todas las solicitudes salientes que el firewall ha frenado por motivos de seguridad.
  • Busca en la lista de bloqueos la fecha y hora recientes que coincidan con el error cURL error 28. Anota la dirección IP o el puerto que se muestra en ese registro.

Paso 4: Añadir la IP a la Lista Blanca (Whitelist)

Una vez identificada la dirección IP externa que tu sitio web necesita consultar, agrégala de la siguiente manera:

1. Dirígete al formulario superior bajo el título "Añadir Conexión Permitida" (Add New Allowed Connection).
2. Completa los campos solicitados:
   • Dirección IP / Host: Pega la IP exacta del servicio externo (ej. 192.0.2.55). Nota: Se recomienda usar IPs específicas en lugar de rangos completos para mantener tu entorno lo más seguro posible.
   • Puerto: Indica el puerto de red utilizado. Habitualmente, las peticiones web seguras viajan por el puerto 443 (HTTPS) y las no seguras por el puerto 80 (HTTP). Si la API usa un puerto especial (como el 3306 para bases de datos remotas o el 8443), indícalo aquí.
   • Comentario / Descripción: Escribe una nota breve que describa el motivo de la regla, por ejemplo: "API para Pasarela de Pagos Stripe" o "Validación de Licencia de Plugin X". Esto te ayudará a recordarlo en el futuro.
3. Haz clic en el botón "Permitir" (Allow) o "Guardar Cambios" (Save).

Paso 5: Comprobar que el Error se ha Resuelto

Regresa al panel de control de tu sitio web o aplicación web y reintenta la acción que fallaba originalmente (por ejemplo, vuelve a procesar un pago de prueba, refresca la página de actualizaciones o vuelve a pasar el test en la Salud del Sitio de WordPress).

La petición cURL debería completarse ahora de manera inmediata y fluida.

Consideraciones Adicionales y Soporte

• IPs Cambiantes o Dinámicas: Proveedores globales masivos (como Cloudflare, Google o AWS) manejan miles de direcciones IP que rotan constantemente. Si notas que el bloqueo vuelve a ocurrir con una IP distinta del mismo proveedor, ponte en contacto con nuestro equipo de soporte para abrir de forma global el dominio o el puerto en cuestión.
• Bloqueo Inverso: Si tras añadir la IP el timeout persiste, existe la posibilidad de que el servidor externo sea el que esté bloqueando la dirección IP de tu plan de hosting (por políticas de firewall propias del proveedor externo).

Si necesitas ayuda avanzada para interpretar los registros o configurar una regla compleja, abre un ticket de soporte técnico desde tu Área de Clientes de WHMCS aportando los detalles del error y con gusto te asistiremos.