Gestire i siti WordPress in Docker

WP Staging CLI può creare e gestire ambienti WordPress basati su Docker per lo sviluppo e i test in locale. Questa guida ti spiega come aggiungere, elencare, eliminare e gestire i siti WordPress.

Cosa otterrai

Ogni sito Docker include:

  • PHP-FPM con la versione di PHP che scegli
  • Web server Nginx con HTTPS
  • Database MariaDB
  • Mailpit per testare l’invio email
  • Certificati SSL automatici tramite mkcert
  • Configurazione del file hosts per i domini locali

Prerequisiti

  • Docker 20.10.0 o versione successiva
  • Docker Compose 2.19.0 o versione successiva
  • Almeno 2 core CPU e 4 GB di RAM

Aggiungere un nuovo sito

Crea un nuovo sito WordPress con un dominio locale personalizzato:

wpstaging add https://mysite.local

Oppure senza specificare il protocollo:

wpstaging add mysite.local

Ti serve un WordPress Multisite?

wpstaging add mysite.local --multisite

Una volta creato il sito, potrai accedervi su https://mysite.local.

Aggiungere un sito da un Backup esistente

Crea un nuovo sito e ripristinalo da un file di Backup WP Staging in un solo passaggio:

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

Oppure da un URL remoto:

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

WordPress Multisite:

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

Questo è il modo consigliato per creare una copia locale del tuo sito di produzione. Gestisce tutto: configurazione Docker, estrazione del Backup, importazione del database e sostituzione degli URL.

Personalizzare la configurazione del sito

Versione di PHP

Specifica la versione di PHP (il valore predefinito è 8.1):

wpstaging add mysite.local --php=8.2

Le versioni di PHP disponibili dipendono dalle immagini Docker supportate.

Versione di WordPress

Installa una versione specifica di WordPress (il valore predefinito è la più recente):

wpstaging add mysite.local --wp=6.4.2

Porte personalizzate

Cambia le porte predefinite se entrano in conflitto con altri servizi:

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

Indirizzo IP del container

Per impostazione predefinita i siti usano indirizzi IP nel range 127.3.2.x. Puoi indicarne uno personalizzato:

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

Percorso degli ambienti

Modifica la directory in cui vengono salvati gli ambienti Docker (predefinita: ~/wpstaging):

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

Tutti i flag del comando add

FlagPredefinitoDescrizione
--php8.1Versione di PHP
--wplatestVersione di WordPress
--fromPercorso o URL del file di Backup da ripristinare
--env-path~/wpstagingPercorso in cui salvare gli ambienti Docker
--container-ip127.3.2.1Indirizzo IP del container
--http-port80Porta HTTP di Nginx
--https-port443Porta HTTPS di Nginx
--db-port3306Porta di MariaDB
--db-root123456Password root di MariaDB
--mailpit-http-port8025Porta dell’interfaccia web di Mailpit
--disable-mailpitfalseDisabilita il container Mailpit

Flag di configurazione di WordPress

FlagPredefinitoDescrizione
--db-nameautoNome del database WordPress
--db-userautoUtente del database WordPress
--db-passautoPassword del database WordPress
--db-prefixwp_Prefisso delle tabelle WordPress
--db-hostlocalhostHostname del database WordPress
--db-sslfalseAbilita SSL per la connessione al database WordPress
--admin-useradminNome utente amministratore di WordPress
--admin-passadminPassword amministratore di WordPress
--admin-emailadmin@dev.nullEmail amministratore di WordPress
--secure-credentialsfalseGenera credenziali casuali sicure
--multisitefalseAbilita WordPress Multisite

Elencare i siti

Visualizza tutti i siti WordPress presenti nel tuo ambiente Docker:

wpstaging list

Esempio di output:

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

Visualizzare i dettagli di siti specifici

Ottieni informazioni dettagliate su uno o più siti:

wpstaging list mysite.local

Oppure più siti contemporaneamente:

wpstaging list site1.local site2.local

Eliminare i siti

Elimina un sito specifico:

wpstaging del mysite.local

Elimina più siti contemporaneamente:

wpstaging del site1.local site2.local

Elimina tutti i siti (con richiesta di conferma):

wpstaging del

Attenzione: eliminando un sito vengono rimossi tutti i suoi file, il database e la configurazione. L’operazione non può essere annullata.

Abilitare e disabilitare i siti

Disabilita un sito senza eliminarlo:

wpstaging disable mysite.local

Riabilita un sito disabilitato:

wpstaging enable mysite.local

I siti disabilitati mantengono i loro dati, ma i container non vengono avviati.

Ripristinare un sito allo stato iniziale

Ripristina un sito a un’installazione WordPress pulita:

wpstaging reset mysite.local

Questa operazione rimuove tutti i contenuti di WordPress e reinstalla WordPress, mantenendo intatta la configurazione Docker.

Reset con una versione diversa di WordPress

Specifica una versione di WordPress diversa durante il reset:

wpstaging reset mysite.local --wp=6.5

Reset e ripristino da Backup

Reimposta il sito e ripristinalo da un Backup WP Staging in un solo passaggio:

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

Credenziali sicure

Per una maggiore sicurezza, soprattutto in ambienti condivisi, usa credenziali casuali:

wpstaging add mysite.local --secure-credentials

Questa opzione genera password casuali per:

  • L’utente root di MariaDB
  • L’utente del database WordPress
  • L’utente amministratore di WordPress

Le credenziali generate vengono mostrate al termine della creazione del sito.

WordPress Multisite

Crea un’installazione WordPress Multisite:

wpstaging add mynetwork.local --multisite

Note per macOS

Utenti macOS: l’associazione automatica degli alias IP è abilitata di default per configurazioni multi-sito senza interruzioni, usando il range IP di loopback 127.3.2.1 – 127.3.2.254. Questa operazione richiede sudo e ti verrà chiesta la password.

Suggerimento: configura sudo senza password per wpstaging così da evitare richieste di password ripetute. Consulta le FAQ per le istruzioni.

Prossimi passi

Updated on Maggio 23, 2026

Rene Hermenau

Autore: Rene Hermenau

About the author: René Hermenau is the founder of WP STAGING. He works on WordPress backups, staging, migrations, database handling, and safe deployment workflows.