You have set English as your preferred language. Would you like to go to the English help center?

Browser-Caching für statische Dateien

Plesk unterstützt die Konfiguration von Browser-Caching für statische Ressourcen für einzelne oder alle Domains. Bitte beachten Sie, dass für die zentrale Einrichtung aller Domains ein Unmanaged Server mit SSH Root-Zugriff erforderlich ist.



Einrichtung für eine Domain

Wählen Sie zunächst die Domain aus, für die Sie Browser Caching aktivieren möchten. Navigieren Sie anschließend zu den Apache & nginx Einstellungen der Domain.


Zusätzliche NGINX Direktiven:

location ~* \.(js|jpg|jpeg|gif|png|css|tgz|gz|rar|bz2|doc|pdf|ppt|tar|wav|bmp|rtf|swf|ico|flv|txt|woff|woff2|svg)$ {
    etag on;
    add_header Cache-Control "public, max-age=31536000";
}


Google empfiehlt mindestens 365 Tage für statische Ressourcen.

Quelle: https://developer.chrome.com/docs/lighthouse/performance/uses-long-cache-ttl?hl=de



Einrichtung für alle Domains


Für die Einrichtung ist ein Unmanaged Server mit SSH Root-Zugriff erforderlich


Melden Sie sich via SSH am Server an und erstellen Sie folgende Datei:

touch /etc/nginx/conf.d/expires.global


location ~* \.(js|jpg|jpeg|gif|png|css|tgz|gz|rar|bz2|doc|pdf|ppt|tar|wav|bmp|rtf|swf|ico|flv|txt|woff|woff2|svg)$ {
    etag on;
    add_header Cache-Control "public, max-age=31536000";
}


Erstellen Sie anschließend ein neues Verzeichnis für die virtuellen Templates:

mkdir -p /usr/local/psa/admin/conf/templates/custom/domain/


Kopieren Sie das Standard NGINX Template in das neue Verzeichnis:

cp -p /usr/local/psa/admin/conf/templates/default/domain/nginxDomainVirtualHost.php /usr/local/psa/admin/conf/templates/custom/domain/


Bearbeiten Sie das Standard NGINX Template und fügen Sie die neue globale Konfigurationsdatei am Ende hinzu:


nano /usr/local/psa/admin/conf/templates/custom/domain/nginxDomainVirtualHost.php

include /etc/nginx/conf.d/expires.global;

# Ende der Datei
<?php if (is_file($VAR->domain->physicalHosting->customNginxConfigFile)): ?>
include "<?php echo $VAR->domain->physicalHosting->customNginxConfigFile ?>";
<?php endif ?>
}


Neue Domains werden automatisch mit dieser Konfiguration ausgerollt, sodass das Browser-Caching via NGINX im Standard aktiv ist. Damit sichergestellt wird, dass auch bestehende Domains die korrekte neue Konfiguration erhalten, muss folgender Befehl ausgeführt werden:

/usr/local/psa/admin/bin/httpdmng --reconfigure-all



Beispiel Max-Age Werte

Header Wert Beschreibung
Cache-Control public, max-age=31536000 365 Tage
Cache-Control public, max-age=15552000 180 Tage
Cache-Control public, max-age=7776000 90 Tage
Cache-Control public, max-age=5184000 60 Tage
Cache-Control public, max-age=2592000 30 Tage
Cache-Control public, max-age=604800 7 Tage



Browser-Caching überprüfen

Um die Anpassungen des Caching-Verhaltens zu überprüfen, führen Sie folgenden Befehl aus:


curl -I https://www.creoline-demo.com/static/styles.css

HTTP/2 200
server: nginx
date: Thu, 08 Aug 2024 12:18:50 GMT
content-type: text/css
content-length: 25500
last-modified: Thu, 08 Aug 2024 12:18:50 GMT
etag: "4107c187-125zc"
cache-control: public, max-age=31536000


Überprüfen Sie die HTTP-Antwort, ob sowohl der Cache-Control Header den Wert public als auch den max-age Wert enthält. Zusätzlich muss ebenfalls ein etag Header dargestellt werden.