Solución de problemas de conexión FTP en PrestaShop con Plesk

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí, seguramente te has topado con el clásico dolor de cabeza: error de conexión FTP o problemas de permisos de archivos en tu tienda PrestaShop alojada en un servidor con Plesk. No te preocupes, es más común de lo que parece y, con esta guía paso a paso, lo resolveremos juntos.

Vamos a desglosar todo lo que necesitas saber para diagnosticar y solucionar los problemas de conexión FTP en PrestaShop con Plesk. Al final, tendrás tu tienda funcionando como un reloj suizo.

¿Por qué ocurren los errores de conexión FTP en PrestaShop con Plesk?

Antes de lanzarnos a las soluciones, entendamos el origen del problema. Plesk es un panel de control potente, pero a veces su configuración de seguridad y permisos puede chocar con la forma en que PrestaShop maneja los archivos. Los errores más comunes incluyen:

• Credenciales incorrectas: El usuario y contraseña FTP no coinciden con los del servidor.
• Puerto bloqueado o incorrecto: El puerto FTP por defecto (21) puede estar cerrado por un firewall o ser diferente.
• Modo pasivo vs. activo: Tu cliente FTP (como FileZilla) y el servidor Plesk pueden no estar de acuerdo en el modo de transferencia.
• Permisos de archivos y carpetas inadecuados: PrestaShop necesita permisos específicos (generalmente 755 para carpetas y 644 para archivos) para leer, escribir y ejecutar.
• Problemas con el firewall del servidor (Plesk Firewall): Plesk incluye un firewall que puede estar bloqueando las conexiones FTP.
• Usuarios FTP del sistema vs. usuarios de Plesk: A veces, el usuario FTP que creas en Plesk no tiene los permisos correctos sobre los archivos de la tienda.

Solución paso a paso para el error de conexión FTP en PrestaShop con Plesk

Aquí tienes un plan de acción. Sigue estos pasos en orden, y lo más probable es que encuentres la solución.

Paso 1: Verifica tus credenciales FTP en Plesk

El error más básico es tener mal el usuario o la contraseña. Asegúrate de que estás usando las credenciales correctas del usuario FTP que creaste en Plesk, no las de tu cuenta de administrador de Plesk.

1. Accede a tu panel de Plesk.
2. Ve a Sitios web y dominios.
3. Busca tu dominio de PrestaShop y haz clic en Acceso FTP.
4. Aquí verás el nombre de usuario FTP (suele ser algo como tudominio_ftpuser o similar) y la opción de cambiar la contraseña.
5. Recomendación: Si tienes dudas, cambia la contraseña desde aquí y usa esa nueva en tu cliente FTP (FileZilla, Cyberduck, etc.).

[TIP] Asegúrate de que el nombre de usuario FTP incluya el prefijo del suscriptor (ej: midominio_ftpuser). A veces lo olvidamos.

Paso 2: Comprueba la configuración del cliente FTP (FileZilla, etc.)

Tu cliente FTP debe estar configurado correctamente para conectarse a Plesk. Los ajustes típicos son:

• Servidor: ftp.tudominio.com o la IP de tu servidor.
• Puerto: 21 (FTP estándar) o 990 (FTP sobre SSL/TLS explícito). A veces, Plesk usa un puerto no estándar por seguridad.
• Protocolo: FTP (si no usas cifrado) o FTPES (FTP sobre SSL/TLS explícito). Recomiendo usar FTPES para mayor seguridad.
• Modo de transferencia: Intenta con Modo Pasivo primero. Si falla, prueba con Modo Activo.

¿Cómo cambiar el modo en FileZilla?

1. Ve a Editar -> Ajustes.
2. En Conexiones -> FTP, busca la opción Modo de transferencia.
3. Selecciona Pasivo (recomendado) o Activo.
4. Prueba la conexión de nuevo.

Paso 3: Verifica los permisos de archivos y carpetas de PrestaShop

Este es uno de los problemas más frecuentes. PrestaShop necesita permisos específicos para funcionar correctamente. Si los permisos son incorrectos, no podrás subir módulos, temas, o incluso la tienda dará errores.

¿Cómo verificar y corregir permisos desde Plesk?

1. En Plesk, ve a Sitios web y dominios -> haz clic en Administrador de archivos.
2. Navega hasta la carpeta raíz de tu PrestaShop (normalmente httpdocs o public_html).
3. Selecciona todos los archivos y carpetas (Ctrl+A).
4. Haz clic en el botón Permisos (icono de candado o engranaje).
5. Se abrirá una ventana. Aquí puedes establecer los permisos.

Permisos recomendados para PrestaShop:

• Carpetas (directorios): 755 (rwxr-xr-x). Esto significa que el propietario puede leer, escribir y ejecutar; el grupo y otros solo pueden leer y ejecutar.
• Archivos: 644 (rw-r--r--). El propietario puede leer y escribir; el grupo y otros solo pueden leer.
• Archivos de configuración importantes (como config/settings.inc.php): 644 o incluso 444 (solo lectura) después de la instalación.

[WARNING] No pongas permisos 777 (todos pueden leer, escribir y ejecutar) en ningún archivo o carpeta. Es un grave riesgo de seguridad.

¿Cómo cambiar permisos rápidamente desde un cliente FTP?
Si prefieres usar tu cliente FTP:

1. Conéctate por FTP.
2. Selecciona los archivos/carpetas.
3. Haz clic derecho -> Permisos de archivo.
4. Introduce el valor numérico (755 o 644) y haz clic en Aceptar. Puedes marcar la opción Recursivamente en subdirectorios para aplicar a todo.

