Errores FTP en PrestaShop con Plesk: soluciones rápidas

¿Tienes problemas para conectar con tu tienda PrestaShop a través de FTP? No te preocupes, es una de las consultas más comunes que recibimos en soporte. Cuando trabajas con un panel de control como Plesk y una plataforma de comercio electrónico como PrestaShop, la configuración de FTP puede volverse un poco delicada, especialmente por los permisos de archivos.

En esta guía extensa y paso a paso, vamos a desglosar las causas más frecuentes de los errores FTP PrestaShop y te daremos soluciones prácticas para que puedas subir, modificar o descargar archivos sin problemas. Abordaremos desde la configuración básica hasta la resolución de conflictos de permisos, todo explicado de forma clara y sencilla.

¿Por qué falla la conexión FTP en PrestaShop con Plesk?

Antes de lanzarnos a las soluciones, es importante entender el origen del problema. Cuando hablamos de FTP PrestaShop Plesk, los fallos suelen deberse a una de estas tres causas principales:

Credenciales incorrectas o mal configuradas: El usuario FTP no tiene los permisos adecuados o la contraseña es errónea.
Puertos bloqueados o configuración de red: El firewall del servidor o de tu propia conexión está bloqueando el puerto FTP (por defecto, el 21).
Permisos de archivos y directorios incorrectos: PrestaShop es muy sensible a los permisos. Si no están bien asignados, el FTP puede funcionar para conectarse, pero no para escribir o modificar archivos.

Vamos a ver cada una de estas situaciones y cómo solucionarlas.

Solución Paso a Paso para Problemas de Conexión FTP

1. Verifica tus Credenciales FTP en Plesk

El primer paso es asegurarte de que estás usando las credenciales correctas. En Plesk, la gestión de usuarios FTP es muy específica.

¿Cómo crear o revisar un usuario FTP en Plesk?

