Incluye KPanel una consola de WP-CLI que ejecuta comandos contra su sitio de WordPress desde el navegador, sin cliente SSH y sin inicio de sesión en el servidor. Esta guía explica dónde encontrarla, exactamente qué comandos están permitidos y por qué, los atajos integrados en la pantalla, y qué hacer cuando necesita algo que la consola no ejecutará.
Abrir la consola
- Inicie sesión en KPanel y haga clic en Sitios web en la barra lateral izquierda.
- Haga clic en su sitio de WordPress.
- Abra la pestaña WordPress y luego la sección Console.
La entrada ya empieza con un wp fijo, de modo que usted solo escribe lo que viene después. plugin list, no wp plugin list. Presione Enter o haga clic en Run.
Console es una de las secciones que aparecen en los planes gestionados. En otros planes, la franja de pestañas termina con un enlace +8 on Managed en su lugar. Toda acción descrita aquí que no sea un comando sin procesar tiene un botón equivalente en otra parte de KPanel, de modo que nada queda fuera de alcance: la consola es una forma más rápida de llegar al mismo motor.
Los comandos se ejecutan como el propio usuario del sistema de su sitio, dentro del directorio de su sitio. No pueden ver ni tocar ningún otro sitio.
Lo que la consola ejecutará y no ejecutará
La consola usa una lista de permitidos. Solo se aceptan los prefijos de comando que se indican a continuación, y cualquier otro se rechaza antes de llegar al servidor, con un mensaje que indica el comando que se rechazó.
| Área | Permitido |
|---|---|
| Núcleo | core version, core check-update, core update, core is-installed, core verify-checksums |
| Plugins | plugin list, plugin update, plugin install, plugin activate, plugin deactivate, plugin status, plugin get, plugin delete, plugin verify-checksums |
| Temas | theme list, theme update, theme install, theme activate, theme status, theme get, theme delete |
| Usuarios | user list, user get, user create, user update, user set-role, user delete, user reset-password, user add-cap, user remove-cap, user generate |
| Base de datos | db size, db tables, db optimize, db repair, db check |
| Caché y transitorios | cache flush, cache get, cache set, cache add, cache delete, transient get, transient set, transient delete |
| Reglas de reescritura | rewrite flush, rewrite list, rewrite structure |
| Cron | cron event list, cron event run, cron schedule list |
| Configuración | config get, config list, config has, config shuffle-salts |
| Modo de mantenimiento | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| Inspección de solo lectura | option get, option list, post list, post get, comment list, comment get |
| Medios e idioma | media regenerate, language core install, language core update |
| Buscar y reemplazar | search-replace |
Las exclusiones deliberadas importan más que las inclusiones:
evalyshellestán bloqueados. PHP arbitrario y shell arbitrario harían que la consola equivaliera a un acceso root en una pestaña del navegador.db import,db export,db drop,db queryydb resetestán bloqueados. Importar y restablecer destruyen una base de datos sin ningún paso de confirmación;db queryes un prompt SQL sin restricciones. Use phpMyAdmin en su lugar: Acceder a su base de datos con phpMyAdmin.config setyconfig deleteestán bloqueados. Una escritura incorrecta dewp-config.phpdeja el sitio fuera de línea. Lea los valores aquí y cámbielos a través del gestor de archivos.option updateyoption deleteestán bloqueados. Editar opciones a ciegas es una forma común de romper un sitio sin posibilidad de recuperación.
La consola no realiza ninguna copia de seguridad por usted, en ningún comando. Solo los botones de la sección Acciones rápidas lo hacen. Antes de search-replace, core update, plugin update, theme update, db optimize o db repair, realice usted mismo una copia de seguridad desde la página Copias de seguridad del sitio. Consulte Realizar una copia de seguridad.
Trabajar en la consola
La pantalla hace más que aceptar un comando a la vez.
Botones predefinidos. Sobre el prompt se encuentran atajos agrupados: Rendimiento (vaciar caché, limpiar transitorios, vaciar reescrituras, comprobación de autoload), Base de datos (optimizar, comprobar, reparar, tamaño), Diagnóstico (versión de WP, comprobar actualizaciones, verificar núcleo, eventos de cron), Contenido (listar plugins, temas, usuarios, ejecutar cron ahora), Seguridad (usuarios administradores, checksums de plugins, restablecer salts, wp-config) y Mantenimiento (activar y desactivar el modo de mantenimiento, regenerar miniaturas, estado). Un clic ejecuta el comando.
Historial. Presione las flechas arriba y abajo en el prompt para desplazarse por sus últimos 50 comandos en este sitio.
Fragmentos. Haga clic en el icono de marcador junto a un comando para guardarlo con un nombre, de modo que una invocación larga que use cada mes quede a un clic la próxima vez.
Tarjeta de entorno. Sobre el prompt, una tarjeta muestra la versión de PHP del sitio, la versión de WordPress, el límite de memoria, la memoria actualmente utilizada, el máximo de carga y el límite de tiempo de ejecución, con un botón Copiar para soporte que coloca todo eso, más su lista de plugins activos, en el portapapeles. Péguelo en un ticket de soporte y se habrá ahorrado una vuelta de correo.
Copiar salida. Cada bloque de resultado tiene botones de copiar y de borrar.
La salida se transmite a medida que el comando se ejecuta, de modo que una operación larga muestra progreso en lugar de permanecer en silencio.
Comandos que vale la pena conocer
Diagnóstico
core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes
verify-checksums compara los archivos de su núcleo y plugins con las copias oficiales publicadas e informa de cualquier modificación. Es la comprobación inicial más rápida en un sitio que sospecha que ha sido manipulado.
option list --autoload=yes enumera cada opción que WordPress carga en cada solicitud. Una tabla de autoload sobrecargada es una de las causas más comunes de un sitio lento sin motivo visible.
Mantenimiento general
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
Usuarios
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
Todo lo que se escriba aquí queda registrado en el historial de actividad de su cuenta, incluidas las contraseñas. Cambie una contraseña que haya establecido de esta forma en cuanto haya iniciado sesión. El detalle completo sobre la recuperación de cuentas está en Restablecer una contraseña de administrador de WordPress perdida.
Buscar y reemplazar
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Ejecute siempre primero una simulación (dry run). El recorrido completo, incluyendo por qué un reemplazo SQL sin procesar corrompe una base de datos de WordPress, está en Ejecutar una búsqueda y reemplazo.
¿Consola o Acciones rápidas?
Ambas ejecutan por debajo el mismo WP-CLI. Elija según este criterio:
| Tarea | Mejor opción |
|---|---|
| Vaciar caché, actualizar plugins, regenerar medios | Acciones rápidas, un clic y realiza copia de seguridad primero |
| Buscar y reemplazar con una vista previa por tabla | Acciones rápidas, la tarjeta de Buscar y reemplazar |
| Cualquier cosa que necesite un indicador específico | Consola |
| Listar, inspeccionar, diagnosticar | Consola |
| Ejecutar un evento de cron atrasado | Consola |
Editar wp-config.php o importar una base de datos | Ninguna de las dos. Use el gestor de archivos o phpMyAdmin |
Cuando necesita más que la lista de permitidos
Para WP-CLI sin restricciones, conéctese por SSH y ejecute wp directamente desde el directorio de su sitio. SSH usa únicamente autenticación por clave, de modo que añada primero su clave pública desde Configuración del sitio y luego la pestaña Claves SSH. Los detalles de conexión, incluyendo el host, el puerto y el nombre de usuario exactos, se muestran en esa misma pantalla. Consulte Añadir claves SSH y Conectarse por SFTP.
Solución de problemas
"'x y' is not in the allowed command list." El comando no está en la lista de permitidos. Consulte la tabla anterior para encontrar el equivalente permitido más cercano, o use SSH.
"No results returned. Check that WP-CLI is available." El comando se ejecutó pero no imprimió nada. Normalmente es el comportamiento correcto para una consulta sin coincidencias.
El comando se agota por tiempo de espera. Los comandos de la consola tienen un límite de 60 segundos. Las operaciones largas, como regenerar una biblioteca de medios grande, deben ejecutarse desde Acciones rápidas, que usa un límite más alto, o por SSH.
No se ejecuta nada y los botones están deshabilitados. El rol de su cuenta de KapsuleHost para este sitio es de solo lectura. Pida a un propietario de la cuenta que lo eleve.