Errores FTP en PrestaShop | Cómo solucionarlos

¿Por qué aparecen errores de conexión FTP en PrestaShop?

Cuando trabajas con PrestaShop, tarde o temprano te encontrarás con algún problema de conexión FTP. Es uno de los contratiempos más comunes, especialmente al intentar instalar módulos, subir temas o simplemente gestionar los archivos de tu tienda online. Pero no te preocupes: la mayoría de estos errores tienen solución y, en este artículo, te voy a guiar paso a paso para que aprendas a resolverlos tú mismo, sin necesidad de ser un experto en informática.

Los errores FTP PrestaShop pueden aparecer en diferentes momentos: al conectar con un cliente FTP como FileZilla, al intentar actualizar un módulo desde el panel de administración o al subir un backup. La buena noticia es que, en el 90% de los casos, el problema no es de tu tienda, sino de la configuración de la conexión o del servidor.

Antes de empezar a solucionar nada, es importante que entiendas qué es exactamente FTP. FTP significa File Transfer Protocol (Protocolo de Transferencia de Archivos) y es el método estándar para mover archivos entre tu ordenador y el servidor donde está alojada tu tienda PrestaShop. Sin una conexión FTP correcta, no puedes gestionar los archivos de tu tienda de forma directa.

¿Listo para convertirte en un experto en solucionar problemas de FTP? Vamos a ello.

Errores FTP más comunes en PrestaShop y sus causas

1. Error de autenticación: "Nombre de usuario o contraseña incorrectos"

Este es, con diferencia, el error más frecuente. Cuando intentas conectarte por FTP y te aparece este mensaje, la causa suele ser una de estas:

Has escrito mal el nombre de usuario o la contraseña.
La contraseña ha caducado (muchos proveedores de hosting la renuevan periódicamente).
El usuario FTP no tiene permisos sobre la carpeta raíz de PrestaShop.
El servidor FTP no permite conexiones desde tu IP.

2. Error de conexión: "No se pudo conectar al servidor"

Este error indica que tu ordenador no puede llegar al servidor FTP. Las causas más comunes son:

El nombre del servidor FTP es incorrecto.
El servidor FTP está caído o en mantenimiento.
Tu firewall o antivirus está bloqueando la conexión.
El puerto FTP (normalmente el 21) está cerrado en tu red local o en el servidor.

3. Timeout o "La conexión expiró"

Si tu conexión FTP se corta a los pocos segundos de iniciarse, puede deberse a:

Tu proveedor de internet tiene problemas de latencia.
El servidor FTP está configurado para cortar conexiones inactivas demasiado pronto.
Hay demasiados archivos en el directorio y la conexión tarda demasiado en listarlos.

4. Error de permisos: "No se puede escribir en el archivo"

Este es un clásico en PrestaShop. Si intentas subir un archivo y te dice que no tienes permisos, significa que el usuario FTP no tiene derechos de escritura sobre esa carpeta o archivo.

5. Error de tipo de transferencia: "Archivos corruptos después de subir"

Si subes archivos y al descomprimirlos en el servidor salen corruptos, probablemente estás transfiriendo en modo ASCII cuando deberías usar modo binario. Esto pasa mucho con imágenes y archivos comprimidos.

Cómo diagnosticar el problema de conexión FTP

Antes de lanzarte a cambiar cosas, te recomiendo hacer un diagnóstico rápido. Sigue estos pasos:

Comprueba los datos de acceso: Revisa que el servidor FTP, el usuario y la contraseña sean correctos. Si no estás seguro, contacta con tu proveedor de hosting.
Prueba con otro cliente FTP: Si usas FileZilla, prueba con Cyberduck o WinSCP. A veces el problema es del software y no del servidor.
Haz un ping al servidor: Abre la terminal de tu ordenador (CMD en Windows, Terminal en Mac) y escribe ping tudominio.com. Si no responde, el servidor está caído o hay un problema de red.
Prueba desde otra red: Si estás en una red corporativa, puede que el puerto 21 esté bloqueado. Prueba desde tu móvil con datos.

