Solución a problemas de conexión FTP en PrestaShop con cPanel

¿Tu tienda PrestaShop no se conecta mediante FTP y no sabes qué hacer? Es una situación frustrante, sobre todo cuando necesitas subir archivos, módulos o temas. Pero no te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene una solución sencilla.

En esta guía extensa y detallada, vamos a desglosar paso a paso todas las causas posibles de un error conexión FTP en PrestaShop cuando usas cPanel. Te explicaré desde la configuración básica hasta los ajustes más técnicos, todo en un lenguaje claro para que puedas resolverlo tú mismo.

¿Por qué aparece el error de conexión FTP en PrestaShop?

Antes de lanzarnos a las soluciones, es importante entender qué puede estar fallando. El problema con FTP PrestaShop cPanel suele deberse a una de estas cinco razones principales:

• Datos de acceso incorrectos: El usuario, la contraseña o el puerto no son los adecuados.
• Configuración de cPanel: El servidor FTP no está activo o tiene restricciones de seguridad.
• Firewall o IP bloqueada: Tu dirección IP ha sido bloqueada por múltiples intentos fallidos.
• Problemas de ruta (Path): La carpeta raíz de tu tienda no coincide con la que intentas acceder.
• Modo pasivo/activo: El cliente FTP que usas no está configurado correctamente.

Vamos a solucionarlos uno por uno. Sigue el orden de los pasos, ya que van de lo más simple a lo más complejo.

Paso 1: Verifica tus credenciales FTP en cPanel

El error más habitual es un simple fallo al escribir. Parece obvio, pero con las prisas es fácil equivocarse.

¿Dónde encuentro los datos FTP en cPanel?

1. Accede a tu panel de control cPanel (normalmente es tudominio.com/cpanel o tudominio.com:2083).
2. Busca la sección Archivos y haz clic en Cuentas FTP.
3. Aquí verás las cuentas FTP que tienes creadas. La principal suele llamarse como tu usuario de cPanel.

Datos clave que debes comprobar:

• Usuario: Normalmente es tuusuario@tudominio.com o simplemente tuusuario. Copia exactamente como aparece.
• Contraseña: Si no la recuerdas, puedes cambiarla desde aquí. Haz clic en Cambiar contraseña y establece una nueva segura.
• Puerto: El puerto por defecto para FTP seguro es el 21. Si tu hosting ofrece SFTP (SSH), el puerto suele ser el 22. Asegúrate de que tu cliente FTP use el correcto. Para cPanel, el puerto estándar es el 21 para FTP y 22 para SFTP.

** [INFO]** Si tu hosting usa Syspanel (antes conocido como HestiaCP), el puerto de acceso SSH/SFTP es el 2106, no el 22. En cPanel esto no aplica, pero es bueno que lo sepas para otros entornos.

Paso 2: Configura el modo de transferencia (Activo vs. Pasivo)

Los clientes FTP (como FileZilla, Cyberduck o WinSCP) pueden conectarse de dos maneras: modo activo y modo pasivo. Muchos servidores y firewalls bloquean el modo activo.

Solución: Usa siempre el modo PASIVO.

• En FileZilla: Ve a Editar > Ajustes > Conexión > FTP. Marca la opción Modo pasivo (recomendado).
• En otros clientes: Busca en la configuración de conexión una opción similar. Si no la ves, selecciona "PASV" o "Pasivo".

Este simple cambio soluciona el 50% de los problemas de conexión.

Paso 3: Comprueba si tu IP está bloqueada (Fail2ban)

cPanel suele incluir un sistema de seguridad llamado Fail2ban que bloquea IPs después de varios intentos fallidos de conexión. Si has estado probando contraseñas, es muy probable que te haya bloqueado.

¿Cómo desbloquear tu IP?

1. En tu cPanel, busca la sección Seguridad y haz clic en "Bloqueo de IP" o "Fail2ban" (el nombre puede variar según el proveedor de hosting).
2. Busca tu dirección IP en la lista de bloqueados. Puedes saber tu IP pública visitando páginas como cual-es-mi-ip.net.
3. Si aparece, selecciona la regla y haz clic en Eliminar o Desbloquear.

** [WARNING]** Si no encuentras esta opción, contacta con tu proveedor de hosting. Ellos pueden desbloquear tu IP desde el panel de administración del servidor.

Paso 4: Asegúrate de que el servicio FTP esté activo en cPanel

A veces, el servicio FTP está desactivado por configuración o por un fallo del servidor. Puedes verificarlo fácilmente.

1. En cPanel, busca la sección Servicios o Estado del servidor.
2. Busca "Servicio FTP" o "ProFTPD" (es el software FTP más común en cPanel).
3. Si aparece como "Detenido" o "Inactivo", haz clic en "Iniciar" o "Reiniciar".

Si no ves la opción de iniciarlo, es probable que tu plan de hosting no lo permita. En ese caso, contacta al soporte técnico.

Paso 5: Revisa la carpeta raíz (Path) de tu tienda PrestaShop

Este es un error muy común. Cuando te conectas por FTP, caes en una carpeta raíz (por ejemplo, public_html). Pero tu PrestaShop puede estar instalado en una subcarpeta (por ejemplo, public_html/tienda).

¿Cómo saber qué ruta usar?

1. Conéctate por FTP con los datos correctos (aunque sea a la carpeta raíz).
2. Busca archivos típicos de PrestaShop como index.php, config/ o admin/.
3. Si no los ves en la raíz, es que están en una subcarpeta. Por ejemplo, si ves una carpeta llamada shop o store, esa es la ruta de tu tienda.

