Estrarre i Backup dalla riga di comando su Linux, macOS o Windows

By , Founder · Updated

Questo articolo ti spiega come estrarre un Backup WP Staging dalla riga di comando usando lo strumento wpstaging cli. Se riscontri problemi con la riga di comando puoi usare un altro strumento chiamato WP Staging restore tool, che fa lo stesso lavoro con un’interfaccia grafica.

wpstaging cli è uno strumento da riga di comando potente e ad alte prestazioni, progettato per elaborare i file di Backup WP Staging dalla riga di comando su ognuno dei principali sistemi operativi.

Con questo strumento puoi estrarre, normalizzare e ispezionare il contenuto dei file di Backup .wpstg creati dal Plugin WP Staging. Questo estrattore standalone è scritto in Go, garantendo velocità ed efficienza eccezionali, e funziona in modo indipendente da WordPress.

Lo strumento da riga di comando `wp-staging-cli` fa parte dei piani WP Staging Developer e Agency e può essere scaricato da GitHub.

Caratteristiche principali

  • Estrazione di file e database del Backup: accedi a tutti i contenuti dei file di Backup .wpstg.
  • Normalizzazione del database: normalizza i file del database all’interno del Backup.
  • Estrazione dei metadati: estrai e visualizza i metadati dal file di Backup.
  • Estrazione di indice e header: recupera le informazioni di indice e header dal file di Backup.

Benchmark delle prestazioni

wp-staging-cli è eccezionalmente veloce. Ad esempio, può estrarre un Backup da 20 GB in meno di 36 secondi su un AMD Ryzen™ 7 PRO 7840U dotato di SSD veloce e Ubuntu 22.04.

Installazione

Passo 1: scaricare gli eseguibili

  1. Scarica gli eseguibili per Windows, Linux e Mac OS da qui.
  2. Estrai il file zip e scegli il binario adatto al tuo sistema operativo dalla cartella build.
  3. (Facoltativo) Sposta il binario wp-staging-cli in una directory presente nel tuo PATH per accedervi più facilmente. Ad esempio, su Linux:
ShellScript
mv wp-staging-cli /usr/local/bin/

Istruzioni d’uso

Per eseguire wp-staging-cli, usa il seguente comando:

ShellScript
wp-staging-cli [options] <backupfile.wpstg>
Argomenti
  • <backupfile.wpstg>: percorso del file di Backup WP Staging da elaborare. Questo argomento è obbligatorio.

Le opzioni e gli argomenti del comando possono essere usati in qualsiasi ordine.

  • Le opzioni possono avere un singolo ‘-‘ o un doppio ‘–‘ come prefisso.
  • Le opzioni con valore possono essere impostate con o senza il segno ‘=’.

Opzioni

ShellScript
  Commands:
  extract - Extract items from the backup. Default if no command is specified.
  restore - Restore the backup file.
  help    - Display all help message.

Arguments:
  backupfile.wpstg  - Path to the WP Staging backup file that will be processed. This argument is mandatory.

