Varnish bei großen WP STAGING Remote Sync Backups umgehen (Nginx Vhost Fix)

Die Veröffentlichung von Remote Sync ist ein Meilenstein für WP STAGING. Indem wir es Benutzern ermöglichen, WordPress-Seiten über verschiedene Server hinweg zu synchronisieren, widmen wir uns einer der am meisten nachgefragten Funktionen in unserer Geschichte.

Allerdings bringt das Verschieben riesiger Datenmengen – manchmal über 30 GB – besondere serverseitige Herausforderungen mit sich. Eine häufige Hürde ist Varnish Cache. Obwohl Varnish hervorragend geeignet ist, deine Seite zu beschleunigen, kann es bei umfangreichen Datentransfers als Engpass wirken.

Das Problem: Varnish Buffer-Limits

Wenn Remote Sync startet, erstellt es eine komprimierte Backup-Datei auf der Quellseite und lädt sie auf das Ziel herunter. Wenn Varnish auf deinem Server aktiv ist, sitzt es zwischen Nginx und deiner Anwendung.

Varnish hat oft ein Standard-Limit für Objektgrößen (manchmal nur 512 MB). Wenn die WP STAGING Backup-Datei dieses Limit überschreitet, bricht Varnish die Verbindung ab, was dazu führt, dass die Synchronisation fehlschlägt. Selbst wenn du den Pfad in einem Control Panel wie CloudPanel „ausschließt“, leitet Nginx die Anfrage trotzdem über Varnish weiter, was zum gleichen Engpass führt.

Die Lösung: Varnish über Vhost umgehen

Um einen stabilen Transfer großer Backup-Dateien sicherzustellen, musst du Nginx anweisen, Varnish für das WP STAGING Backup-Verzeichnis komplett zu umgehen. Dies geschieht durch Bearbeitung der Virtual Host (Vhost) Konfiguration deiner Seite.

1. Backup-Pfad identifizieren

Das Standardverzeichnis, in dem WP STAGING temporäre Sync-Dateien speichert, ist: /wp-content/uploads/wp-staging/backups/

2. Nginx-Konfiguration aktualisieren

Füge das folgende Snippet in deine Nginx-Vhost-Datei ein. Diese Direktive weist den Server an, Anfragen für diesen bestimmten Ordner direkt an das Backend (normalerweise auf Port 8080) zu senden, den Varnish-Dienst (normalerweise auf Port 6081) zu überspringen und Buffering zu deaktivieren.

Nginx

# Large WP STAGING backup files - BYPASS VARNISH
location ^~ /wp-content/uploads/wp-staging/backups/ {
    proxy_pass http://127.0.0.1:8080;
    proxy_buffering off;
    proxy_request_buffering off;
    proxy_set_header Host              $host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    add_header Cache-Control "private, no-store" always;
}

Warum das funktioniert

  • proxy_pass auf 8080: Indem wir direkt auf den Backend-Port verweisen, umgehen wir die Varnish-Schicht vollständig.
  • proxy_buffering off: Dies verhindert, dass Nginx versucht, die Datei in seinem eigenen Cache zu „speichern“, bevor sie ausgeliefert wird – was bei Dateien über 10 GB essentiell ist.
  • ^~ Modifier: Dies stellt sicher, dass diese Regel Vorrang vor anderen regulären Ausdrucksvergleichen hat, sodass der Ausschluss strikt durchgesetzt wird.

Alternative: Temporäre Deaktivierung

Wenn du dich nicht wohl dabei fühlst, Vhost-Dateien zu bearbeiten, kannst du Varnish auf deinem Server vorübergehend deaktivieren, bevor du einen großen Remote Sync startest, und es wieder aktivieren, sobald die „Restore“-Phase abgeschlossen ist. Die oben beschriebene Vhost-Methode ist jedoch die empfohlene Lösung zum „Einrichten und Vergessen“.

Updated on März 7, 2026