Configuración en PrestaShop (Back Office):

Una vez que sepas la ruta correcta, es importante que PrestaShop la tenga configurada bien:

1. Accede a tu Back Office de PrestaShop (ej: tudominio.com/admin).
2. Ve a Configuración avanzada > Rendimiento.
3. Busca la sección "Almacenamiento en caché" y desactívala temporalmente para evitar problemas.
4. Luego ve a Parámetros de la tienda > Configuración general.
5. En la pestaña "Archivos", verifica que la "Ruta base del servidor" (por ejemplo, /home/usuario/public_html/tienda) es correcta.

** [TIP]** Si no estás seguro de la ruta exacta, puedes crearla manualmente desde tu cliente FTP. Conéctate a la raíz (public_html) y navega hasta encontrar la carpeta de tu tienda.

Paso 6: Ajusta los permisos de archivos y carpetas (CHMOD)

PrestaShop necesita permisos específicos para que FTP pueda escribir en ciertas carpetas. Si los permisos son incorrectos, la conexión puede fallar o dar errores de escritura.

Permisos recomendados para PrestaShop:

• Carpetas (directorios): 755 (rwxr-xr-x)
• Archivos: 644 (rw-r--r--)
• Carpetas especiales (como cache, log, upload): 777 (rwxrwxrwx) solo temporalmente para solucionar problemas, luego vuelve a 755.

¿Cómo cambiar permisos desde cPanel?

1. En cPanel, ve a Administrador de archivos.
2. Navega hasta la carpeta de tu PrestaShop.
3. Selecciona la carpeta o archivo, haz clic derecho y elige "Cambiar permisos".
4. Ingresa el número (755, 644, etc.) y guarda.

** [WARNING]** Usar permisos 777 en toda la carpeta es un riesgo de seguridad. Solo hazlo temporalmente y bajo tu responsabilidad.

Paso 7: Prueba con un cliente FTP alternativo

A veces el problema no es el servidor, sino el programa que usas. FileZilla es el más popular, pero puede tener conflictos con ciertos firewalls. Prueba con:

• WinSCP (Windows)
• Cyberduck (Mac y Windows)
• FTP Voyager (Windows)
• El explorador de archivos de cPanel (desde el navegador, sin necesidad de cliente FTP).

Si con otro cliente funciona, el problema es del software original. Desinstálalo y vuelve a instalarlo, o ajusta su configuración de firewall.

Paso 8: Configura la conexión SFTP (más segura y fiable)

Si el FTP normal sigue fallando, tu hosting probablemente soporte SFTP (FTP sobre SSH). Es más seguro y suele ser más estable.

Cómo conectarte por SFTP en FileZilla:

1. En el campo Servidor, escribe tudominio.com o la IP del servidor.
2. En Protocolo, selecciona SFTP - Protocolo de transferencia de archivos SSH.
3. Puerto: 22 (o 2106 si tu hosting usa Syspanel, como mencionamos antes).
4. Usuario y contraseña: los mismos que para FTP.

Ventaja: SFTP usa un solo puerto (22 o 2106), por lo que evita los problemas de firewalls que tiene el FTP tradicional.

Preguntas Frecuentes (FAQ) sobre FTP en PrestaShop y cPanel

1. ¿Por qué me sale "Error de conexión: Conexión rechazada"?

Esto significa que el servidor FTP no está aceptando conexiones en el puerto que usas. Verifica que el servicio esté activo en cPanel (Paso 4) y que el puerto sea el correcto (21 para FTP, 22 para SFTP).

2. ¿Puedo usar FTP sin cPanel?

Sí, pero necesitas los datos de conexión que te proporcionó tu hosting. Si no los tienes, contacta con soporte. cPanel es solo una interfaz para gestionar el servidor.

3. ¿Cómo subir un módulo de PrestaShop por FTP?

Conéctate por FTP, navega hasta la carpeta /modules dentro de tu tienda (ej: public_html/modules), y arrastra la carpeta del módulo. Luego, desde el Back Office, ve a Módulos > Gestor de módulos e instálalo.

4. ¿Cada cuánto debo cambiar la contraseña FTP?

Es buena práctica cambiarla cada 3-6 meses, o inmediatamente si sospechas que alguien más la conoce. Hazlo desde cPanel > Cuentas FTP.

5. ¿Qué hago si nada funciona?

Si has seguido todos los pasos y el error persiste, el problema es del servidor. Contacta con tu proveedor de hosting y diles: "Tengo un error conexión FTP en PrestaShop con cPanel. He verificado credenciales, puertos, permisos y desbloqueado mi IP. Necesito que revisen el servicio FTP del servidor."

Resumen rápido de solución de problemas

Para que no te pierdas, aquí tienes una checklist de lo que debes revisar:

1. Credenciales: Usuario, contraseña y puerto (21 o 22).
2. Modo pasivo: Actívalo en tu cliente FTP.
3. IP bloqueada: Revisa Fail2ban en cPanel.
4. Servicio FTP: Asegúrate de que esté activo.
5. Ruta correcta: Conéctate a la carpeta donde está PrestaShop.
6. Permisos: 755 en carpetas, 644 en archivos.
7. Cliente FTP: Prueba con otro programa.
8. SFTP: Usa el protocolo SSH si el FTP falla.

Con esta guía, espero que puedas resolver cualquier problema de FTP PrestaShop cPanel y volver a trabajar con los archivos de tu tienda sin estrés. Recuerda que la paciencia y el orden son clave. ¡Mucho éxito con tu ecommerce!