Problemas FTP en PrestaShop: causas y soluciones

¿Estás recibiendo un molesto error FTP PrestaShop al intentar conectar tu tienda con el servidor? No te preocupes, es una de las consultas más comunes que recibimos en soporte. La conexión FTP es el puente entre tu ordenador y el hosting donde vive tu tienda, y cuando falla, no puedes subir temas, módulos o hacer copias de seguridad manuales.

En esta guía extensa y paso a paso, vamos a desglosar todas las causas posibles y sus soluciones. Desde verificar credenciales hasta configurar correctamente el FTP en cPanel o en tu panel de control (como Syspanel, el cual usa el puerto 2106). Al final, tendrás un checklist para diagnosticar cualquier problema por ti mismo.

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

Antes de lanzarnos a soluciones técnicas, entendamos el origen del problema. Cuando PrestaShop intenta conectarse por FTP a tu servidor, lo hace para tareas como la instalación automática de módulos o la actualización del núcleo. Si la conexión falla, verás mensajes como "No se puede conectar al servidor FTP" o "Error de autenticación".

Las causas más frecuentes son:

Credenciales incorrectas: El usuario o contraseña FTP no coinciden con los del hosting.
Puerto equivocado: El puerto FTP por defecto es el 21, pero muchos servidores usan puertos alternativos por seguridad.
Firewall o IP bloqueada: Tu proveedor de hosting puede bloquear conexiones desde IPs desconocidas.
Modo pasivo vs activo: PrestaShop necesita un modo específico para funcionar detrás de routers o firewalls.
Permisos de directorio: La carpeta raíz de PrestaShop no tiene los permisos correctos para escritura.
Servidor FTP no iniciado: En algunos paneles como cPanel o Syspanel, el servicio FTP debe estar activo.

Primeros pasos: Verifica tus credenciales FTP

El error más básico pero más común es tener mal el usuario o la contraseña. No confundas las credenciales de tu panel de control (cPanel, Syspanel) con las de FTP. Son diferentes.

### Dónde encontrar tus datos FTP en cPanel

Si tu hosting usa cPanel (el más popular), sigue estos pasos:

Accede a tu cPanel (generalmente en tudominio.com/cpanel o tudominio.com:2083).
Busca la sección Archivos y haz clic en Cuentas FTP.
Verás una lista de cuentas FTP. La principal suele ser la que tiene tu nombre de usuario de cPanel.
Anota el Servidor FTP (suele ser ftp.tudominio.com o la IP del servidor), el Usuario y el Puerto (normalmente 21).
Si no recuerdas la contraseña, puedes cambiarla desde allí mismo. Haz clic en Cambiar contraseña y establece una nueva segura.

[TIP] Si usas Syspanel (nuestro panel basado en HestiaCP), el acceso es por el puerto 2106. Busca la sección "Cuentas FTP" dentro del menú de archivos. Las credenciales suelen ser las mismas que las de tu usuario de Syspanel, pero con el prefijo ftp_ o el nombre de tu dominio.

### Cómo probar la conexión manualmente

Antes de tocar PrestaShop, prueba la conexión con un cliente FTP como FileZilla (gratuito) o Cyberduck. Esto descartará que el problema sea de tu tienda.

Abre FileZilla.
En el campo Host, escribe ftp.tudominio.com o la IP que te dieron.
En Nombre de usuario, pon tu usuario FTP.
En Contraseña, la contraseña correspondiente.
En Puerto, escribe 21 (o el que te haya indicado tu hosting).
Haz clic en Conexión rápida.

Si la conexión es exitosa, verás una lista de carpetas. Si falla, anota el mensaje de error. Los más comunes son:

"Error de conexión: ECONNREFUSED": El servidor rechazó la conexión. Puede ser que el puerto esté cerrado o el servicio FTP no esté corriendo.
"Error de autenticación": Usuario o contraseña incorrectos.
"Error: Conexión cerrada por el servidor": Posiblemente un firewall o límite de conexiones.

Configuración de FTP en PrestaShop: Paso a paso

Una vez que sabes que tus credenciales funcionan fuera de PrestaShop, es hora de configurarlas dentro de tu tienda. Ve a Parámetros de la tienda > Parámetros generales > Subir archivos (o Configuración del FTP en versiones antiguas).

Aquí tienes que rellenar los campos con los datos que verificaste antes:

