Error FTP en PrestaShop: Soluciones rápidas

¿Te ha aparecido un molesto mensaje de error FTP PrestaShop justo cuando intentabas subir un tema nuevo o actualizar un módulo? No te preocupes, es una de las incidencias más comunes al gestionar una tienda online. Una conexión FTP fallida puede deberse a varias causas, desde un dato mal escrito hasta un problema de configuración del servidor.

En esta guía extensa y muy visual, vamos a desglosar paso a paso todas las soluciones posibles. No necesitas ser un experto en hosting; solo sigue el orden que te proponemos y, casi con total seguridad, resolverás el problema. Al final, incluimos una sección de preguntas frecuentes para esas dudas rápidas.

1. Lo Primero: Verifica tus Credenciales FTP

El error más típico es, simplemente, tener mal las claves de acceso. Parece una tontería, pero con las prisas es fácil equivocarse.

¿Qué datos necesitas?

Para conectar por FTP a tu hosting (donde está alojado PrestaShop) necesitas cuatro cosas:

Servidor FTP: Normalmente es ftp.tudominio.com o la dirección IP de tu servidor (ej. 192.168.1.1).
Nombre de usuario FTP: No suele ser el mismo que el de tu panel de control (cPanel, Syspanel, Plesk...). A menudo es algo como usuario@tudominio.com o el nombre de tu cuenta de hosting.
Contraseña FTP: La contraseña específica para esa cuenta FTP.
Puerto: Casi siempre es el 21 (estándar FTP). Si usas SFTP (más seguro), suele ser el puerto 22.

Pasos para verificar:

Abre un cliente FTP como FileZilla (es gratuito y muy usado) o el propio gestor de archivos de tu hosting.
Introduce los datos exactamente como te los proporcionó tu empresa de hosting.
IMPORTANTE: Asegúrate de que en la configuración de PrestaShop (Parámetros de la tienda > Configuración FTP) estás poniendo exactamente los mismos datos que usas en FileZilla.
Si en FileZilla conecta bien pero en PrestaShop da error, el problema está en cómo escribes los datos en PrestaShop. Revisa mayúsculas, minúsculas, puntos y guiones.

[TIP] Si no recuerdas tu contraseña FTP, puedes cambiarla desde el panel de control de tu hosting. Busca la sección "Cuentas FTP" o "Usuarios FTP". En Syspanel (antes VestaCP), está en "Usuarios FTP".

2. Comprueba que el Servidor FTP está Activo

A veces el problema no son tus datos, sino que el servicio FTP del servidor se ha detenido o está bloqueado.

¿Cómo saberlo?

Desde tu panel de control (cPanel, Syspanel, Plesk): Busca una sección de "Servicios" o "Gestión de servicios". Deberías ver algo como "FTP Server" o "ProFTPD" o "vsftpd". Asegúrate de que esté encendido (color verde o "Running").
Pregunta a tu soporte técnico: Si no encuentras la opción, contacta con tu proveedor de hosting. Ellos pueden verificar al instante si el servicio FTP está caído.

[WARNING] Si tu hosting usa Syspanel (acceso por puerto 2106), ve a "Servicios" y busca "FTP Server". Si está apagado, haz clic en "Iniciar". Si no aparece, contacta con soporte.

3. El Puerto de Conexión: El Gran Olvidado

PrestaShop, por defecto, intenta conectar por el puerto 21 (FTP estándar). Sin embargo, muchos servidores modernos exigen conexiones seguras (SFTP o FTPS) que usan puertos diferentes.

¿Qué puerto debes usar?

FTP estándar (no seguro): Puerto 21. Si tu hosting lo permite, es el más sencillo.
SFTP (FTP sobre SSH): Puerto 22. Mucho más seguro. PrestaShop también lo soporta.
FTPS (FTP sobre SSL/TLS): Puerto 990 o 21 (depende de la configuración).

Cómo configurarlo en PrestaShop:

Ve a Parámetros de la tienda > Configuración FTP.
En el campo "Puerto", escribe el número correcto (21, 22 o 990).
Si tu hosting requiere SFTP, marca la casilla "Usar SFTP" si existe. En versiones antiguas de PrestaShop, puede que no aparezca; entonces tendrás que usar otro método.

