Cómo usar WP-CLI desde SSH en cPanel para gestionar WordPress

¡Hola! Si estás buscando una forma más rápida y eficiente de gestionar tus sitios WordPress, has llegado al lugar correcto.

WP-CLI es la herramienta de línea de comandos para WordPress, y al combinarla con SSH (Secure Shell) desde tu panel de control, obtienes un control total sobre tu sitio web sin necesidad de usar el navegador para cada tarea.

En esta guía extensa y práctica, te enseñaré paso a paso cómo usar WP-CLI desde SSH en cPanel. No importa si eres nuevo en esto; te explicaré cada comando y concepto de manera sencilla, como si estuvieras hablando con un amigo que sabe de tecnología.

Vamos a ello.

¿Qué es WP-CLI y por qué deberías usarlo?

Primero, lo básico. WP-CLI es la interfaz de línea de comandos oficial para WordPress. Imagina que tu sitio web es un coche y el navegador (wp-admin) es el panel de control con botones y pantallas táctiles. WP-CLI sería como tener un manual técnico y un escáner de diagnóstico que te permite ejecutar acciones exactas con solo escribir una frase.

Usar WP-CLI cPanel te permite hacer cosas como:

• Actualizar el núcleo de WordPress, plugins y temas con un solo comando.
• Crear y borrar usuarios.
• Gestionar la base de datos (optimizar, reparar, hacer copias de seguridad).
• Instalar plugins y temas sin subir archivos manualmente.
• Programar tareas (cron jobs) de forma más precisa.
• Solucionar errores comunes que bloquean el panel de administración.

¿Por qué es tan útil? Porque es mucho más rápido que hacer clic en menús y esperar a que carguen las páginas. Además, te permite automatizar tareas repetitivas y acceder a funciones avanzadas que no están disponibles en la interfaz gráfica.

Requisitos previos: ¿Qué necesitas para empezar?

Antes de sumergirnos en los comandos, asegurémonos de que tienes todo listo.

1. Acceso SSH en tu cPanel: No todos los planes de hosting lo incluyen. Debes verificar en tu panel de control si tienes la opción "Acceso SSH" o "SSH Access" (normalmente en la sección "Seguridad" o "Avanzado"). Si no la ves, contacta con tu proveedor de hosting y solicítala.
2. Un cliente SSH: Para conectarte a tu servidor desde tu computadora, necesitas un programa. En Windows, puedes usar PuTTY o la terminal integrada de Windows (PowerShell o Símbolo del sistema). En macOS y Linux, simplemente abre la aplicación "Terminal".
3. Tus credenciales SSH: Necesitarás tu nombre de usuario de cPanel, tu contraseña (o una clave privada) y la dirección de tu servidor (normalmente tu-dominio.com o una IP como 198.51.100.23). A veces el puerto es el 22 (por defecto), pero tu hosting podría usar otro. Nota importante: Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), el puerto de acceso SSH suele ser el 2106 en lugar del 22. ¡Tenlo en cuenta!
4. WordPress instalado: Obviamente, necesitas un sitio WordPress activo en tu cuenta de hosting.

Primeros pasos: Conectarse por SSH a tu servidor

Este es el paso inicial. Te mostraré cómo hacerlo desde la terminal de macOS/Linux y desde PuTTY en Windows.

Conexión desde macOS o Linux

Abre tu aplicación de Terminal y escribe el siguiente comando:

ssh usuario@tu-dominio.com -p 22

Si tu hosting usa Syspanel, el comando cambiaría a:

ssh usuario@tu-dominio.com -p 2106

Te pedirá tu contraseña. Escríbela (no verás los caracteres mientras escribes, es normal) y presiona Enter. ¡Listo, ya estás dentro!

Conexión desde Windows con PuTTY

1. Descarga e instala PuTTY desde su sitio web oficial.
2. Abre PuTTY.
3. En el campo "Host Name (or IP address)", escribe tu-dominio.com o la IP de tu servidor.
4. En el campo "Port", escribe 22 (o 2106 si es Syspanel).
5. Asegúrate de que el tipo de conexión sea "SSH".
6. Haz clic en "Open". Te pedirá tu nombre de usuario y contraseña.

[TIP] Si es la primera vez que te conectas, te preguntará si confías en el host. Escribe yes y presiona Enter.