Servidor FTP: ftp.tudominio.com o la IP.
Puerto FTP: Normalmente 21. Si tu hosting usa SFTP (SSH), el puerto suele ser el 22. Muchos servidores modernos usan puertos personalizados, así que revísalo en tu panel.
Nombre de usuario FTP: El usuario de tu cuenta FTP.
Contraseña FTP: La contraseña correspondiente.
Directorio raíz FTP: Este es un punto crítico. Debe ser la ruta absoluta a la carpeta donde está instalado PrestaShop. Por ejemplo, si tu dominio apunta a public_html/prestashop, el directorio raíz sería /public_html/prestashop o public_html/prestashop (según el servidor). Si lo dejas vacío, PrestaShop asumirá la raíz del usuario FTP.
Modo FTP: Selecciona Pasivo (PASV). Es el más compatible con firewalls y routers domésticos. Si no funciona, prueba con Activo.

[WARNING] Un error muy común es poner mal el directorio raíz. Si no estás seguro, conéctate por FileZilla y mira la ruta exacta en la barra de direcciones cuando estés dentro de la carpeta de tu tienda. Por ejemplo, si ves /home/usuario/public_html/mitienda, esa es la ruta que debes copiar.

### Solución para el error "No se puede cambiar al directorio raíz"

Si ves este error en PrestaShop, significa que la ruta que has puesto no existe o no tienes permisos para acceder a ella. Soluciones:

Verifica la ruta exacta: Usa FileZilla para navegar hasta la carpeta raíz de tu tienda y copia la ruta completa que aparece en la barra de direcciones.
Prueba con rutas relativas: A veces funciona ./ (punto barra) si PrestaShop está en la raíz del usuario FTP, o ../ para subir un nivel.
Permisos de carpeta: Asegúrate de que la carpeta de PrestaShop tenga permisos 755 o 750. Puedes cambiarlos desde cPanel (Administrador de archivos) o desde FileZilla (clic derecho > Permisos de archivo).

Problemas comunes con el firewall y el modo pasivo

Muchos servidores bloquean el modo activo de FTP por seguridad. Si tu conexión falla solo en PrestaShop pero funciona en FileZilla en modo pasivo, el problema puede estar en la configuración de red de tu tienda.

### Cómo forzar el modo pasivo en PrestaShop

En versiones recientes de PrestaShop, el modo pasivo se selecciona directamente en la configuración de FTP. Si no ves la opción, puedes forzarlo editando el archivo de configuración:

Conéctate por FTP a tu servidor (con FileZilla).
Navega hasta la carpeta raíz de PrestaShop.
Busca el archivo config/defines.inc.php.
Ábrelo con un editor de texto (como Notepad++).
Busca la línea que dice define('_PS_FTP_PASSIVE_MODE_', false); y cámbiala a true.
Guarda el archivo y vuelve a probar la conexión desde el panel de administración.

[INFO] Si no encuentras esa línea, puedes añadirla justo antes de la línea define('_PS_CREATION_DATE_', ...). Asegúrate de que no haya errores de sintaxis.

### Firewall del hosting: ¿está bloqueando tu IP?

Si tu IP cambia (por ejemplo, si trabajas desde casa con IP dinámica), el hosting podría bloquearla. Soluciones:

Solicita a tu hosting que añada tu IP a la lista blanca.
Usa una IP estática (si tu conexión lo permite).
Configura un túnel VPN para tener siempre la misma IP.

En cPanel, puedes gestionar esto desde IP Blocker (para desbloquear) o desde Configuración de FTP para permitir conexiones desde cualquier IP (menos seguro, pero útil para pruebas).

Configurar FTP en cPanel: Lo que debes saber

Si tu hosting usa cPanel, la gestión de FTP es muy sencilla. Aquí tienes un resumen rápido para evitar errores:

Crear una cuenta FTP específica para PrestaShop: No uses la cuenta principal. Ve a Cuentas FTP y crea una nueva con acceso solo a la carpeta de tu tienda. Esto es más seguro.
Directorio raíz: Al crear la cuenta, define el directorio raíz como public_html/mitienda (o la carpeta donde tengas PrestaShop).
Puerto: Por defecto es 21. No lo cambies a menos que tu hosting lo exija.
Modo pasivo: En cPanel, el modo pasivo suele estar habilitado por defecto. Si no, puedes forzarlo desde la configuración de PrestaShop como vimos antes.
Permisos: Asegúrate de que la carpeta public_html/mitienda tenga permisos 755. Puedes cambiarlos desde el Administrador de archivos de cPanel.

[TIP] Si tu hosting usa Syspanel (puerto 2106), la configuración es similar. Busca "Cuentas FTP" en el menú. El directorio raíz suele ser algo como /home/usuario/web/tudominio/public_html. Copia esa ruta exacta.

Solución a errores específicos de FTP en PrestaShop

Vamos a ver los mensajes de error más frecuentes y cómo solucionarlos uno por uno.

