Error FTP en WordPress: causas y soluciones | Guía práctica

¡Hola! Soy el soporte técnico de tu hosting. Si estás viendo el molesto error "Failed to connect to FTP" en WordPress, no te preocupes. Es uno de los problemas más comunes, y casi siempre tiene una solución sencilla. Vamos a desglosarlo paso a paso, como si estuviéramos al teléfono.

Este error suele aparecer cuando intentas instalar un plugin, un tema o actualizar WordPress, y el sistema te pide las credenciales FTP. A veces, incluso cuando ya las has introducido, el proceso falla. La causa principal es que WordPress no puede comunicarse correctamente con el servidor para escribir archivos.

Aquí te explicaré qué significa exactamente este error, por qué ocurre y, lo más importante, cómo solucionarlo de forma definitiva. Hablaremos de los WordPress permisos archivos, de cómo configurar correctamente las WordPress FTP credentials y de otros trucos para solucionar FTP WordPress de una vez por todas.

¿Por qué aparece el error 'Failed to connect to FTP'?

Antes de lanzarnos a las soluciones, es bueno entender por qué ocurre. Piensa en FTP como un mensajero. Cuando WordPress quiere instalar algo nuevo, necesita que ese mensajero (FTP) lleve los archivos al servidor. Si el mensajero no tiene la dirección correcta, la contraseña equivocada o el servidor le cierra la puerta, el mensaje no llega y aparece el error.

Las razones más habituales son:

Credenciales FTP incorrectas: El usuario, la contraseña, el host o el puerto no son los correctos.
Puerto de conexión equivocado: El puerto por defecto (21) puede estar bloqueado por tu firewall o por el servidor.
Problemas con el cortafuegos (Firewall): Tu ordenador o la red pueden estar bloqueando la conexión FTP.
Permisos de archivos incorrectos: WordPress no tiene permisos para escribir en las carpetas donde necesita instalar cosas. Esto es clave en los WordPress permisos archivos.
El servidor FTP no está activo: A veces, el servicio FTP en tu hosting está desactivado o caído.
Modo pasivo vs. activo: WordPress a veces necesita usar un modo de conexión específico (pasivo) que no está configurado.
Uso de FTPS (FTP Seguro): Algunos servidores exigen una conexión cifrada (FTP sobre SSL/TLS), y si no la configuras, falla.

Soluciones paso a paso para el error FTP en WordPress

Vamos a ir de lo más simple a lo más técnico. No te saltes pasos, empieza por el primero.

1. Verifica tus credenciales FTP (Lo básico)

Este es el paso más obvio, pero a veces el que más se nos pasa. Asegúrate de tener los datos correctos.

Host (Servidor): Normalmente es tu dominio (ej. tudominio.com) o una IP (ej. 192.168.1.1). En muchos casos, especialmente si usas Syspanel, el host es tu dominio. Si no estás seguro, mira el correo de bienvenida de tu hosting o pregunta al soporte.
Nombre de usuario: El usuario FTP que creaste en el panel de control. No es lo mismo que tu usuario de WordPress.
Contraseña: La contraseña de ese usuario FTP. Cuidado con las mayúsculas y minúsculas.
Puerto: El puerto estándar es el 21. Pero si usas Syspanel, el puerto de acceso para FTP es el 2106. Este es un detalle importante que mucha gente olvida.

[TIP] Si usas Syspanel, recuerda que el puerto FTP es el 2106, no el 21. Es un error muy común.

¿Cómo verificarlo? Usa un cliente FTP como FileZilla. Intenta conectar con esos datos. Si FileZilla te da error, entonces el problema está en las credenciales o en el servidor, no en WordPress. Si FileZilla conecta bien, entonces el problema es de configuración dentro de WordPress.

2. Configura el modo de conexión FTP en WordPress (Modo Pasivo)

A veces, el firewall del servidor bloquea las conexiones FTP activas. WordPress permite forzar el modo pasivo, que suele funcionar mejor.