[INFO] Si no estás seguro de qué puerto usa tu hosting, consulta el panel de control o la documentación. En Syspanel, el FTP suele ir por el puerto 21 estándar, pero el SFTP (puerto 22) también está disponible si tu plan lo incluye.

4. Problemas con el Servidor FTP (Dirección IP o Nombre)

A veces la dirección del servidor FTP que tienes no es la correcta. Prueba estas alternativas:

Prueba con la IP del servidor: En lugar de ftp.tudominio.com, usa la dirección IP de tu hosting (ej. 123.456.789.0). La IP la encuentras en tu panel de control, en "Información del servidor" o "IP dedicada".
Prueba con el nombre del servidor: Algunos hostings usan algo como srv01.tuhosting.com.
Asegúrate de que no hay un firewall bloqueando: Tu propio firewall de Windows o Mac, o el firewall del servidor (como CSF o iptables), podría estar bloqueando el puerto FTP. Prueba a desactivar temporalmente tu firewall local para descartarlo.

[WARNING] Si usas Syspanel, la IP del servidor suele aparecer en la parte superior del panel cuando inicias sesión. También puedes verla en "Servidores Web".

5. Permisos de Archivos y Carpetas (CHMOD)

Aunque el FTP conecte bien, PrestaShop puede fallar si los archivos o carpetas no tienen los permisos correctos para ser escritos o leídos.

¿Qué permisos necesita PrestaShop?

Carpetas (directorios): Deben tener permisos 755 (rwxr-xr-x). Esto permite al servidor leer y ejecutar, pero solo al propietario escribir.
Archivos: Deben tener permisos 644 (rw-r--r--). Permite leer a todos, pero solo escribir al propietario.
Archivos de configuración (como config/settings.inc.php): A veces necesitan 777 temporalmente para que PrestaShop pueda escribir, pero luego hay que bajarlos a 644 por seguridad.

Cómo cambiarlos desde FileZilla:

Conéctate por FTP a tu servidor.
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Selecciona todos los archivos y carpetas (Ctrl+A).
Haz clic derecho > "Permisos de archivo...".
Marca las casillas como se indica:
- Propietario: Lectura, Escritura, Ejecución (todas).
- Grupo: Lectura, Ejecución.
- Público: Lectura, Ejecución.
Marca la opción "Recurse into subdirectories" y elige "Apply to directories only" para carpetas, y luego repite con "Apply to files only" para archivos.

[TIP] Si no quieres complicarte, muchos hostings ofrecen un botón "Reparar permisos" desde el panel de control. En Syspanel, busca "Herramientas > Reparar permisos de archivos".

6. El Archivo `settings.inc.php` y los Datos de Conexión

PrestaShop guarda la configuración de FTP en un archivo llamado config/settings.inc.php. Si este archivo está dañado o tiene datos incorrectos, el error persistirá.

Solución: Editar manualmente el archivo