Paso 4: Revisa el firewall de Plesk (Plesk Firewall)

Plesk tiene un firewall integrado que puede estar bloqueando las conexiones FTP. Asegúrate de que los puertos necesarios estén abiertos.

1. En Plesk, ve a Herramientas y configuraciones.
2. Busca Firewall (o Seguridad del firewall).
3. Ve a la pestaña Reglas de firewall.
4. Busca las reglas para FTP.
   • Puerto 21 (FTP estándar): Debe estar permitido para conexiones entrantes.
   • Puerto 990 (FTP sobre SSL/TLS): Si usas FTPES, este puerto debe estar abierto.
   • Puertos pasivos (rango): Para el modo pasivo, Plesk suele usar un rango de puertos (ej: 30000-31000). Asegúrate de que también estén permitidos.
5. Si no ves las reglas, puedes añadirlas manualmente. Haz clic en Añadir regla y selecciona FTP de la lista de servicios.

[INFO] Si tu servidor tiene un firewall externo (como en un VPS o servidor dedicado), también deberás abrir esos puertos allí. Contacta con tu proveedor de hosting si no estás seguro.

Paso 5: Prueba con un usuario FTP del sistema (si todo lo demás falla)

A veces, los usuarios FTP creados desde el panel de sitios web no tienen los permisos correctos sobre los archivos del sistema. En Plesk, puedes crear un usuario FTP del sistema que tenga acceso completo.

1. Ve a Herramientas y configuraciones -> Usuarios del sistema.
2. Haz clic en Crear usuario del sistema.
3. Dale un nombre (ej: ftpadmin), una contraseña segura y asígnale el shell /bin/bash (o /bin/sh).
4. Importante: Asegúrate de que el directorio de inicio de este usuario sea la carpeta raíz de tu PrestaShop (ej: /var/www/vhosts/tudominio.com/httpdocs).
5. Conéctate con este usuario a través de FTP (usando el dominio o IP del servidor).

[WARNING] Este método da acceso completo al sistema de archivos. Úsalo solo para diagnosticar y, una vez resuelto, considera eliminar o deshabilitar este usuario.

Preguntas frecuentes (FAQ) sobre FTP PrestaShop Plesk

P: Me sale el error "530 Login incorrect" al conectar por FTP. ¿Qué hago?

R: Este error indica que el usuario o la contraseña son incorrectos. Revisa el Paso 1. Asegúrate de que el nombre de usuario incluya el prefijo del suscriptor (ej: midominio_user). Si olvidaste la contraseña, cámbiala desde Plesk en Sitios web y dominios -> Acceso FTP.

P: Mi conexión FTP funciona, pero no puedo subir archivos grandes o me da error de tiempo de espera.

R: Esto suele deberse al modo pasivo/activo o a un firewall. Prueba a cambiar el modo en tu cliente FTP (Paso 2). También puedes aumentar el tiempo de espera en la configuración de tu cliente FTP. En FileZilla, ve a Editar -> Ajustes -> Transferencias y aumenta el Tiempo de espera (por ejemplo, a 60 segundos).

P: Después de subir archivos por FTP, mi tienda PrestaShop se ve en blanco o da error 500.

R: Esto es casi siempre un problema de permisos. Los archivos que subiste probablemente tienen permisos incorrectos (como 777). Conéctate de nuevo por FTP, selecciona los archivos que subiste y cámbiales los permisos a 644 (archivos) y 755 (carpetas). Luego, limpia la caché de PrestaShop desde el back office (Parámetros de la tienda -> Rendimiento -> Limpiar caché).

P: ¿Cómo sé si el puerto 21 está abierto en mi servidor Plesk?

R: Puedes usar una herramienta online como "Port Checker" o desde tu ordenador usar el comando telnet tudominio.com 21 (en Windows, activa Telnet desde "Activar o desactivar características de Windows"). Si el puerto está abierto, verás una respuesta del servidor FTP. Si no, el firewall de Plesk o un firewall externo lo está bloqueando (Paso 4).

P: Uso Syspanel (HestiaCP) en otro servidor, ¿es diferente?

R: ¡Buena pregunta! Aunque esta guía es específica para Plesk, los principios son similares en Syspanel. En Syspanel, el acceso al panel es a través del puerto 2106. La gestión de usuarios FTP y permisos se hace desde la sección de "Usuarios FTP" o "Dominios". Los pasos de verificación de credenciales y permisos son igual de importantes.

Conclusión

Los problemas de conexión FTP en PrestaShop con Plesk pueden ser frustrantes, pero siguiendo esta guía paso a paso, podrás resolver la mayoría de ellos. Recuerda siempre:

1. Verifica las credenciales.
2. Configura bien tu cliente FTP (modo pasivo, puerto correcto).
3. Revisa los permisos de archivos y carpetas (755/644).
4. Asegúrate de que el firewall de Plesk no bloquee los puertos FTP.
5. Si nada funciona, prueba con un usuario del sistema.

Si después de todo esto sigues teniendo problemas, no dudes en contactar con el soporte técnico de tu hosting. Ellos podrán revisar la configuración del servidor a nivel más profundo.

¡Espero que este artículo te haya sido de gran ayuda! Ahora ya sabes cómo solucionar los errores de conexión FTP y mantener tu PrestaShop en plena forma. ¡Buena suerte con tu tienda!