LiteSpeed Cache Warmup Dashboard

Bash-Script + WordPress Dashboard-Plugin das alle URLs aus der XML-Sitemap crawlt und den LiteSpeed-Cache vorwärmt. Funktioniert mit jedem LiteSpeed/OpenLiteSpeed Server (Hostinger, Hetzner, CyberPanel, etc.).

Warum?

Nach einem Cache-Purge (Plugin-Update, Deployment, manuelles Leeren) sind alle Seiten uncached. Der erste Besucher bekommt eine langsame, ungecachte Seite. Dieses Script wärmt den Cache vor, sodass alle Seiten schnell laden.

Features

• Parallele Requests — konfigurierbare gleichzeitige Verbindungen (Default: 5)
• Batch-Verarbeitung — Status-Updates nach jedem Batch für Live-Monitoring
• Status-JSON — Schreibt Fortschritt als JSON-Datei
• WordPress Dashboard — Live-Fortschritt, manueller Start, Log-Viewer direkt im WP-Admin
• Sitemap-Index-Support — Verarbeitet sowohl Sitemap-Index als auch einzelne Sitemaps
• Universell — Funktioniert auf Hostinger, Hetzner, CyberPanel, oder jedem LiteSpeed-Server

Voraussetzungen

• Hostinger Cloud oder VPS mit LiteSpeed
• SSH-Zugang
• WordPress mit XML-Sitemap (Rank Math, Yoast, oder WordPress-Standard)
• LiteSpeed Cache Plugin (der eingebaute Crawler sollte deaktiviert sein)

Installation

1. Script auf den Server kopieren

scp -P 65002 cache-warmup.sh USER@SERVER_IP:/home/USER/domains/DOMAIN/cache-warmup.sh

2. Script anpassen

Die Domain oben im Script setzen:

DOMAIN="${DOMAIN:-meine-domain.de}"

Oder beim Aufruf per Environment-Variable:

DOMAIN=meine-domain.de bash /home/USER/domains/meine-domain.de/cache-warmup.sh

3. Testlauf

ssh USER@SERVER_IP -p 65002
bash /home/USER/domains/DOMAIN/cache-warmup.sh

4. Cronjob bei Hostinger einrichten

Im Hostinger Panel unter Erweitert → Cron-Jobs:

Wichtig: Hostinger Cron-Zeiten sind in UTC. Für deutsche Zeit (CET) 2 Uhr morgens → 0 1 * * * im Winter (UTC+1) bzw. 0 0 * * * im Sommer (UTC+2).

Konfiguration

Alle Parameter können per Environment-Variable oder direkt im Script gesetzt werden:

Performance-Tuning

Nicht über 10 gehen – zu viele parallele Requests können den Server überlasten und zu HTTP-Timeouts führen (werden als Errors gezählt).

Status-JSON

Das Script schreibt den Fortschritt nach wp-content/cache-warmup-status.json:

{
  "status": "running",
  "current": 1200,
  "total": 2090,
  "percent": 57,
  "hits": 800,
  "misses": 350,
  "errors": 50,
  "eta_min": 8
}

Was bedeuten Hits / Misses / Errors?

• Hit – Seite war bereits im LiteSpeed-Cache
• Miss – Seite wurde neu in den Cache geladen (= erfolgreich vorgewärmt)
• Error – Kein x-litespeed-cache-Header (z.B. nicht-cachbare Seiten, Timeouts, Redirects)

Eine Error-Rate von 5–15% ist bei WooCommerce-Shops normal (Warenkorb, Mein Konto, etc.).

Wichtig: Prüfen ob Caching überhaupt aktiv ist

Bevor du den Warmup einrichtest, prüfe ob LiteSpeed die Seiten überhaupt cacht. Einige Plugins setzen Cookies oder Cache-Control: no-cache-Header, die das Caching komplett verhindern:

Bekannte Problemverursacher

So prüfst du ob eine Seite gecacht wird

curl -s -o /dev/null -D - https://www.deine-domain.de/ | grep -i "x-litespeed-cache"

Erwartete Ausgabe:

x-litespeed-cache: hit       ← Seite kommt aus dem Cache
x-litespeed-cache: miss      ← Seite wurde gerade in den Cache geladen

