Gestionar sitios WordPress con Docker

WP Staging CLI can create and manage Docker-based WordPress environments for local development and testing. This guide covers how to add, list, delete, and manage WordPress sites.

Qué obtendrás

Cada sitio Docker incluye:

• PHP-FPM con la versión de PHP que elijas
• Servidor web Nginx con HTTPS
• Base de datos MariaDB
• Mailpit para pruebas de correo electrónico
• Certificados SSL automáticos mediante mkcert
• Configuración del archivo hosts para dominios locales

Requisitos previos

• Docker 20.10.0 o posterior
• Docker Compose 2.19.0 o posterior
• Mínimo 2 núcleos de CPU y 4 GB de RAM

Añadir un nuevo sitio

Crea un nuevo sitio de WordPress con un dominio local personalizado:

wpstaging add https://mysite.local

O sin el protocolo:

wpstaging add mysite.local

¿Necesitas un WordPress Multisite?

wpstaging add mysite.local --multisite

Una vez creado el sitio, puedes acceder a él en https://mysite.local.

Añadir un sitio desde un archivo de Backup existente

Crea un nuevo sitio y restaura desde un archivo de Backup de WP Staging en un solo paso:

wpstaging add mysite.local --from=backup.wpstg

O desde una URL remota:

wpstaging add mysite.local --from=https://example.com/backup.wpstg

WordPress Multisite:

wpstaging add mysite.local --multisite --from=BACKUP_URL

Personalizar la configuración del sitio

Versión de PHP

Especifica la versión de PHP (el valor predeterminado es 8.1):

wpstaging add mysite.local --php=8.2

Las versiones de PHP disponibles dependen de las imágenes Docker admitidas.

Versión de WordPress

Instala una versión específica de WordPress (el valor predeterminado es la última):

wpstaging add mysite.local --wp=6.4.2

Puertos personalizados

Cambia los puertos predeterminados si entran en conflicto con otros servicios:

wpstaging add mysite.local \
  --http-port=8080 \
  --https-port=8443 \
  --db-port=3307

Dirección IP del contenedor

Por defecto, los sitios usan direcciones IP en el rango 127.3.2.x. Puedes especificar una IP personalizada:

wpstaging add mysite.local --container-ip=127.0.0.1

Ruta del entorno

Cambia dónde se almacenan los entornos Docker (predeterminado: ~/wpstaging):

wpstaging add mysite.local --env-path=/custom/path

Todos los indicadores del comando add

Indicadores de configuración de WordPress

Listar sitios

Ver todos los sitios de WordPress en tu entorno Docker:

wpstaging list

Ejemplo de salida:

HOSTNAME            STATUS      PHP     IP
mysite.local        running     8.1     127.3.2.1
dev.local           stopped     8.2     127.3.2.2
test.local          running     8.0     127.3.2.3

Ver detalles de sitios específicos

Obtén información detallada sobre uno o más sitios:

wpstaging list mysite.local

O varios sitios:

wpstaging list site1.local site2.local

Eliminar sitios

Eliminar un sitio específico:

wpstaging del mysite.local

Eliminar varios sitios:

wpstaging del site1.local site2.local

Eliminar todos los sitios (con confirmación):

wpstaging del

Activar/desactivar sitios

Deshabilitar un sitio sin eliminarlo:

wpstaging disable mysite.local

Volver a habilitar un sitio deshabilitado:

wpstaging enable mysite.local

Los sitios deshabilitados conservan sus datos pero sus contenedores no se inician.

Restablecer un sitio

Restablecer un sitio a una instalación de WordPress nueva:

wpstaging reset mysite.local

Esto elimina todo el contenido de WordPress y reinstala WordPress manteniendo la configuración de Docker intacta.

Restablecer con una versión diferente de WordPress

Especifica una versión diferente de WordPress durante el restablecimiento:

wpstaging reset mysite.local --wp=6.5

Restablecer y restaurar desde Backup

Restablece el sitio y restaura desde un Backup de WP Staging en un solo paso:

wpstaging reset mysite.local --from=backup.wpstg
wpstaging reset mysite.local --from=https://example.com/backup.wpstg

Credenciales seguras

Para mayor seguridad, especialmente en entornos compartidos, usa credenciales aleatorias:

wpstaging add mysite.local --secure-credentials

Esto genera contraseñas aleatorias para:

• Usuario root de MariaDB
• Usuario de base de datos de WordPress
• Usuario administrador de WordPress

Las credenciales generadas se muestran después de crear el sitio.

WordPress Multisite

Crear una instalación de WordPress Multisite:

wpstaging add mynetwork.local --multisite

Notas para macOS

Pasos siguientes

• Controlar contenedores Docker – Iniciar, detener y gestionar contenedores
• Configuración de Docker – Opciones de configuración avanzada
• Crear una copia local del sitio de WordPress – Tutorial completo