Cómo solucionar problemas de actualización de WordPress en DirectAdmin
Actualizar WordPress es una de las tareas más importantes para mantener tu sitio web rápido, seguro y funcional. Sin embargo, cuando gestionas tu hosting a través de un panel como DirectAdmin, a veces pueden surgir errores que bloquean el proceso de actualización.
Si estás viendo mensajes como "La actualización falló", "Descarga fallida" o "Error de conexión", no te preocupes. En esta guía extensa y práctica, voy a explicarte, paso a paso, cómo solucionar los problemas de actualización de WordPress en DirectAdmin. Vamos a ir desde lo más básico hasta soluciones más avanzadas, siempre con un lenguaje claro y sin tecnicismos innecesarios.
Primeros pasos: Diagnóstico rápido del error de actualización
Antes de lanzarnos a tocar archivos o bases de datos, es fundamental entender por qué falla la actualización. En la mayoría de los casos, el problema no es de WordPress en sí, sino del entorno del servidor o de los permisos de los archivos.
Cuando intentas actualizar WordPress desde el escritorio (el panel de administración), el sistema necesita hacer tres cosas:
- Conectarse a los servidores de WordPress.org para descargar el paquete de actualización.
- Descomprimir ese paquete en tu servidor.
- Sobrescribir los archivos antiguos con los nuevos.
Si falla cualquiera de estos pasos, verás un error. Los más comunes son:
- "Descarga fallida": Indica un problema de conexión saliente (el servidor no puede salir a internet) o un bloqueo de firewall.
- "El enlace de descarga ha caducado": Suele ser un problema temporal de los servidores de WordPress.
- "No se pudo conectar a WordPress.org": Similar al primero, pero específico de la conexión SSL.
- "Error al copiar algunos archivos": Esto es casi siempre un problema de permisos de archivos o de propiedad de los ficheros.
[INFO] La clave está en leer el mensaje de error completo. A veces, WordPress te dice exactamente qué archivo no se pudo copiar. Anota ese dato, te será útil más adelante.
Solución 1: Ajustar los permisos de archivos y carpetas (La causa más común)
Este es el primer lugar donde debes mirar. En un servidor con DirectAdmin, los archivos de tu sitio web pertenecen a un usuario específico (tu usuario de hosting). Si los permisos no son los correctos, WordPress no puede escribir ni modificar sus propios archivos.
¿Cómo hacerlo en DirectAdmin?
- Accede a tu panel de DirectAdmin.
- Busca la sección "Administrador de Archivos" (File Manager). Normalmente está en la pestaña "Archivos" o "Administración de archivos".
- Navega hasta la carpeta
public_html(o la carpeta donde esté instalado tu WordPress). - Selecciona todos los archivos y carpetas de la instalación de WordPress (puedes usar Ctrl+A para seleccionar todo).
- Haz clic en el botón "Cambiar permisos" (o "Chmod") en la barra superior.
- Aquí es donde viene la regla de oro:
- Carpetas (Directorios): Deben tener permiso 755 (Lectura, Escritura y Ejecución para el propietario; Lectura y Ejecución para el grupo y otros).
- Archivos: Deben tener permiso 644 (Lectura y Escritura para el propietario; Lectura para el grupo y otros).
[WARNING] No pongas permisos 777 (todos pueden escribir) en todos los archivos. Es un riesgo de seguridad grave y puede hacer que tu sitio sea hackeado. Usa 755 y 644.
Proceso paso a paso en File Manager:
- En el administrador de archivos, marca la casilla para seleccionar todo.
- Haz clic en "Configuración" o "Permisos".
- En el cuadro de diálogo, marca las casillas para que queden así:
- Usuario (Owner): Lectura, Escritura y Ejecución.
- Grupo (Group): Lectura y Ejecución.
- Otros (Public): Lectura y Ejecución.
- Aplica los cambios.
Después de esto, intenta actualizar WordPress de nuevo. En muchos casos, este simple ajuste resuelve el problema de inmediato.
Solución 2: Cambiar el método de conexión FTP en wp-config.php
A veces, WordPress intenta usar FTP para actualizarse, lo cual es innecesario y suele fallar si no has configurado las credenciales FTP en el archivo de configuración. La solución es forzar a WordPress a usar el sistema de archivos directo del servidor.
¿Cómo se hace?
Necesitas editar el archivo wp-config.php que está en la raíz de tu instalación (dentro de public_html).
- Ve al Administrador de Archivos de DirectAdmin.
- Localiza el archivo
wp-config.phpen la raíz. - Haz clic derecho sobre él y selecciona "Editar" (o "Code Editor").
- Busca la línea que dice
define('WP_DEBUG', false);o similar. Justo antes de la línea que dice/* ¡Eso es todo, deja de editar! */, añade la siguiente línea:
define('FS_METHOD', 'direct');
- Guarda el archivo.
[TIP] Esta línea le dice a WordPress: "No uses FTP, escribe los archivos directamente en el disco duro". Es la solución más efectiva para muchos errores de actualización en entornos de hosting compartido.
Solución 3: Verificar la memoria PHP asignada (Límite de memoria)
Las actualizaciones de WordPress consumen mucha memoria PHP, especialmente si tienes muchos plugins o un sitio grande. Si el límite de memoria es demasiado bajo, la actualización fallará a mitad de camino.
¿Cómo aumentar el límite de memoria?
Tienes dos opciones:
Opción A: Desde el archivo wp-config.php (Recomendado)
Añade esta línea al mismo archivo wp-config.php que mencionamos antes:
define('WP_MEMORY_LIMIT', '256M');
Opción B: Desde el archivo .htaccess
Este archivo también está en la raíz. Añade estas líneas al principio del archivo:
php_value memory_limit 256M
[INFO] Si no tienes un archivo .htaccess, puedes crearlo desde el Administrador de Archivos. Asegúrate de que el nombre empiece con un punto (.htaccess).
Después de hacer este cambio, vuelve a intentar la actualización.
Solución 4: Desactivar temporalmente el firewall o el ModSecurity
DirectAdmin suele venir con ModSecurity (un firewall de aplicaciones web) activado. A veces, este firewall confunde las peticiones de actualización de WordPress con ataques maliciosos y las bloquea.
¿Cómo comprobarlo?
- En tu panel de DirectAdmin, busca la sección de "Protección" o "Seguridad".
- Busca la opción de "ModSecurity".
- Puedes desactivarlo solo para tu dominio (o para la carpeta de WordPress) de forma temporal.
[WARNING] Desactivar ModSecurity de forma permanente no es recomendable, ya que deja tu sitio más vulnerable. Úsalo solo como prueba para ver si ese es el problema. Si lo es, considera añadir una regla específica para permitir las actualizaciones de WordPress en lugar de desactivarlo por completo.
Solución 5: Comprobar la versión de PHP
WordPress recomienda usar una versión de PHP moderna (7.4 o superior, idealmente 8.1 o 8.2). Si estás usando una versión muy antigua (como PHP 5.6), las actualizaciones pueden fallar porque los nuevos archivos de WordPress ya no son compatibles.
¿Cómo cambiar la versión de PHP en DirectAdmin?
- En DirectAdmin, busca "Administrador de PHP" o "PHP Version Selector".
- Selecciona tu dominio.
- Elige una versión de PHP más reciente de la lista desplegable (ej. "PHP 8.2").
- Guarda los cambios.
[INFO] Si no ves el selector de PHP, es posible que tu plan de hosting no lo incluya o que necesites contactar con tu proveedor para que lo habilite.
Solución 6: Aumentar el tiempo de ejecución máximo (Max Execution Time)
Si tu sitio es lento o tiene muchos recursos, la actualización puede tardar más de lo que el servidor permite (normalmente 30 o 60 segundos). Si se agota el tiempo, el proceso se corta.
¿Cómo aumentarlo?
- Desde
.htaccess: Añade esta línea:
php_value max_execution_time 300
- Desde
wp-config.php: Añade esta línea (aunque es menos efectiva que la anterior):
set_time_limit(300);
Esto le da a PHP 300 segundos (5 minutos) para completar la tarea.
Solución 7: Actualizar manualmente por FTP o File Manager
Si todas las soluciones anteriores fallan, la opción más "a prueba de balas" es hacer la actualización manualmente. Esto implica descargar WordPress, subirlo a tu servidor y sobrescribir los archivos.
Pasos para la actualización manual:
- Descarga la última versión de WordPress desde
es.wordpress.org(un archivo.zip). - Descomprime el archivo en tu ordenador. Obtendrás una carpeta llamada
wordpress. - Accede a tu DirectAdmin y abre el Administrador de Archivos.
- Sube el archivo
.zipa tu carpetapublic_html(o a la carpeta donde tengas WordPress). - Una vez subido, haz clic derecho sobre el archivo
.zipy selecciona "Extraer" (Extract). - El sistema te preguntará si quieres sobrescribir los archivos existentes. Acepta.
- Cuando termine, borra el archivo
.zipdel servidor.
[WARNING] Este método manual no toca tu base de datos, así que tu contenido (posts, páginas, comentarios) está a salvo. Sin embargo, asegúrate de que la versión que subes es más reciente que la que tienes instalada. Si tienes dudas, haz una copia de seguridad de la base de datos antes de empezar.
Solución 8: Comprobar el espacio en disco
Parece obvio, pero a veces el disco duro del servidor está lleno. Si no hay espacio, la descarga o extracción de archivos falla.
¿Cómo comprobarlo?
- En DirectAdmin, mira el panel principal o busca "Uso de disco".
- Si estás al 100%, tendrás que liberar espacio (borrar copias de seguridad antiguas, logs, etc.).
Preguntas Frecuentes (FAQ) sobre errores de actualización
Aquí respondo a las dudas más comunes que nos llegan al soporte técnico sobre este tema.
¿Por qué me pide credenciales FTP cuando intento actualizar?
Esto ocurre porque WordPress no tiene acceso directo al sistema de archivos. La solución es exactamente la de la Solución 2: añadir define('FS_METHOD', 'direct'); a tu wp-config.php.
¿Qué significa el error "El enlace de descarga ha caducado"?
Es un error temporal. Los servidores de WordPress.org a veces están saturados. Espera 10-15 minutos y vuelve a intentarlo. Si persiste, revisa la conexión saliente de tu servidor (Solución 1 o contacta con tu proveedor).
¿Puedo actualizar WordPress si he modificado algún archivo del núcleo?
Si has editado archivos como wp-login.php o wp-settings.php, la actualización fallará. WordPress detecta que los archivos han sido modificados y no los sobrescribe para no romper tu web. La solución es revertir esos archivos a su estado original (descargando una copia limpia de WordPress y sobrescribiendo solo esos archivos modificados).
Si uso Syspanel (antes conocido como HestiaCP) con puerto 2106, ¿cambia algo?
El procedimiento es muy similar, pero la interfaz cambia. En Syspanel, la gestión de archivos y permisos se hace desde el Administrador de Archivos que encontrarás en el puerto 2106. La lógica es la misma: ajusta permisos a 755/644 y usa el mismo truco del FS_METHOD. La diferencia principal es que en Syspanel, el selector de PHP suele estar en "Configuración del servidor" o "PHP".
¿Qué hago si nada de esto funciona?
Si has probado todos los pasos anteriores y sigues con el error de actualización, el problema puede ser más profundo en la configuración del servidor. En ese caso, te recomiendo:
- Contactar con tu proveedor de hosting y explicarles el error exacto. Ellos pueden revisar los logs del servidor.
- Revisar los logs de error de PHP en DirectAdmin (suele estar en la sección "Registros" o "Logs"). Busca la carpeta
error_logdentro depublic_html. El error exacto te dará la pista final.
Consejos finales para evitar futuros problemas
Para que la próxima actualización sea un paseo, te dejo estos consejos:
- Haz copias de seguridad: Antes de cualquier actualización, usa la herramienta de copia de seguridad de DirectAdmin o un plugin como UpdraftPlus. Nunca sabes cuándo la necesitarás.
- Actualiza primero los plugins y temas: Es más seguro actualizar los plugins y temas antes que el núcleo de WordPress. Así, si algo falla, sabrás que es por un plugin y no por el núcleo.
- Mantén un entorno limpio: No acumules plugins innecesarios. Cada plugin añade complejidad y puede causar conflictos durante las actualizaciones.
- Considera usar un staging site: Si tu sitio es crítico, crea un entorno de pruebas (staging) desde tu panel de hosting. Ahí puedes probar la actualización sin miedo a romper el sitio en producción.
Espero que esta guía extensa te haya sido de gran ayuda. La mayoría de los problemas de actualizar WordPress en DirectAdmin se resuelven con los permisos de archivos y el ajuste del FS_METHOD. Si sigues estos pasos, podrás mantener tu WordPress siempre al día, seguro y funcionando a la perfección. ¡Mucha suerte con tu actualización!