Accede a tu panel de control de Plesk (normalmente en https://tudominio.com:8443).
Ve a "Sitios web y dominios".
Busca el dominio de tu tienda PrestaShop y haz clic en "Acceso FTP" (o "Acceso directo FTP").
Aquí verás la lista de usuarios FTP. Asegúrate de que exista al menos uno.
Si no lo tienes, crea uno nuevo:
- Inicio de sesión: Normalmente es algo como usuario@tudominio.com o simplemente usuario.
- Contraseña: Elige una segura y anótala.
- Directorio de inicio: Asegúrate de que apunte a la raíz de tu tienda (ej: /var/www/vhosts/tudominio.com/httpdocs).

[TIP] En Plesk, el nombre de usuario FTP suele incluir el dominio completo (ej: miusuario@midominio.com). Si usas solo miusuario, puede que la conexión falle.

2. Comprueba el Puerto y el Modo de Conexión FTP

El puerto estándar para FTP es el 21, pero a veces los firewalls lo bloquean. Plesk suele permitir conexiones seguras (FTP sobre TLS/SSL) y conexiones normales.

¿Qué hacer si el puerto 21 no funciona?

Prueba con FTP Explícito (FTPES): En tu cliente FTP (FileZilla, Cyberduck, etc.), selecciona el tipo de conexión como "FTP sobre TLS explícito" o "FTPES". Esto usa el puerto 21 pero cifra la conexión, lo que a menudo evita bloqueos.
Cambia a SFTP (SSH File Transfer Protocol): Si tu plan de hosting lo permite (y en Plesk suele ser así), el SFTP usa el puerto 22 (el mismo que SSH). Es mucho más seguro y fiable. Para ello:
- En tu cliente FTP, selecciona "SFTP" como tipo de conexión.
- Usa el mismo usuario y contraseña que para FTP (o los de acceso SSH si son diferentes).

[WARNING] Si usas SFTP, asegúrate de que el servicio SSH esté activo en Plesk. Ve a "Herramientas y configuraciones" > "Configuración de seguridad" > "Acceso SSH" y verifica que esté habilitado para tu suscripción.

3. Soluciona los Errores de Permisos de Archivos en PrestaShop

Este es el punto más crítico. Incluso si te conectas bien al FTP, si los permisos archivos PrestaShop no son los correctos, no podrás subir temas, módulos o modificar archivos de configuración.

PrestaShop necesita permisos específicos para funcionar correctamente:

Directorios (carpetas): Deben tener permisos 755 (rwxr-xr-x).
Archivos: Deben tener permisos 644 (rw-r--r--).
Archivos y carpetas especiales (como /cache, /config, /img, /mails, /modules, /override, /themes, /translations, /upload, /download): A veces necesitan permisos 777 (rwxrwxrwx) temporalmente para que PrestaShop pueda escribir en ellos (por ejemplo, al instalar un módulo o generar imágenes). Pero ojo, no es seguro dejarlos en 777 permanentemente.

¿Cómo cambiar los permisos desde FTP?

Conéctate a tu servidor vía FTP.
Selecciona la carpeta raíz de tu tienda (normalmente httpdocs).
Haz clic derecho sobre la carpeta y busca la opción "Permisos de archivo" o "Atributos".
Cambia los valores numéricos (755 para carpetas, 644 para archivos).
Aplica los cambios de forma recursiva (que afecte a todas las subcarpetas y archivos). Tu cliente FTP te preguntará si quieres aplicar a todas las subcarpetas. Dile que sí.

[INFO] Si después de cambiar los permisos a 755/644 no puedes instalar un módulo, es posible que necesites dar permisos 777 temporalmente a la carpeta /modules y a la carpeta /cache. Una vez instalado el módulo, vuelve a poner los permisos a 755.

4. Problemas con el Firewall o el Cliente FTP

A veces el problema no está en el servidor, sino en tu red local o en la configuración de tu programa de FTP.

Configura recomendada para FileZilla (el cliente más común):

Ve a "Editar" > "Ajustes" > "FTP" > "Modo pasivo" (o "Transferencias de archivos").
Asegúrate de que "Modo pasivo" esté seleccionado. Es el más compatible con firewalls.
En "Editar" > "Ajustes" > "Conexión" > "FTP" > "Modo de transferencia", selecciona "Pasivo (recomendado)".

Si aún así no funciona, prueba a desactivar temporalmente el firewall de tu ordenador o la VPN para descartar que estén bloqueando la conexión.

Errores FTP Comunes y sus Soluciones Rápidas

Aquí tienes un mini FAQ con los errores más típicos que verás al usar FTP PrestaShop Plesk.

Error: "530 Login incorrect"

Causa: El usuario o la contraseña son incorrectos.
Solución: Revisa las credenciales en Plesk. Asegúrate de que el nombre de usuario incluya el dominio completo (ej: usuario@tudominio.com). Si no estás seguro, crea un nuevo usuario FTP desde Plesk.

Error: "425 Can't open data connection"

Causa: Problema con el modo de conexión (activo vs pasivo) o el firewall.
Solución: Cambia tu cliente FTP a modo pasivo. Si sigues teniendo problemas, prueba con FTPES o SFTP.

Error: "550 Permission denied" al subir un archivo

Causa: Los permisos de la carpeta de destino son demasiado restrictivos.
Solución: Cambia los permisos de la carpeta a 755 (o 777 temporalmente) desde tu cliente FTP. Si es un archivo de configuración, asegúrate de que el archivo tenga permisos 644.

Error: "553 Could not create file"

Causa: El disco está lleno o el propietario del archivo no coincide con el usuario FTP.
Solución: Verifica el espacio en disco desde Plesk (en "Herramientas y configuraciones" > "Uso del disco"). Si hay espacio, el problema suele ser de propietario. En Plesk, asegúrate de que el usuario FTP tenga permisos de escritura en esa carpeta (revisa la sección de "Acceso FTP" en el dominio).

Error: "Connection timed out"

Causa: El servidor no responde o hay un bloqueo de red.
Solución: Prueba a conectar usando SFTP (puerto 22) en lugar de FTP (puerto 21). También puedes reiniciar el servicio FTP desde Plesk (ve a "Herramientas y configuraciones" > "Servicios" y reinicia "FTP Server").

Consejos Avanzados para Gestionar tu PrestaShop con FTP

Si ya has resuelto los problemas básicos, aquí tienes algunos trucos para que tu experiencia sea más fluida:

Usa un Cliente FTP con Gestión de Sesiones

Programas como FileZilla o WinSCP te permiten guardar la configuración de conexión. Así no tendrás que escribir las credenciales cada vez. Guarda la sesión con el nombre de tu tienda y el tipo de conexión (FTPES o SFTP).

Ten Cuidado con los Archivos de Configuración

Los archivos más importantes de PrestaShop son config/settings.inc.php (en versiones antiguas) o los archivos en app/config/ (en versiones 1.7+). Nunca modifiques estos archivos directamente desde FTP sin hacer una copia de seguridad. Un error aquí puede dejar tu tienda inaccesible.

Monitorea los Permisos con Regularidad

Después de instalar un módulo o una actualización, es posible que algunos archivos cambien sus permisos a 777. Es recomendable que, tras finalizar cualquier tarea de mantenimiento, revises y ajustes los permisos a 755/644 para evitar vulnerabilidades de seguridad.

[WARNING] No dejes nunca permisos 777 en archivos o carpetas de forma permanente. Es un agujero de seguridad enorme. Solo úsalos temporalmente y revierte los cambios.

Resumen Final: Checklist para una Conexión FTP Exitosa

Para que no te pierdas, aquí tienes una lista de verificación rápida:

✅ Credenciales: Usuario FTP con formato usuario@dominio.com y contraseña correcta.
✅ Puerto y modo: Usa FTPES (puerto 21) o SFTP (puerto 22) y modo pasivo.
✅ Permisos: Carpetas en 755, archivos en 644. Carpetas especiales (cache, modules) pueden necesitar 777 temporalmente.
✅ Firewall: Desactiva temporalmente el firewall local o la VPN para descartar bloqueos.
✅ Espacio en disco: Verifica que no esté lleno desde Plesk.

Siguiendo estos pasos, deberías poder conectar sin problemas a tu tienda PrestaShop alojada en un servidor con Plesk. Recuerda que la paciencia es clave y que cada servidor puede tener pequeñas particularidades.

Si después de todo esto sigues teniendo errores FTP PrestaShop, no dudes en contactar a tu proveedor de hosting. A veces, la solución está en un ajuste de configuración del servidor que solo ellos pueden realizar. ¡Mucha suerte con tu tienda!