Problemas de conexión FTP en PrestaShop: Guía de solución

¿Estás teniendo problemas para conectar tu tienda PrestaShop por FTP? No te preocupes, es una de las situaciones más comunes al gestionar un sitio web, pero también una de las más fáciles de resolver si sigues los pasos adecuados. En esta guía detallada, te explicaré paso a paso cómo diagnosticar y solucionar los errores más frecuentes en la conexión FTP PrestaShop, desde problemas de credenciales hasta conflictos con el firewall o la configuración del servidor. Al final, tendrás una lista de verificación que te permitirá dejar tu tienda funcionando sin contratiempos.

¿Por qué es importante tener una conexión FTP estable en PrestaShop?

Antes de entrar en materia, es clave entender que FTP (File Transfer Protocol) es el método principal para subir, descargar y gestionar los archivos de tu tienda. Desde instalar módulos y temas hasta modificar archivos de configuración o realizar copias de seguridad, todo pasa por una conexión FTP sólida. Si falla, no podrás actualizar tu PrestaShop, corregir errores de código o incluso restaurar el sitio tras un incidente.

Los errores FTP pueden deberse a múltiples causas: contraseñas incorrectas, puertos bloqueados, configuraciones de seguridad del servidor o incluso problemas con el cliente FTP que uses. Vamos a desglosarlas una por una.

Requisitos previos: lo que necesitas saber

Antes de empezar a solucionar, asegúrate de tener a mano:

Datos de acceso FTP: servidor (normalmente tu dominio o una IP), nombre de usuario, contraseña y puerto (por defecto 21 para FTP estándar o 22 para SFTP).
Un cliente FTP como FileZilla, Cyberduck o el administrador de archivos de tu panel de control.
Acceso a tu panel de hosting (cPanel, Plesk, Syspanel, etc.) para verificar configuraciones.
Información del firewall o seguridad de tu servidor (por si bloquea conexiones activas).

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso al panel es el 2106. No confundas este puerto con el del FTP.

Paso 1: Verifica las credenciales de FTP

El error más común es escribir mal el usuario o la contraseña. Parece obvio, pero ocurre más de lo que parece.

Cómo obtenerlas correctamente

Si tienes acceso a tu panel de control:

En cPanel: Ve a la sección "Cuentas FTP". Allí verás tu usuario (suele ser tuusuario@tudominio.com o similar) y podrás cambiar la contraseña.
En Syspanel (HestiaCP): Accede por el puerto 2106, ve a la sección "Usuarios" o "FTP" y crea o modifica una cuenta. El usuario suele ser nombre_usuario y la contraseña la que definas.
En Plesk: Busca "Acceso FTP" en el panel de tu dominio.

[WARNING] Muchos paneles generan contraseñas temporales. Si la cambiaste y no la recuerdas, restablécela desde el panel. No la adivines.

Prueba con otro cliente FTP

A veces el problema no son las credenciales, sino el cliente. Prueba con FileZilla (gratuito y muy usado) o incluso con el navegador web usando el protocolo ftp://tudominio.com. Si con otro cliente funciona, el problema es del programa que estabas usando.

Paso 2: Comprueba el puerto y el protocolo

Por defecto, FTP usa el puerto 21. Sin embargo, muchos servidores modernos exigen SFTP (puerto 22) o FTPES (FTP sobre SSL, también puerto 21 pero con cifrado). PrestaShop no requiere un protocolo específico, pero tu hosting puede tener restricciones.

Cómo configurarlo en FileZilla

Abre FileZilla y ve a Archivo > Administrador de sitios.
Introduce tu servidor, usuario y contraseña.
En "Protocolo", elige:
- FTP si tu hosting lo permite.
- SFTP si tu servidor lo soporta (más seguro).
- FTPES si necesitas cifrado explícito.
En "Puerto", pon 21 para FTP/FTPES o 22 para SFTP.

[TIP] Si no estás seguro, consulta con tu proveedor de hosting. Muchos paneles como Syspanel ofrecen SFTP por defecto.

Paso 3: Problemas con el firewall o la seguridad del servidor

Los firewalls modernos bloquean conexiones FTP activas si no se configuran correctamente. Esto es especialmente común en servidores compartidos o VPS.

Síntomas típicos

FileZilla se queda en "Conectando..." y luego da error de tiempo de espera.
Aparece el mensaje "Error de conexión: ECONNREFUSED".
La conexión se establece pero no lista los archivos.

Soluciones

Modo pasivo vs activo: En FileZilla, ve a Editar > Configuración > FTP > Modo de transferencia y selecciona "Pasivo". El modo activo suele dar problemas tras firewalls.
Permitir FTP en el firewall del servidor: Si tienes acceso root (VPS o dedicado), asegúrate de que el puerto 21 o 22 esté abierto. En Syspanel, puedes hacerlo desde el panel de seguridad.
Desactivar temporalmente el firewall local: Si usas Windows Defender o un antivirus con firewall, pruébalo desactivándolo unos minutos para descartar.

[WARNING] No dejes el firewall desactivado permanentemente. Solo para pruebas.

Paso 4: Verifica que el servicio FTP esté funcionando

A veces el problema no es tuyo, sino del servidor. El servicio FTP puede estar caído o mal configurado.

Cómo verificarlo

Desde tu panel de control (cPanel, Syspanel, etc.), busca "Servicios" o "Gestión de servicios".
Localiza el servicio FTP (suele llamarse "vsftpd", "ProFTPD" o "Pure-FTPd").
Asegúrate de que esté en ejecución (verde o "running").
Si está detenido, reinícialo.