[TIP]
Si usas un hosting con panel Syspanel, recuerda que el acceso al panel es a través del puerto 2106. En muchos casos, los datos FTP aparecen dentro del panel, en la sección "Cuentas FTP" o "Usuarios FTP". No confundas el puerto del panel con el puerto FTP (21).

Soluciones paso a paso para los errores FTP PrestaShop

Solución 1: Verificar y corregir los datos de acceso FTP

Esta es la solución más sencilla y la que debes probar primero.

Accede a tu panel de control de hosting (cPanel, Plesk o Syspanel).
Busca la sección "Cuentas FTP" o "Usuarios FTP".
Comprueba el nombre de usuario y la contraseña. Si no recuerdas la contraseña, créala de nuevo.
Asegúrate de que el usuario FTP tenga acceso a la carpeta raíz de tu PrestaShop (normalmente public_html o www).
En tu cliente FTP, introduce los datos exactos y prueba de nuevo.

[WARNING]
Si cambias la contraseña FTP desde el panel, ten en cuenta que puede tardar unos minutos en actualizarse en todos los servidores. Espera al menos 5 minutos antes de reintentar.

Solución 2: Comprobar el servidor FTP y el puerto

Si los datos son correctos pero sigues sin conectar, es hora de revisar el servidor y el puerto.

El servidor FTP suele ser ftp.tudominio.com o tudominio.com. Algunos hostings usan una IP directa.
El puerto estándar es el 21. Sin embargo, algunos servidores usan puertos alternativos por seguridad.
Si tu hosting usa Syspanel, el puerto de acceso al panel es el 2106, pero el FTP seguirá usando el 21 (o el que indique tu proveedor).

Para probar si el puerto 21 está abierto, puedes usar la herramienta "Comprobar puerto" online o desde tu terminal con el comando telnet tudominio.com 21. Si no responde, el puerto está bloqueado.

Solución 3: Cambiar el modo de conexión FTP (activo vs pasivo)

Muchos errores de conexión se solucionan simplemente cambiando el modo de conexión.

Modo activo: El servidor se conecta a tu ordenador para transferir datos.
Modo pasivo: Tu ordenador se conecta al servidor para transferir datos.

En FileZilla, ve a Editar > Ajustes > FTP y selecciona "Modo pasivo". En otros clientes, esta opción suele estar en los ajustes de conexión.

[INFO]
El modo pasivo es el más recomendado hoy en día, ya que evita problemas con firewalls y routers que bloquean conexiones entrantes.

Solución 4: Corregir los permisos de archivos y carpetas

Si recibes errores de permisos al subir archivos, necesitas ajustar los permisos desde tu cliente FTP o desde el panel de control.

Los permisos estándar para PrestaShop son:

Carpetas: 755
Archivos: 644
Archivos de configuración sensibles (como config/settings.inc.php): 444 o 440

Para cambiar permisos en FileZilla:

Haz clic derecho sobre el archivo o carpeta.
Selecciona "Permisos de archivo".
Introduce el valor numérico (755, 644, etc.) y marca "Aplicar a todos los archivos y carpetas" si es necesario.

[WARNING]
No pongas permisos 777 en toda tu tienda. Es un riesgo de seguridad enorme. Úsalo solo temporalmente y cámbialo después.

Solución 5: Usar el administrador de archivos del hosting

Si el FTP no funciona de ninguna manera, tienes un plan B: el administrador de archivos del hosting.

Accede a tu panel de control (cPanel, Plesk o Syspanel).
Busca "Administrador de archivos" o "Gestor de archivos".
Navega hasta la carpeta de tu PrestaShop.
Sube los archivos directamente desde ahí.

Esta es una solución temporal muy útil, pero no es práctica para gestionar muchos archivos. Úsala para emergencias.

Solución 6: Desactivar el firewall o antivirus temporalmente

A veces el problema está en tu propio ordenador. Los firewalls y antivirus pueden bloquear conexiones FTP sin que lo sepas.

Desactiva temporalmente tu antivirus.
Desactiva el firewall de Windows (o el de tu sistema operativo).
Prueba la conexión FTP.
Si funciona, añade tu cliente FTP a la lista de programas permitidos en el firewall.

