Backups auf der Kommandozeile entpacken unter Linux, MacOS oder Windows

Dieser Artikel erklärt, wie du ein WP Staging Backup auf der Kommandozeile mit dem Tool wp-staging-cli entpacken kannst. Wenn du Schwierigkeiten mit der Kommandozeile hast, kannst du ein anderes Tool namens WP Staging Restore Tool verwenden, um die gleiche Aufgabe mit einer grafischen Benutzeroberfläche zu erledigen.

wp-staging-cli ist ein leistungsstarkes, hochperformantes Kommandozeilen-Tool, das entwickelt wurde, um WP Staging Backup-Dateien über die Kommandozeile auf jedem gängigen Betriebssystem zu verarbeiten.

Mit diesem Tool kannst du den Inhalt von .wpstg Backup-Dateien, die vom WP Staging Plugin erstellt wurden, entpacken, normalisieren und überprüfen. Dieser eigenständige Extractor ist in Go programmiert, was außergewöhnliche Geschwindigkeit und Effizienz gewährleistet, und funktioniert unabhängig von WordPress.

Das Kommandozeilen-Tool `wp-staging-cli` ist Teil des WP Staging Developer– und Agency-Plans und kann von GitHub heruntergeladen werden.

Hauptfunktionen

  • Backup-Dateien und Datenbank entpacken: Greife auf alle Inhalte von .wpstg Backup-Dateien zu.
  • Datenbank-Normalisierung: Normalisiere Datenbankdateien innerhalb des Backups.
  • Metadaten-Ausgabe: Extrahiere und zeige Metadaten aus der Backup-Datei an.
  • Index- und Header-Ausgabe: Rufe Index- und Header-Informationen aus der Backup-Datei ab.

Leistungsbenchmark

wp-staging-cli ist außergewöhnlich schnell. Beispielsweise kann es ein 20GB Backup in unter 36 Sekunden auf einem AMD Ryzen™ 7 PRO 7840U mit einer schnellen SSD unter Ubuntu 22.04 entpacken.

Installation

Schritt 1: Ausführbare Dateien herunterladen

  1. Lade die ausführbaren Dateien für Windows, Linux und Mac OS von hier herunter.
  2. Entpacke die Zip-Datei und wähle die passende Binärdatei für dein Betriebssystem aus dem build-Ordner.
  3. (Optional) Verschiebe die wp-staging-cli-Binärdatei in ein Verzeichnis in deinem PATH für einfachen Zugriff. Zum Beispiel unter Linux:
ShellScript
mv wpstaging /usr/local/bin/

Verwendungshinweise

Um wp-staging-cli auszuführen, verwende den folgenden Befehl:

ShellScript
wpstaging [options] <backupfile.wpstg>
Argumente
  • <backupfile.wpstg>: Pfad zur WP Staging Backup-Datei, die verarbeitet werden soll. Dieses Argument ist erforderlich.

Befehlsoptionen und Argumente können in beliebiger Reihenfolge verwendet werden.

  • Optionen können ein einfaches ‚-‚ oder ein doppeltes ‚–‚ Bindestrich-Präfix haben.
  • Optionen mit Werten können mit oder ohne ‚=‘ gesetzt werden.

Optionen

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".

Beispiele:

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

Mit Kurzoptionen:

ShellScript
wpstaging -l WPSTGPRO_LICENSE -o ./wpstgbackup backup.wpstg
wpstaging -l WPSTGPRO_LICENSE -n -dp newprefix -su https://example.com backup.wpstg
Lizenzschlüssel über Umgebungsvariable setzen

Der eigenständige Extractor benötigt eine aktive WP Staging Pro-Lizenz. (Agency- oder Developer-Plan)
Der Einfachheit halber kannst du den Lizenzschlüssel über eine Umgebungsvariable setzen:

Auf Unix-basierten Systemen:

ShellScript
export WPSTGPRO_LICENSE=WPSTGPRO_LICENSE_KEY

In der Windows-Eingabeaufforderung:

PowerShell
set WPSTGPRO_LICENSE=WPSTGPRO_LICENSE_KEY

Zu wp-staging-cli beitragen

Wir freuen uns über Beiträge zu wp-staging-cli! Wenn du Vorschläge, Fehlerberichte hast oder Code beitragen möchtest, erstelle ein Issue im GitHub-Repository.

Verwandte Artikel

Updated on März 6, 2026