Para ello, añade una línea de código al archivo wp-config.php. Este archivo está en la raíz de tu instalación de WordPress (normalmente en la carpeta public_html o www).

Conéctate a tu servidor vía FTP (con FileZilla, por ejemplo) o usa el administrador de archivos de tu panel de control (como Syspanel).
Busca el archivo wp-config.php.
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */, añade esta línea:
```
define('FTP_PASSIVE', true);
```
Guarda el archivo y vuelve a intentar la instalación o actualización en WordPress.

[INFO] Esta línea le dice a WordPress "usa siempre el modo pasivo para conectarte por FTP". Es una de las soluciones más efectivas.

3. Establece los permisos de archivos correctos

Los WordPress permisos archivos son fundamentales. Si están mal configurados, WordPress no podrá escribir ni modificar archivos, y te pedirá las credenciales FTP constantemente o dará error.

La configuración ideal es:

Carpetas (directorios): Permisos 755 (lectura y ejecución para todos, escritura solo para el usuario).
Archivos: Permisos 644 (lectura para todos, escritura solo para el usuario).

¿Cómo cambiarlos?

Opción 1: Desde un cliente FTP (FileZilla).
1. Conéctate a tu servidor.
2. Selecciona la carpeta raíz de WordPress (normalmente public_html).
3. Haz clic derecho > "Permisos de archivo...".
4. Marca las casillas para 755 y asegúrate de marcar "Recurse into subdirectories" y "Apply to directories only". Dale a Aceptar.
5. Repite el proceso, pero esta vez selecciona "Apply to files only" y pon permisos 644.
Opción 2: Desde el panel de control (Syspanel).
1. Accede a Syspanel (puerto 2106).
2. Ve a "Administrador de Archivos".
3. Navega hasta la carpeta raíz de WordPress.
4. Selecciona todos los archivos y carpetas (Ctrl+E o selección manual).
5. Haz clic en "Permisos" (o "Chmod").
6. Pon 755 para las carpetas y 644 para los archivos. Algunos paneles lo hacen automáticamente.

[WARNING] No pongas permisos 777 a ninguna carpeta o archivo. Es un grave riesgo de seguridad. Con 755 y 644 es más que suficiente.

4. Desactiva la petición de credenciales FTP (Solución avanzada)

Si ya has configurado todo correctamente y el error persiste, podemos "engañar" a WordPress para que no pida las credenciales FTP. Esto se hace definiendo las constantes de conexión directamente en el wp-config.php.

Este método es útil cuando el servidor tiene configurado correctamente los permisos pero WordPress sigue pidiendo FTP. Al definir las constantes, WordPress usará el usuario del servidor (el que ejecuta PHP) para escribir archivos directamente, sin pasar por FTP.

Añade estas líneas a tu wp-config.php, justo antes de la línea de cierre (/* That's all... */):

define('FS_METHOD', 'direct');
define('FTP_BASE', '/ruta/absoluta/a/tu/wordpress');
define('FTP_CONTENT_DIR', '/ruta/absoluta/a/tu/wordpress/wp-content');
define('FTP_PLUGIN_DIR', '/ruta/absoluta/a/tu/wordpress/wp-content/plugins');
define('FTP_THEMES_DIR', '/ruta/absoluta/a/tu/wordpress/wp-content/themes');

¿Cómo saber la ruta absoluta?

En Syspanel, ve a "Administrador de Archivos".
En la parte superior, verás la ruta (ej. /home/usuario/public_html).
Copia esa ruta y pégala donde dice /ruta/absoluta/a/tu/wordpress.

Ejemplo real:

Si tu ruta es /home/midominio/public_html, el código quedaría así:

define('FS_METHOD', 'direct');
define('FTP_BASE', '/home/midominio/public_html');
define('FTP_CONTENT_DIR', '/home/midominio/public_html/wp-content');
define('FTP_PLUGIN_DIR', '/home/midominio/public_html/wp-content/plugins');
define('FTP_THEMES_DIR', '/home/midominio/public_html/wp-content/themes');