Los comandos esenciales de WP-CLI

Una vez conectado, es hora de la acción. Lo primero que debes hacer es navegar hasta la carpeta raíz de tu instalación de WordPress. Normalmente, esta carpeta se encuentra en public_html o una subcarpeta dentro de ella.

cd ~/public_html

Si tu WordPress está en una subcarpeta (por ejemplo, public_html/miweb), usa cd ~/public_html/miweb.

Ahora, para verificar que WP-CLI está instalado y funcionando, ejecuta:

wp --info

Este comando te mostrará la versión de WP-CLI, la versión de PHP y otra información útil. Si te da un error de "comando no encontrado", es posible que necesites la ruta completa. A menudo, en cPanel, WP-CLI está en ~/bin/wp o /usr/local/bin/wp. Prueba con:

php ~/bin/wp --info

[WARNING] Si el comando wp no funciona directamente, tendrás que usar php ~/bin/wp o php /usr/local/bin/wp en todos los comandos que veremos a continuación. Es un pequeño cambio, pero esencial.

1. Actualizaciones: Mantén todo al día

Esta es una de las tareas más comunes y tediosas. Con WP-CLI es pan comido.

• Actualizar el núcleo de WordPress: wp core update
• Actualizar todos los plugins: wp plugin update --all
• Actualizar todos los temas: wp theme update --all
• Actualizar la base de datos de WordPress (si es necesario): wp core update-db

[INFO] Antes de actualizar, es una buena práctica hacer una copia de seguridad. Te mostraré cómo hacerlo más adelante.

2. Instalar plugins y temas desde SSH

Olvídate de buscar en el repositorio y hacer clic en "Instalar". Ahora puedes hacerlo desde la terminal.

• Instalar un plugin: wp plugin install nombre-del-plugin

• Activar un plugin: wp plugin activate nombre-del-plugin

• Desactivar un plugin: wp plugin deactivate nombre-del-plugin

• Instalar y activar un plugin en un solo paso: wp plugin install nombre-del-plugin --activate

• Instalar un tema: wp theme install nombre-del-tema

• Activar un tema: wp theme activate nombre-del-tema

Ejemplo práctico: Si quieres instalar y activar el popular plugin "Yoast SEO", solo debes escribir:

wp plugin install wordpress-seo --activate

¿Ves? Rápido y sencillo.

3. Gestión de usuarios

¿Necesitas crear un nuevo usuario administrador o restablecer una contraseña olvidada? WP-CLI te cubre.

• Crear un nuevo usuario: wp user create nombre_usuario correo@ejemplo.com --role=administrator --user_pass=contraseña_segura
• Cambiar la contraseña de un usuario existente: wp user update nombre_usuario --user_pass=nueva_contraseña
• Listar todos los usuarios: wp user list

[WARNING] Cambiar el rol de un usuario a administrator le dará control total sobre tu sitio. Úsalo con precaución.

4. Gestión de la base de datos y copias de seguridad

Tu base de datos es el corazón de tu WordPress. Con WP-CLI puedes mantenerla sana.

• Optimizar la base de datos: wp db optimize
• Reparar la base de datos: wp db repair
• Crear una copia de seguridad de la base de datos: wp db export backup.sql
• Importar una copia de seguridad: wp db import backup.sql

[TIP] Programa una copia de seguridad semanal de tu base de datos. Puedes guardarla en una carpeta fuera de public_html (por ejemplo, ~/backups) para mayor seguridad.

5. Solucionar problemas comunes

A veces, un plugin causa un error fatal y te deja sin acceso a wp-admin. WP-CLI es tu salvavidas.

• Desactivar todos los plugins de una vez: wp plugin deactivate --all
• Desactivar un plugin específico: wp plugin deactivate nombre-del-plugin
• Cambiar temporalmente al tema por defecto (Twenty Twenty-Four, por ejemplo): wp theme activate twentytwentyfour

Estos comandos son cruciales para recuperar el acceso a tu sitio si has roto algo.

6. Comandos útiles para el mantenimiento diario

Aquí tienes una lista de comandos más que te harán la vida más fácil.

