Cómo solucionar problemas de conexión FTP en PrestaShop con DirectAdmin
Introducción: Cuando PrestaShop y el FTP se convierten en un dolor de cabeza
Si estás leyendo esto, es muy probable que hayas intentado conectar tu tienda PrestaShop por FTP y te hayas encontrado con un mensaje de error frustrante. No te preocupes, es una de las consultas más comunes en soporte técnico de hosting. La buena noticia es que el 90% de los problemas de conexión FTP PrestaShop con DirectAdmin tienen soluciones sencillas que puedes aplicar tú mismo en pocos minutos.
Este artículo está pensado para que, incluso sin experiencia técnica, puedas diagnosticar y resolver los errores más habituales. Vamos a ir paso a paso, desde lo más básico hasta configuraciones más avanzadas, para que tu FTP PrestaShop DirectAdmin funcione a la perfección.
¿Por qué falla la conexión FTP en PrestaShop?
Antes de lanzarnos a solucionar, es útil entender qué está pasando. Cuando tu PrestaShop intenta conectarse por FTP a tu servidor (gestionado con DirectAdmin), se establece un diálogo entre tu tienda y el servidor. Si algo falla en ese diálogo, verás un error FTP PrestaShop.
Las causas más comunes son:
- Datos de acceso incorrectos (usuario, contraseña o puerto).
- Configuración errónea del servidor FTP en el panel de PrestaShop.
- Firewall o bloqueo de puertos.
- El servidor FTP no está activo en DirectAdmin.
- Problemas con el modo pasivo/activo de FTP.
- Rutas absolutas incorrectas.
Vamos a desglosar cada una de estas causas y te daré la solución paso a paso.
Paso 1: Verifica tus credenciales FTP (lo más básico y común)
El error más frecuente es simplemente tener mal escritas las credenciales. Parece obvio, pero es el primer punto a revisar.
### Cómo obtener tus credenciales FTP en DirectAdmin
-
Accede a tu panel de DirectAdmin (normalmente en
https://tu-dominio.com:2222). -
Busca la sección "Cuentas FTP" o "FTP Management".
-
Ahí verás el usuario FTP (suele ser algo como
tucuenta@tudominio.comotucuenta_ftp) y podrás cambiar o restablecer la contraseña. -
Asegúrate de que el puerto sea el 21 (el estándar) o el 2106 si tu hosting usa Syspanel (antes conocido como HestiaCP). [INFO] En DirectAdmin tradicional, el puerto por defecto es el 21.
### Configura los datos en PrestaShop
-
Ve a tu panel de administración de PrestaShop.
-
Navega a Parámetros avanzados > Servidor FTP (o Configuración > FTP, dependiendo de la versión).
-
Introduce el servidor FTP (normalmente
localhostoftp.tudominio.com), el usuario, la contraseña y el puerto. -
Guarda los cambios.
[WARNING] Si cambias la contraseña FTP en DirectAdmin, deberás actualizarla también en la configuración de PrestaShop. Si no lo haces, seguirás viendo el error.
Paso 2: Comprueba que el servidor FTP esté activo en DirectAdmin
A veces, el servicio FTP está desactivado en el servidor. Esto es más común de lo que piensas, sobre todo si tu hosting ha migrado o ha habido cambios de configuración.
### Cómo verificar el estado del servicio FTP
-
En tu panel de DirectAdmin, busca la sección "Servicios del sistema" o "System Services".
-
Busca el servicio relacionado con FTP (puede llamarse
vsftpd,proftpdopure-ftpd). -
Asegúrate de que esté "en ejecución". Si aparece como "detenido", actívalo.
[TIP] Si no encuentras esta opción, contacta con tu proveedor de hosting y pregúntales si el servicio FTP está activo y si el puerto 21 está abierto.
Paso 3: El modo pasivo (clave para el error FTP PrestaShop)
Uno de los errores FTP PrestaShop más típicos está relacionado con el modo pasivo. El FTP tiene dos modos: activo y pasivo. En la mayoría de los casos, el modo pasivo es el que funciona mejor, especialmente si tu tienda está detrás de un router o firewall.
### Cómo cambiar a modo pasivo en PrestaShop
-
En la configuración FTP de PrestaShop, busca una opción que diga "Modo pasivo" o "Passive mode".
-
Actívala y guarda los cambios.
-
Prueba de nuevo la conexión.
Si tu cliente FTP (como FileZilla) se conecta bien pero PrestaShop no, el problema es casi seguro el modo pasivo.
[INFO] El modo pasivo permite que el servidor FTP abra un puerto aleatorio para la transferencia de datos, mientras que en el activo es el cliente quien lo hace. Esto suele estar bloqueado en la mayoría de los entornos de hosting compartido.
Paso 4: Comprueba las rutas absolutas (sube de nivel)
PrestaShop necesita saber la ruta exacta donde está instalado en el servidor para poder gestionar archivos vía FTP. Si esta ruta es incorrecta, verás errores aunque las credenciales sean correctas.
### Cómo encontrar la ruta correcta
-
En DirectAdmin, ve a la sección "Administrador de archivos" o "File Manager".
-
Observa la ruta de la carpeta donde está instalado PrestaShop. Normalmente es algo como
/home/tucuenta/public_htmlo/home/tucuenta/domains/tudominio.com/public_html. -
Copia esa ruta exacta y pégala en el campo "Ruta absoluta" o "Absolute path" en la configuración FTP de PrestaShop.
[WARNING] No uses rutas relativas como
./public_html. Debe ser la ruta completa desde la raíz del servidor.
Paso 5: Firewalls, IPs y puertos bloqueados
Tu firewall local o el del servidor pueden estar bloqueando la conexión FTP. Esto es especialmente común si estás en una red corporativa o con restricciones de seguridad.
### Qué hacer si sospechas de un firewall
-
Prueba a conectarte desde otra red (por ejemplo, desde tu móvil con datos).
-
Si funciona, el problema es tu red local.
-
Asegúrate de que tu IP no esté bloqueada en el servidor. En DirectAdmin, busca la sección "IP Manager" o "Firewall".
### Puertos que deben estar abiertos
- Puerto 21: Para el control de conexión FTP.
- Puertos 1024-65535: Para el modo pasivo (aunque estos suelen ser dinámicos).
[TIP] Si tu proveedor de hosting te pide que configures un rango de puertos para el modo pasivo, anótalo. Algunos paneles como Syspanel (puerto 2106) tienen configuraciones específicas.
Paso 6: Usa FTPS (FTP Seguro) para evitar problemas de seguridad
Si estás teniendo problemas de conexión intermitente, puede ser que tu servidor requiera una conexión cifrada (FTPS). PrestaShop soporta FTPS.
### Cómo configurar FTPS en PrestaShop
-
En la configuración FTP, busca la opción "Tipo de conexión" o "Connection Type".
-
Selecciona "FTPS" o "FTP implícito/explícito".
-
Guarda y prueba.
[INFO] FTPS usa el puerto 990 (implícito) o el 21 (explícito). Si tu hosting usa Syspanel, recuerda que el acceso a este panel es por el puerto 2106, pero el FTP puede seguir usando el 21 o el 990.
Paso 7: Revisa los logs del servidor (para técnicos valientes)
Si has llegado hasta aquí y nada funciona, es hora de mirar los registros del servidor. Esto te dará pistas exactas sobre el error.
### Cómo acceder a los logs en DirectAdmin
-
Ve a "Registros" o "Logs" en DirectAdmin.
-
Busca el log del servidor FTP (normalmente
ftp.logovsftpd.log). -
Analiza las últimas líneas para ver el motivo del rechazo (contraseña incorrecta, IP bloqueada, etc.).
Si no te sientes cómodo con esto, no pasa nada. Es el momento de contactar con soporte técnico y darles esta información.
Preguntas Frecuentes (FAQ) sobre el error FTP PrestaShop
Aquí tienes las dudas más comunes que nos llegan al soporte:
¿Puedo usar el mismo usuario FTP para varias tiendas PrestaShop?
Sí, pero asegúrate de que la ruta absoluta de cada tienda apunte a su carpeta correspondiente. Si no, podrías sobrescribir archivos sin querer.
¿Qué hago si el puerto 21 está bloqueado por mi proveedor de internet?
Puedes intentar usar un puerto alternativo (como el 2106, aunque eso es para el panel Syspanel) o configurar tu cliente FTP para que use FTPS en el puerto 990. Si nada funciona, contacta con tu proveedor.
Mi conexión FTP funciona con FileZilla pero no con PrestaShop, ¿por qué?
Esto suele deberse a que PrestaShop no está configurado con el modo pasivo o a que la ruta absoluta es incorrecta. Revisa los pasos 3 y 4.
¿Es seguro dejar las credenciales FTP guardadas en PrestaShop?
Es necesario para que la tienda pueda funcionar correctamente. Asegúrate de usar una contraseña fuerte y de mantener tu instalación de PrestaShop actualizada para evitar vulnerabilidades.
Cada vez que actualizo PrestaShop, pierdo la conexión FTP, ¿qué hago?
Las actualizaciones pueden cambiar la configuración o los permisos de archivos. Vuelve a verificar la configuración FTP después de cada actualización y asegúrate de que los permisos de carpetas son los correctos (755 para carpetas, 644 para archivos).
Conclusión: Soluciona el error FTP PrestaShop en DirectAdmin paso a paso
Resolver los problemas de conexión FTP PrestaShop en DirectAdmin es cuestión de método. Como has visto, la mayoría de las soluciones son simples y no requieren conocimientos avanzados. Empieza siempre por lo más básico: las credenciales. Luego, verifica el modo pasivo y las rutas. Si el problema persiste, revisa firewalls y puertos.
[TIP] Si después de seguir todos estos pasos sigues viendo un error FTP PrestaShop, no te frustres. Contacta con tu proveedor de hosting y diles exactamente qué has probado. Con esa información, ellos podrán ayudarte mucho más rápido.
Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave en el mundo del hosting. ¡Tu tienda online estará funcionando en un abrir y cerrar de ojos!