[INFO] Al definir FS_METHOD como 'direct', le decimos a WordPress "no uses FTP, escribe los archivos directamente con el usuario del servidor". Esto solo funciona si los permisos de archivos son correctos.

5. Comprueba si tu hosting bloquea FTP o usa FTPS

Algunos hosts, por seguridad, deshabilitan el FTP estándar o exigen una conexión segura (FTPS).

FTPS: Si tu hosting te proporciona credenciales FTPS, en WordPress puedes configurarlo añadiendo estas líneas al wp-config.php:
```
define('FTP_SSL', true);
```
SFTP (SSH): Es diferente al FTP. Si tu hosting solo permite SFTP, la solución anterior (definir FS_METHOD como 'direct') suele funcionar, ya que SFTP no es compatible directamente con WordPress de forma nativa.

[TIP] Pregunta a tu soporte técnico si el FTP estándar está activo o si necesitas usar FTPS o SFTP. En Syspanel, el FTP estándar en el puerto 2106 suele estar siempre disponible.

6. Solución temporal: Instalar plugins/temas manualmente

Si todo lo anterior falla y necesitas instalar algo urgentemente, puedes hacerlo de forma manual. Así evitas el error FTP por completo.

Descarga el plugin o tema desde wordpress.org o la fuente oficial.
Descomprime el archivo .zip en tu ordenador.
Conéctate a tu servidor vía FTP o usa el Administrador de Archivos de Syspanel.
Sube la carpeta del plugin a wp-content/plugins/ o la carpeta del tema a wp-content/themes/.
Vuelve a tu escritorio de WordPress y activa el plugin o tema desde el menú "Plugins" o "Apariencia > Temas".

Este método es infalible, pero es más lento si tienes que hacerlo con frecuencia.

Preguntas Frecuentes (FAQ)

P: ¿Por qué WordPress me pide usuario y contraseña FTP si ya estoy logueado en el admin?
R: Porque WordPress no tiene permisos de escritura en el servidor. El usuario de WordPress (admin) es diferente al usuario del sistema (FTP). Al pedirte FTP, WordPress intenta usar otro usuario con más permisos para escribir archivos.

P: ¿Qué hago si no recuerdo mi contraseña FTP?
R: Puedes cambiarla desde el panel de control de tu hosting. En Syspanel, ve a "Usuarios FTP" y restablece la contraseña. También puedes crear un nuevo usuario FTP.

P: He puesto FS_METHOD como 'direct' y ahora mi web da error 500.
R: Esto suele pasar si la ruta absoluta en FTP_BASE es incorrecta. Revísala con cuidado. Si no estás seguro, comenta las líneas que añadiste (poniendo // al principio de cada una) y la web volverá a la normalidad.

P: El error solo me pasa con un plugin específico, ¿por qué?
R: Algunos plugins mal codificados o muy pesados pueden tener problemas con los límites de memoria o tiempo de ejecución de PHP. Prueba a aumentar el límite de memoria en el wp-config.php añadiendo: define('WP_MEMORY_LIMIT', '256M');.

P: Uso Syspanel y el puerto 2106 no me funciona.
R: Asegúrate de que en tu cliente FTP (FileZilla) estás usando "FTP - File Transfer Protocol" (no SFTP) y el puerto 2106. Si aún así falla, contacta al soporte de Syspanel, podría haber un bloqueo temporal.

Resumen final

El error "Failed to connect to FTP" es frustrante, pero rara vez es un problema grave. Siguiendo estos pasos en orden, lo solucionarás casi con total seguridad:

Verifica credenciales (¡y el puerto 2106 en Syspanel!).
Activa el modo pasivo en wp-config.php.
Corrige los permisos de archivos a 755/644.
Define FS_METHOD como 'direct' con la ruta absoluta correcta.
Si nada funciona, instala manualmente lo que necesites.

Y recuerda, si en algún momento te sientes perdido, el soporte técnico de tu hosting (especialmente si usas Syspanel) está para ayudarte. ¡No dudes en abrir un ticket!