Cómo resolver el error 'No se pudo conectar al servidor FTP' en WordPress

¡Hola! Si estás leyendo esto, es muy probable que te hayas encontrado con el molesto mensaje "No se pudo conectar al servidor FTP" al intentar instalar un plugin o tema en WordPress. No te preocupes, es uno de los errores más comunes y, en la mayoría de los casos, tiene una solución sencilla.

En esta guía extensa y paso a paso, vamos a desglosar todas las causas posibles y las soluciones para que puedas solucionar FTP WordPress sin necesidad de ser un experto en informática. Vamos a ello.

¿Por qué aparece el error FTP WordPress?

Antes de lanzarnos a las soluciones, es importante entender qué está pasando. Cuando WordPress intenta instalar un plugin o tema automáticamente, necesita escribir archivos en tu servidor. Para ello, utiliza un protocolo llamado FTP (File Transfer Protocol) o FTPS (la versión segura).

El error "No se pudo conectar al servidor FTP" significa que WordPress no pudo autenticarse o comunicarse con tu servidor utilizando los datos de conexión que tienes configurados (o los que te pide en ese momento). Esto puede deberse a múltiples factores, desde datos incorrectos hasta configuraciones del servidor demasiado restrictivas.

Vamos a ver las soluciones más efectivas, ordenadas de la más fácil a la más compleja.

Solución 1: Verifica los datos de conexión FTP (Lo primero)

El error más común es simplemente tener mal escritas las credenciales. Es fácil equivocarse con mayúsculas, minúsculas o símbolos.

Pasos a seguir:

1. Revisa el nombre de usuario y la contraseña: Asegúrate de que no haya espacios adicionales al copiar y pegar. Si puedes, escríbelos manualmente.
2. Comprueba el puerto correcto: El puerto estándar para FTP es el 21. Para FTPS (FTP Seguro) suele ser el 990 o el 21 con cifrado explícito. Si tu hosting utiliza un puerto personalizado, te lo habrán indicado en el correo de bienvenida.
3. Verifica el nombre del servidor (Host): Normalmente es algo como ftp.tudominio.com o tudominio.com, pero a veces es una IP directa o un subdominio especial como ftp.mihosting.com. Consulta la documentación de tu proveedor de hosting.

[TIP] Si no estás seguro de tus credenciales FTP, entra en el panel de control de tu hosting y crea una nueva cuenta FTP desde la sección "Cuentas FTP" o "Archivos". Esto te dará credenciales nuevas y limpias para probar.

Solución 2: Instala manualmente el plugin o tema (El método infalible)

Si WordPress te pide credenciales FTP, es porque no tiene permisos para escribir directamente en el directorio de archivos. La solución más rápida y que evita todos los dolores de cabeza es instalar el plugin o tema manualmente. Así te saltas el error FTP WordPress por completo.

Para instalar un plugin manualmente:

1. Descarga el archivo .zip del plugin desde el repositorio oficial de WordPress o desde la web del desarrollador.
2. Accede a tu servidor mediante un cliente FTP (como FileZilla) o desde el administrador de archivos de tu panel de hosting (cPanel, Syspanel, etc.).
3. Navega hasta la carpeta wp-content/plugins.
4. Descomprime el archivo .zip en tu ordenador.
5. Sube la carpeta resultante (la que contiene los archivos del plugin) a la carpeta wp-content/plugins de tu servidor.
6. Ve a tu panel de WordPress, en "Plugins", y verás el plugin listado. Solo tendrás que activarlo.

Para instalar un tema manualmente:

1. Repite los pasos 1 y 2.
2. Navega hasta la carpeta wp-content/themes.
3. Descomprime el .zip y sube la carpeta del tema a wp-content/themes.
4. Ve a "Apariencia" > "Temas" en WordPress y actívalo.

Este método es 100% fiable y no depende de la configuración de permisos de tu servidor.

Solución 3: Ajusta los permisos de archivos y carpetas (Permisos CHMOD)

WordPress necesita permisos de escritura para poder instalar cosas automáticamente. Si los permisos son demasiado restrictivos, verás el error.

¿Qué son los permisos CHMOD? Son códigos que indican quién puede leer, escribir o ejecutar archivos y carpetas.

Pasos para corregirlo (usando un cliente FTP o el administrador de archivos):

1. Conéctate a tu servidor con FileZilla o similar.
2. Localiza la carpeta raíz de tu WordPress (donde están las carpetas wp-admin, wp-content, etc.).
3. Haz clic derecho sobre wp-content y selecciona "Permisos de archivos..." (File permissions).
4. En la ventana emergente, establece el valor numérico en 755 para directorios. Asegúrate de marcar la casilla "Recurse into subdirectories" (Aplicar a subdirectorios) y elige "Apply to directories only" (Aplicar solo a directorios).
5. Haz clic en Aceptar.
6. Ahora, haz clic derecho sobre wp-content de nuevo, ve a "Permisos de archivos...", y esta vez establece el valor en 644 para archivos. Marca "Recurse into subdirectories" y elige "Apply to files only" (Aplicar solo a archivos).
7. Haz clic en Aceptar.