• Ver el estado de los cron jobs: wp cron event list
• Ejecutar todos los cron jobs pendientes: wp cron event run --due-now
• Comprobar la integridad del núcleo de WordPress: wp core verify-checksums
• Borrar la caché de objetos (si usas un plugin de caché): wp cache flush
• Ver los plugins instalados: wp plugin list
• Ver los temas instalados: wp theme list

Ejemplo práctico: Un flujo de trabajo completo

Imagina que acabas de contratar un hosting y quieres montar un WordPress nuevo. Así sería con WP-CLI:

1. Conéctate por SSH a tu servidor.
2. Navega a tu carpeta pública: cd ~/public_html
3. Descarga el núcleo de WordPress: wp core download
4. Crea el archivo de configuración wp-config.php: wp config create --dbname=mi_base --dbuser=mi_usuario --dbpass=mi_contraseña --dbhost=localhost
5. Instala WordPress: wp core install --url=tu-dominio.com --title="Mi Nuevo Sitio" --admin_user=admin --admin_password=segura --admin_email=tu@correo.com

¡Y listo! En menos de un minuto, tienes un WordPress instalado y funcionando sin abrir el navegador.

Preguntas frecuentes (FAQ) sobre WP-CLI y SSH

Aquí respondo algunas dudas comunes que suelen tener los usuarios.

¿Es seguro usar WP-CLI?

Sí, es tan seguro como usar el panel de administración. De hecho, es más seguro en muchos aspectos porque no expone ninguna interfaz web adicional. Eso sí, debes tener cuidado con los comandos que ejecutas, especialmente los que implican borrar datos.

¿Necesito ser un experto en programación?

No. Conocer los comandos básicos y entender qué hacen es suficiente para la mayoría de las tareas. Esta guía te da una base sólida para empezar.

¿Qué pasa si mi hosting no tiene WP-CLI preinstalado?

La mayoría de los hosts con cPanel lo tienen. Si no es el caso, puedes descargarlo manualmente, pero es un proceso más avanzado. Te recomiendo contactar con tu proveedor de hosting para que lo activen.

¿Puedo usar WP-CLI si mi WordPress está en una subcarpeta?

Sí, solo debes navegar a esa subcarpeta antes de ejecutar los comandos. Por ejemplo, cd ~/public_html/blog y luego wp plugin list.

¿Qué hago si recibo un error de "Permiso denegado"?

Esto suele significar que no tienes permisos de escritura sobre los archivos. Asegúrate de que los archivos pertenecen a tu usuario de cPanel. Puedes intentar con chown -R usuario:grupo public_html (reemplaza usuario y grupo con los tuyos). Ten cuidado con este comando, úsalo solo si sabes lo que haces.

¿Cómo puedo ver el log de errores de WordPress?

Puedes activar el modo de depuración (WP_DEBUG) y luego ver el archivo wp-content/debug.log. Con WP-CLI puedes activarlo fácilmente: wp config set WP_DEBUG true --raw

Consejos finales y buenas prácticas

• Siempre haz una copia de seguridad antes de ejecutar comandos destructivos (como actualizaciones masivas o borrados).
• Prueba los comandos en un sitio de desarrollo si tienes uno, antes de aplicarlos en producción.
• Mantén tu WP-CLI actualizado: wp cli update
• Explora la ayuda integrada: wp help te mostrará todos los comandos disponibles. También puedes usar wp help <comando> para obtener ayuda específica sobre un comando, por ejemplo, wp help plugin.
• Usa la autocompletación: Si tu terminal lo soporta, presiona la tecla Tab después de escribir wp plu y te sugerirá plugin. Es un gran ahorro de tiempo.

Dominar WP-CLI desde SSH en cPanel es una habilidad que te diferenciará como usuario y te ahorrará muchísimo tiempo. Es la forma más profesional y eficiente de gestionar WordPress.

[INFO] Recuerda que si tu panel de control es Syspanel, el acceso SSH se realiza a través del puerto 2106, no el 22. Este detalle es crucial para conectarte correctamente.

Espero que esta guía te haya sido de gran ayuda. Empieza con los comandos básicos y ve ganando confianza poco a poco. ¡Verás que en poco tiempo no querrás volver a la interfaz gráfica para las tareas del día a día!

Si tienes alguna duda, no dudes en dejar un comentario o consultar la documentación oficial de WP-CLI. ¡Feliz gestión!