### Error: "No se puede conectar al servidor FTP"

Este error suele indicar que el servidor no está respondiendo. Causas:

El servicio FTP no está corriendo: En cPanel, ve a Servicios y asegúrate de que FTP esté activo. En Syspanel, revisa el estado desde el panel de administración.
Puerto incorrecto: Prueba con el puerto 21 (FTP estándar) o 22 (SFTP). Si tu hosting usa un puerto personalizado, búscalo en la documentación.
Firewall del servidor: Contacta con tu hosting para que verifique si tu IP está bloqueada.

### Error: "Error de autenticación: Usuario o contraseña incorrectos"

Revisa mayúsculas/minúsculas: Los usuarios y contraseñas FTP distinguen entre mayúsculas y minúsculas.
Cambia la contraseña desde el panel de control (cPanel, Syspanel) y pruébala de nuevo.
Asegúrate de que el usuario FTP existe: En cPanel, ve a Cuentas FTP y verifica que tu usuario esté listado.

### Error: "No se puede escribir en el directorio"

Esto es un problema de permisos. La carpeta de PrestaShop debe ser escribible por el usuario FTP.

Cambia los permisos de la carpeta raíz a 755 (o 750 si tu hosting lo exige). Hazlo desde el administrador de archivos de tu panel.
Verifica el propietario de la carpeta: Debe coincidir con el usuario FTP. En cPanel, puedes cambiar el propietario desde Administrador de archivos > Permisos.
Si usas Syspanel, los permisos se gestionan desde el panel de archivos. Busca la opción "Permisos" al hacer clic derecho sobre la carpeta.

FAQ: Preguntas frecuentes sobre conexión FTP en PrestaShop

### ¿Puedo usar SFTP en lugar de FTP?

Sí, muchos servidores ofrecen SFTP (FTP sobre SSH) que es más seguro. El puerto suele ser el 22. En PrestaShop, en la configuración de FTP, selecciona SFTP si está disponible. Si no, puedes forzarlo editando el archivo de configuración, pero es más complejo.

### ¿Qué hago si mi hosting usa Syspanel (puerto 2106)?

Syspanel es nuestro panel basado en HestiaCP. El puerto de acceso es el 2106. Dentro, busca "Cuentas FTP" en el menú de archivos. Las credenciales suelen ser las mismas que las de tu usuario de Syspanel, pero con el prefijo del dominio. Por ejemplo, usuario admin y contraseña de tu cuenta. El directorio raíz suele ser /home/usuario/web/tudominio/public_html. Si tienes dudas, consulta la documentación de tu hosting.

### ¿Por qué PrestaShop no puede subir módulos aunque el FTP funcione?

Esto puede deberse a que el directorio de módulos (/modules) no tiene permisos de escritura. También puede ser un límite de tamaño de archivo en el servidor. Revisa los permisos de la carpeta modules (debe ser 755) y el límite de subida en php.ini (upload_max_filesize).

### ¿El modo pasivo es siempre mejor?

No siempre, pero sí en la mayoría de los casos. Si estás detrás de un router o firewall, el modo pasivo es más fiable. Si tu servidor está en una red local sin restricciones, el modo activo puede ser más rápido. Prueba ambos.

### ¿Cómo sé si mi hosting soporta FTP?

La mayoría de los hostings lo soportan. Si no estás seguro, revisa la documentación de tu proveedor o contacta con su soporte. Si usas un hosting compartido, suele estar incluido.

Resumen: Checklist para solucionar el error FTP en PrestaShop

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

Verifica credenciales: Usuario, contraseña y servidor FTP correctos.
Prueba con FileZilla: Si no conecta, el problema es del servidor.
Revisa el puerto: 21 (FTP), 22 (SFTP) o el que indique tu hosting.
Modo pasivo: Actívalo en PrestaShop.
Directorio raíz: Copia la ruta exacta desde FileZilla.
Permisos: Carpeta raíz y /modules en 755.
Firewall: Asegúrate de que tu IP no esté bloqueada.
Servicio FTP: Verifica que esté activo en cPanel o Syspanel.
Reinicia PrestaShop: A veces un simple reinicio de la tienda (desde el panel) resuelve errores de caché.

Si después de todo esto sigues teniendo el error FTP PrestaShop, contacta con tu proveedor de hosting. Ellos pueden revisar los logs del servidor y darte una solución personalizada.

Esperamos que esta guía te haya sido de ayuda. Recuerda que la paciencia es clave: la mayoría de los problemas de conexión FTP se deben a pequeños detalles de configuración. ¡Manos a la obra y a solucionar ese error!