[INFO]
Si usas Windows, ve a Configuración > Firewall y protección de red > Permitir una aplicación a través del firewall y añade tu cliente FTP.

Solución avanzada: Configurar FTP en PrestaShop para actualizaciones

PrestaShop tiene un sistema interno para conectar por FTP cuando instalas módulos o actualizas el sistema. Si te aparece un error al intentar usar esta función, sigue estos pasos:

Ve a Parámetros Avanzados > Información en tu panel de administración.
Busca la sección "Parámetros del servidor FTP".
Introduce los datos FTP (servidor, usuario, contraseña y puerto).
Marca la opción "Usar FTP para la transferencia de archivos".

Si PrestaShop no puede conectar, el problema suele ser que el usuario FTP no tiene permisos sobre la carpeta de PrestaShop. Asegúrate de que el usuario tenga acceso total a la carpeta raíz.

[TIP]
Si tu hosting usa Syspanel, recuerda que el puerto del panel es el 2106, pero para FTP deberás usar el puerto que indique tu proveedor (normalmente 21). No mezcles los puertos.

Preguntas frecuentes (FAQ) sobre errores FTP en PrestaShop

¿Por qué me pide contraseña FTP cada vez que instalo un módulo?

PrestaShop intenta conectar por FTP automáticamente para copiar archivos. Si no guardas las credenciales en la configuración, te las pedirá cada vez. Ve a Parámetros Avanzados > Información y guarda los datos FTP.

¿Es seguro usar FTP con mi tienda PrestaShop?

Sí, pero con precauciones. Usa siempre conexiones SFTP (SSH File Transfer Protocol) si tu hosting lo permite, ya que cifra la conexión. Si solo tienes FTP estándar, asegúrate de usar contraseñas robustas y cambiarlas frecuentemente.

¿Qué hago si mi hosting no tiene FTP?

Algunos hostings modernos solo ofrecen SFTP o acceso por SSH. En ese caso, tendrás que configurar tu cliente FTP para usar SFTP. En FileZilla, simplemente cambia el protocolo a "SFTP - SSH File Transfer Protocol" y usa el puerto 22 (o el que indique tu proveedor).

¿Puedo usar FTP con mi tienda PrestaShop en local?

Si tienes PrestaShop en tu ordenador (por ejemplo, con XAMPP), no necesitas FTP porque los archivos están en tu propia máquina. El FTP solo es necesario para servidores remotos.

¿Qué hago si el error persiste después de probar todo?

Si has probado todas las soluciones y el error continúa, contacta con tu proveedor de hosting. Es posible que haya un problema en el servidor que solo ellos puedan resolver. Proporciónales el mensaje de error exacto y los pasos que has seguido.

Consejos finales para evitar errores FTP en el futuro

Mantén tus credenciales actualizadas: Cambia las contraseñas FTP cada 3-6 meses.
Usa un gestor de contraseñas: Así evitarás errores de escritura.
Configura el modo pasivo en tu cliente FTP: Es el más fiable.
Comprueba los permisos antes de subir archivos: Evita problemas de escritura.
Haz copias de seguridad periódicas: Si algo sale mal, podrás restaurar tu tienda.

[WARNING]
Nunca subas archivos directamente a la carpeta de PrestaShop sin antes hacer una copia de seguridad. Un error puede dejar tu tienda inaccesible.

Conclusión

Los errores FTP PrestaShop son frustrantes, pero como has visto, casi siempre tienen una solución sencilla. Desde problemas de autenticación hasta permisos incorrectos, pasando por configuraciones de firewall, hay un montón de cosas que puedes comprobar y arreglar por ti mismo.

Recuerda siempre empezar por lo más básico (credenciales y servidor) e ir avanzando hacia soluciones más complejas. Y si te quedas atascado, no dudes en contactar con tu proveedor de hosting: para eso está.

La próxima vez que veas un error de conexión FTP en tu PrestaShop, ya sabes exactamente qué hacer. Respira hondo, sigue esta guía y en pocos minutos tendrás tu tienda funcionando de nuevo. ¡Tú puedes!