General Options:
  -l,  --license=<licensekey>       - WP Staging Pro License Key. Required to access the backup file.
                                      Alternatively, use the `WPSTGPRO_LICENSE` environment variable.
  -o,  --outputdir=<path>           - Specify the extraction directory path where processed files will be stored. Default: "./wp-staging-cli-output".
  -n,  --normalizedb                - Normalize database files during the `extract` process.
                                      This will replace all WP Staging specific placeholders and allows the sql file to be imported by
                                      any regular db admin tool.

       --workingdir=<path>          - Specify the working directory path where config-related files will be stored. Default: "~/.wp-staging-cli".
       --skip-config                - Don't reads command options from the configuration file located at "~/.wp-staging-cli/wp-staging-cli.conf".
       --siteurl=<siteurl>          - Specify a new Site URL.
       --db-prefix=<prefix>         - Specify a new database table prefix.
       --overwrite=<yes|no>         - Overwrite the target directory during `extract` and `restore` operations. Default: "yes".
       --verify                     - Verify the integrity of the extracted file.
       --yes                        - Automatically answers "yes" to confirmation prompts.
       --confirm-timeout=<num>      - Timeout duration (in seconds) for awaiting a "yes" response at confirmation prompts. Default: 30 seconds.
       --skip-extract               - Don't extract files and use previously extracted and existing files for `restore` process.
                                      For use case, when restore failed, the process can be continued without first extracting all files again.

  -or, --only-wproot                - Process only the 'wp root' item in the backup.
  -ow, --only-wpcontent             - Process only the 'wp-content' item in the backup.
  -op, --only-plugins               - Process only the 'plugins' item in the backup.
  -ot, --only-themes                - Process only the 'themes' item in the backup.
  -om, --only-muplugins             - Process only the 'mu-plugins' item in the backup.
  -ou, --only-uploads               - Process only the 'uploads' item in the backup.
  -ol, --only-languages             - Process only the 'languages' item in the backup.
  -od, --only-dbfile                - Process only the database file in the backup.
  -oe, --only-dropins               - Process only the dropins file in the backup.
  -of, --only-file=<string>         - Process only items that match the specified string.

  -sr, --skip-wproot                - Skip processing the 'wp root' item in the backup.
  -sw, --skip-wpcontent             - Skip processing the 'wp-content' item in the backup.
  -sp, --skip-plugins               - Skip processing the 'plugins' item in the backup.
  -st, --skip-themes                - Skip processing the 'themes' item in the backup.
  -sm, --skip-muplugins             - Skip processing the 'mu-plugins' item in the backup.
  -su, --skip-uploads               - Skip processing the 'uploads' item in the backup.
  -sl, --skip-languages             - Skip processing the 'languages' item in the backup.
  -sd, --skip-dbfile                - Skip processing the database file in the backup.
  -se, --skip-dropins               - Skip processing the dropins file in the backup.
  -sf, --skip-file=<string>         - Skip processing items that match the specified string.

  -dm, --dump-metadata              - Display backup metadata from the backup file.
  -di, --dump-index=<data>          - Display backup index from the backup file. Use 'data' to show additional information.
  -dh, --dump-header                - Display backup header from the backup file.
  -do, --dump-options               - Display the command options that have been parsed.

  -d,  --debug                      - Display debug message.
  -q,  --quiet                      - Suppress output of processed backup items.
  -v,  --version                    - Display version information.
  -h,  --help                       - Display all help message.

Restore Options:
  -p,  --path=<path>                - Specify the WordPress root path for restoration. Default: "./".
  -wd, --overwrite-db=<yes|no>      - Remove database tables not present in the backup. Default: "yes".
  -wr, --overwrite-wproot=<yes|no>  - Remove files in the WordPress root path that are not in the backup or part of WordPress core. Default: "no".
       --db-innodb-strict-mode      - Enable InnoDB strict mode if needed. By default, it is turned off during database restoration.
       --db-file=<file>             - Use the extracted backup SQL file to resume database restoration in case of failure.
       --db-insert-batch-size=<num> - Number of queries to batch in a single insert operation. Default: 1000.
       --db-insert-multi=<yes|no>   - Use multi-row INSERT statements per query to improve performance. Default "yes".

Restore DB Options:
  This option overrides the DB-related configuration parsed from the wp-config.php file.
       --db-host=<string>           - Database Host.
       --db-name=<string>           - Database Name.
       --db-user=<string>           - Database User.
       --db-pass=<string>           - Database Password.
       --db-socket=<file>           - MySQL socket file path.
       --db-charset=<string>        - Database charset.
       --db-collate=<string>        - Database collate.
       --db-ssl-ca-cert=<file>      - SSL CA file path.
       --db-ssl-cert=<file>         - SSL certificate file path.
       --db-ssl-key=<file>          - SSL key file path.
       --db-ssl-mode=<mode>         - Connects to the database with SSL mode "skip-verify" or "preferred". Default: "skip-verify".

Esempi:

ShellScript
wp-staging-cli --license=WPSTGPRO_LICENSE --outputdir=./wpstgbackup backup.wpstg
wp-staging-cli --license=WPSTGPRO_LICENSE --normalizedb --dbprefix=newprefix --siteurl=https://example.com backup.wpstg

Con le opzioni brevi:

ShellScript
wp-staging-cli -l WPSTGPRO_LICENSE -o ./wpstgbackup backup.wpstg
wp-staging-cli -l WPSTGPRO_LICENSE -n -dp newprefix -su https://example.com backup.wpstg
Impostare la chiave di licenza tramite variabile d’ambiente

L’estrattore standalone richiede una licenza WP Staging Pro attiva (piano Agency o Developer).
Per comodità, puoi impostare la chiave di licenza tramite una variabile d’ambiente:

Sui sistemi basati su Unix:

ShellScript
export WPSTGPRO_LICENSE=WPSTGPRO_LICENSE_KEY

Sul prompt dei comandi di Windows:

PowerShell
set WPSTGPRO_LICENSE=WPSTGPRO_LICENSE_KEY

Contribuire a wp-staging-cli

I contributi a wp-staging-cli sono benvenuti! Se hai suggerimenti, segnalazioni di bug o vuoi proporre del codice, apri una issue sul repository GitHub.

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.