Conéctate por FTP a tu servidor.
Busca la carpeta config y dentro el archivo settings.inc.php.
Descarga una copia de seguridad (importante).
Ábrelo con un editor de texto plano (como Notepad++ o Sublime Text).
Busca las líneas que empiezan por define('_DB_SERVER_', define('_DB_NAME_', define('_DB_USER_', define('_DB_PASSWD_'. NO TOQUES ESTAS, son para la base de datos.

Busca las líneas relacionadas con FTP (si existen). Suelen ser algo como:

define('_PS_FTP_SERVER_', 'ftp.tudominio.com');
define('_PS_FTP_USER_', 'tu_usuario');
define('_PS_FTP_PASSWD_', 'tu_contraseña');
define('_PS_FTP_PORT_', 21);

Corrige los valores si están mal. Si no existen, puedes añadirlas justo antes de la línea define('_MEDIA_SERVER_1_',....
Guarda el archivo y súbelo de nuevo al servidor (sobrescribiendo el original).

[WARNING] Ten mucho cuidado al editar settings.inc.php. Un error de sintaxis (como una comilla mal puesta) puede dejar tu tienda inaccesible. Si no te sientes seguro, contacta con soporte técnico.

7. El Modo de Conexión (Activo vs Pasivo)

El FTP tiene dos modos de conexión: Activo y Pasivo. El modo Pasivo es el más fiable hoy en día, especialmente si tienes un firewall o estás detrás de un router.

Cómo cambiarlo en PrestaShop:

No hay una opción directa en PrestaShop para cambiarlo. Sin embargo, FileZilla sí te permite elegir. Si desde FileZilla conectas bien en modo Pasivo, pero PrestaShop falla, el problema no es el modo.

Solución práctica: La mayoría de los servidores modernos solo aceptan modo Pasivo. Si tu hosting lo requiere, asegúrate de que tu cliente FTP (FileZilla) esté configurado en Pasivo (Editar > Ajustes > FTP > Modo de transferencia: Pasivo).

8. Solución Alternativa: Desactivar el FTP en PrestaShop

Si todo lo anterior falla, puedes desactivar el sistema de FTP interno de PrestaShop y gestionar los archivos manualmente. Esto es perfectamente válido y muchos usuarios lo prefieren por seguridad.

Pasos para desactivarlo:

Ve a Parámetros de la tienda > Configuración FTP.
Desmarca la opción "Usar FTP para subir archivos" (o similar, según la versión).
Guarda la configuración.

A partir de ahora, para subir temas, módulos o traducciones, tendrás que hacerlo manualmente:

Subir archivos por FTP: Usa FileZilla para copiar los archivos a las carpetas correspondientes (themes/, modules/, translations/).
Usar el gestor de archivos del hosting: Desde cPanel, Syspanel o Plesk, puedes subir archivos directamente desde el navegador.

[TIP] Esta es la solución más segura y estable. Evitas posibles conflictos de conexión y reduces la superficie de ataque.

9. Preguntas Frecuentes (FAQ)

¿Por qué FileZilla conecta bien pero PrestaShop da error de FTP?

Esto suele pasar porque PrestaShop no está usando los mismos datos que FileZilla. Revisa que el servidor, usuario, contraseña y puerto sean idénticos. También puede deberse a que PrestaShop intenta conectar en modo Activo y tu servidor solo acepta Pasivo.

¿El error de conexión FTP puede deberse a un plugin de seguridad?

Sí, algunos plugins de seguridad para PrestaShop (como módulos de firewall) pueden bloquear las conexiones FTP salientes. Prueba a desactivar temporalmente cualquier módulo de seguridad para descartarlo.

¿Qué hago si mi hosting usa Syspanel y no sé cómo acceder al FTP?

Accede a Syspanel por el puerto 2106 (ej. https://tudominio.com:2106). Dentro, busca "Usuarios FTP" para ver tus credenciales. También puedes crear una nueva cuenta FTP desde allí. El servidor FTP suele ser ftp.tudominio.com o la IP del servidor.

¿Es obligatorio usar FTP en PrestaShop?

No, para nada. Puedes desactivarlo y gestionar todo manualmente. Es más, muchos expertos recomiendan desactivarlo por seguridad. La única desventaja es que tendrás que subir los archivos tú mismo mediante FileZilla o el gestor del hosting.

¿Puedo usar SFTP en lugar de FTP?

Sí, PrestaShop soporta SFTP (puerto 22). Es más seguro. Solo asegúrate de que tu hosting lo tenga habilitado y de marcar la opción correspondiente en la configuración de PrestaShop (si tu versión lo permite).

Resumen Final: Checklist Rápido

Si el error persiste, repasa esta lista:

Credenciales: Revisa servidor, usuario, contraseña y puerto.
Servicio FTP: Verifica que esté activo en tu panel de control.
Puerto: Asegúrate de que es el correcto (21, 22 o 990).
Modo Pasivo: Configura tu cliente FTP en modo pasivo.
Permisos: Revisa que carpetas (755) y archivos (644) tengan los permisos adecuados.
settings.inc.php: Edita manualmente si es necesario.
Desactivar FTP: Como última opción, desactívalo y sube archivos manualmente.

Con estos pasos, el molesto error FTP PrestaShop debería ser cosa del pasado. Recuerda que siempre puedes pedir ayuda a tu proveedor de hosting; ellos tienen acceso directo al servidor y pueden identificar el problema en segundos. ¡Ánimo con tu tienda!