En Syspanel, puedes hacerlo desde la sección "Servicios" del panel (puerto 2106). Busca "FTP" y haz clic en "Reiniciar".

Paso 5: Comprueba los permisos de los archivos y carpetas

Incluso si conectas bien, podrías no poder subir o modificar archivos de PrestaShop. Esto se debe a permisos incorrectos.

Permisos recomendados para PrestaShop

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)
Archivos de configuración como config/settings.inc.php: 644 o 444 (solo lectura) por seguridad.

Cómo cambiarlos desde FTP

Conéctate por FTP.
Selecciona la carpeta o archivo, haz clic derecho y elige "Permisos de archivo".
Introduce el número (755 o 644) y marca "Recursivo" si aplica a subcarpetas.

[INFO] Si no puedes cambiar permisos, es probable que el usuario FTP no tenga permisos de escritura. En ese caso, contacta a tu hosting.

Paso 6: Problemas específicos con PrestaShop archivos

A veces el error no es de conexión, sino de contenido. Por ejemplo, al subir un módulo o tema, PrestaShop no lo reconoce.

Causas comunes

Archivos corruptos: Vuelve a descargar el módulo desde la fuente oficial.
Estructura de carpetas incorrecta: Por ejemplo, un tema debe ir en /themes/nombre_tema/, no en la raíz.
Permisos insuficientes: PrestaShop necesita escribir en ciertas carpetas como /cache/, /img/ o /upload/. Asegúrate de que tengan permisos 755.

Cómo subir archivos correctamente

Conéctate por FTP a tu servidor.
Navega hasta la raíz de PrestaShop (donde está index.php).
Sube los archivos respetando la estructura de carpetas del módulo o tema.
Después de subir, ve al panel de administración de PrestaShop y en "Módulos" o "Temas" haz clic en "Instalar".

[TIP] Si ves el error "No se puede escribir en el directorio", es un problema de permisos. Cámbialos a 755.

Paso 7: Usa el administrador de archivos del panel como alternativa

Si el FTP sigue sin funcionar, no te desesperes. La mayoría de los paneles de control incluyen un Administrador de archivos web que te permite subir y gestionar archivos sin necesidad de FTP.

Cómo usarlo

Accede a tu panel de control (cPanel, Syspanel, Plesk, etc.).
Busca "Administrador de archivos" o "File Manager".
Navega hasta la carpeta de tu PrestaShop (normalmente /public_html/ o /domains/tudominio.com/public_html/).
Sube los archivos directamente desde tu ordenador.

En Syspanel, el administrador de archivos está en la sección "Archivos" del panel (puerto 2106). Es muy intuitivo y te permite arrastrar y soltar.

Preguntas frecuentes (FAQ)

¿Por qué FileZilla me dice "Error crítico: No se pudo conectar al servidor"?

Esto suele indicar que el servidor FTP no está accesible. Verifica que el servicio esté corriendo (Paso 4) y que el puerto no esté bloqueado (Paso 3). También prueba con SFTP.

¿Cómo sé si mi hosting usa FTP o SFTP?

Revisa la documentación de tu proveedor. Si usas Syspanel, por defecto ofrece SFTP en el puerto 22. Si no estás seguro, prueba ambos.

¿Puedo usar la misma contraseña de FTP que la de mi panel de control?

No necesariamente. Las cuentas FTP son independientes. En algunos paneles como cPanel, el usuario principal de FTP tiene la misma contraseña que la del panel, pero es mejor crear una cuenta específica para FTP.

¿Qué hago si no recuerdo mis datos de FTP?

Accede a tu panel de control y crea una nueva cuenta FTP. En Syspanel, ve a "Usuarios" y añade uno nuevo. Luego úsalo para conectar.

¿Es seguro usar FTP sin cifrar?

No. Siempre que sea posible, usa SFTP o FTPES. Si tu hosting solo ofrece FTP estándar, al menos asegúrate de que tu contraseña sea robusta.

Conclusión: Checklist final para solucionar errores FTP en PrestaShop

Aquí tienes un resumen de todo lo que debes revisar:

Credenciales correctas: Usuario y contraseña sin errores tipográficos.
Puerto y protocolo adecuados: 21 para FTP/FTPES, 22 para SFTP.
Modo pasivo activado en tu cliente FTP.
Servicio FTP en ejecución en el servidor (revisa el panel de control).
Firewall desbloqueado: Tanto el del servidor como el local.
Permisos de archivos correctos: 755 para carpetas, 644 para archivos.
Estructura de PrestaShop archivos respetada al subir módulos o temas.
Alternativa: Administrador de archivos del panel si el FTP sigue fallando.

Si después de seguir todos estos pasos aún tienes problemas, contacta con tu proveedor de hosting. Ellos pueden revisar los logs del servidor y detectar bloqueos específicos. Recuerda que la paciencia es clave; la mayoría de los errores FTP se resuelven con una verificación metódica.

[TIP] Mantén siempre una copia de seguridad de tu PrestaShop antes de hacer cambios por FTP. Así, si algo sale mal, puedes restaurar fácilmente.

Espero que esta guía te haya sido de gran ayuda. Ahora ya sabes cómo solucionar problemas de conexión FTP PrestaShop y mantener tu tienda funcionando sin interrupciones. ¡Buena suerte!