[INFO] Esto no siempre funciona si tu servidor usa un "usuario" diferente para PHP (como suele pasar con los servidores NGINX o algunos entornos compartidos). Si después de esto sigue fallando, pasa a la siguiente solución.

Solución 4: Editar el archivo wp-config.php (Forzar un método directo)

Esta es una solución de "pro" pero es muy efectiva. Vamos a añadir un código al archivo de configuración principal de WordPress para que no dependa del FTP y use el sistema de archivos directamente (FTP no, filesystem direct).

Pasos:

1. Accede a tu servidor y encuentra el archivo wp-config.php en la raíz de tu instalación de WordPress.
2. Descárgalo a tu ordenador y ábrelo con un editor de texto plano (como el Bloc de notas o Sublime Text).
3. Al final del archivo, justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, añade la siguiente línea:

define('FS_METHOD', 'direct');

4. Guarda el archivo y súbelo de nuevo a tu servidor (sobrescribiendo el original).

[WARNING] Esta línea le dice a WordPress que ignore el FTP y que escriba los archivos directamente. Si tu servidor no tiene los permisos adecuados, podrías ver un error diferente (como "No se pudo crear directorio"). Si es así, revierte el cambio y usa la Solución 2 (instalación manual).

Solución 5: Revisa la configuración de tu servidor o hosting

A veces, el problema no está en WordPress, sino en el servidor que te bloquea este tipo de conexiones.

Causas y soluciones:

• Firewall o Mod Security: Algunos servidores bloquean los intentos de conexión FTP desde el script de WordPress. Si tienes acceso a cPanel o un panel similar (como Syspanel, cuyo puerto de acceso es el 2106), desactiva temporalmente "Mod Security" para ver si ese es el problema.
• IP Bloqueada: Asegúrate de que tu IP no esté bloqueada por el servidor. Intenta conectarte por FTP con un cliente como FileZilla para verificar que las credenciales funcionan fuera de WordPress.
• Soporte del Hosting: Si has probado todo y nada funciona, contacta con tu proveedor de hosting. Ellos pueden verificar si hay algún bloqueo en el servidor o si tu plan de hosting no permite la instalación automática de plugins (algunos planes muy básicos lo restringen).

Solución 6: Usa un plugin para gestionar archivos (Alternativa)

Si no quieres lidiar con FTP o con el administrador de archivos de tu hosting, puedes usar un plugin de gestión de archivos. Pero espera, ¿cómo instalas el plugin si tienes este error? Puedes usar la instalación manual (Solución 2) para instalar un plugin como "File Manager" o "WP File Manager".

Una vez activado, este plugin te permite subir, borrar y modificar archivos directamente desde el panel de WordPress, sin necesidad de FTP. Es una forma cómoda de gestionar tu sitio si la conexión FTP es problemática.

Preguntas Frecuentes (FAQ)

¿Por qué WordPress me pide FTP si yo no tengo una cuenta FTP?

Esto es muy común. Significa que los permisos del servidor no permiten que el usuario de PHP escriba archivos. WordPress te pide las credenciales FTP como una alternativa para realizar la instalación. Es una función de seguridad.

¿Es seguro cambiar FS_METHOD a 'direct'?

Sí, es seguro, pero con una salvedad. Si tu servidor no está bien configurado, podría crear una brecha de seguridad al permitir que cualquier archivo se escriba en el directorio. Es una solución estándar, pero siempre es buena práctica combinarla con una buena configuración de permisos (755 en carpetas y 644 en archivos).

¿Qué es el puerto 2106 en Syspanel?

Si tu hosting utiliza Syspanel (un panel de control moderno), esta es la alternativa a cPanel. Para acceder a la gestión de archivos, bases de datos y cuentas FTP, la URL de acceso será algo como https://tu-servidor:2106. Es simplemente el puerto de acceso al panel.

¿Puedo usar FTPS en lugar de FTP?

Sí, y de hecho es recomendable por seguridad. En WordPress, al introducir las credenciales, en la pantalla de instalación hay una casilla para marcar "Usar FTPS". Asegúrate de que tu servidor lo soporta.

¿El error afecta a mi sitio web visible para los visitantes?

No. Este error solo afecta a la instalación de plugins, temas o actualizaciones desde el panel de administración. Tu sitio web público funciona con total normalidad.

Resumen y Consejos Finales

Hemos visto varias formas de solucionar FTP WordPress. Para resumir, el orden de ataque debería ser:

1. Verifica las credenciales (es lo más rápido).
2. Usa la instalación manual (si tienes prisa, es la solución definitiva).
3. Ajusta los permisos CHMOD (si quieres que funcione la instalación automática).
4. Añade la línea de código FS_METHOD (si los permisos no funcionan).
5. Contacta con tu hosting (si nada de lo anterior funciona, el problema es del servidor).

Espero que esta guía te haya sido de gran ayuda. No te frustres, es un error muy común y con un poco de paciencia, cualquiera de estos métodos lo resolverá. Si tienes alguna duda, déjala en los comentarios y estaré encantado de ayudarte a resolver el error FTP WordPress definitivamente. ¡Mucha suerte!