Keine Ausgabe? → LiteSpeed cacht diese Seite nicht. Ursache prüfen:

curl -s -o /dev/null -D - https://www.deine-domain.de/ | grep -i "set-cookie\|cache-control\|x-litespeed"

Wenn du set-cookie oder cache-control: no-cache siehst, blockiert etwas den Cache. Häufige Lösung: Das verursachende Plugin per LiteSpeed Cache → Cache → Ausschlüsse oder per Asset CleanUp / Perfmatters nur auf den Seiten laden wo es gebraucht wird.

Warmup Error-Rate als Indikator

Wenn der Warmup durchgehend über 20% Errors zeigt, wird vermutlich ein Plugin das Caching global blockieren. In dem Fall erst das Caching-Problem lösen, dann den Warmup einrichten.

Wie funktioniert Cache-Purge in LiteSpeed?

Wenn ein Redakteur eine Seite bearbeitet, löscht LiteSpeed nicht den gesamten Cache, sondern nur:

• Die bearbeitete Seite selbst
• Die Startseite
• Kategorie-/Tag-Archivseiten
• Autor-Archiv
• Seiten mit "Neueste Beiträge"-Widget

Der Rest bleibt gecacht. Bei 2000 Seiten werden also ~5–10 Seiten gepurged, die restlichen ~1990 bleiben schnell.

"Purge All" im LiteSpeed-Plugin oder Plugin-/Theme-Updates löschen dagegen den kompletten Cache. Dann greift der Warmup-Cronjob in der nächsten Nacht.

LiteSpeed Crawler deaktivieren

Das LiteSpeed Cache Plugin hat einen eingebauten Crawler. Wenn du dieses Script nutzt, deaktiviere den Plugin-Crawler, damit sie sich nicht gegenseitig stören:

WordPress Admin → LiteSpeed Cache → Crawler → Crawler → AUS

Log-Datei

Das Log wächst minimal (~100 Bytes pro Run = ~36 KB/Jahr). Kein regelmäßiges Leeren nötig.

[Wed Feb 11 10:52:44 AM UTC 2026] Warmup fertig: 395 hits, 1492 misses, 203 errors von 2090 (42 min)

Mehrere Domains

Für mehrere WordPress-Seiten auf demselben Server einfach mehrere Cronjobs anlegen:

0 1 * * * DOMAIN=shop-eins.de bash /home/USER/domains/shop-eins.de/cache-warmup.sh
0 2 * * * DOMAIN=shop-zwei.de bash /home/USER/domains/shop-zwei.de/cache-warmup.sh

WordPress Dashboard Plugin

Das Dashboard-Plugin zeigt den Warmup-Status live im WordPress-Backend.

Installation

Kopiere cache-warmup-dashboard.php nach wp-content/mu-plugins/:

cp cache-warmup-dashboard.php /path/to/wp-content/mu-plugins/

Als mu-plugin wird es automatisch aktiviert — kein Plugin-Aktivierung nötig.

Konfiguration (optional)

In wp-config.php können Pfade angepasst werden:

// Pfad zum Warmup-Script (Default: eine Ebene über WordPress-Root)
define('CWU_WARMUP_SCRIPT', '/home/example.com/cache-warmup.sh');

// Pfad zur Log-Datei (Default: /var/log/cache-warmup.log)
define('CWU_LOG_FILE', '/var/log/cache-warmup.log');

Die Status-JSON wird immer aus wp-content/cache-warmup-status.json gelesen — das muss zum STATUS_FILE im Shell-Script passen.

Features

• Live-Fortschrittsbalken — aktualisiert sich alle 3 Sekunden während des Warmups
• Manueller Start — "Warmup jetzt starten" Button
• Statistiken — Seiten gesamt, Cache Hits, neu gecacht, Fehler, Dauer
• Log-Viewer — letzte 20 Log-Einträge im Terminal-Stil

Server-Hinweis: /etc/hosts

Wenn der Warmup auf dem gleichen Server läuft der auch die Website hostet, kann DNS-Auflösung langsam sein oder hängen. Füge die Domain in /etc/hosts ein:

echo '127.0.0.1 www.example.com example.com' >> /etc/hosts

Lizenz

MIT