Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Varnish und Reverse Proxys

Einen Reverse Proxy oder einen zwischenspeichernden Proxy wie Varnish vor Exponential-Websites stellen - ob Sie einen brauchen, dem Proxy für HTTPS und die Adresse des Besuchers vertrauen, was zwischengespeichert werden…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/hosting/performance/varnish-and-reverse-proxies.md

On this page

This page is a translation. Read the English original

Varnish und Reverse Proxys

Diese Seite ist für Systemadministratoren bei Hosting-Anbietern, die einen Reverse Proxy, einen zwischenspeichernden Proxy wie Varnish oder einen Load Balancer vor Kunden-Websites betreiben. Sie beantwortet: ob Exponential überhaupt einen braucht, was der Proxy senden muss und wofür ihm vertraut werden muss, was ein zwischenspeichernder Proxy speichern darf und wie Sie ihn leeren. Die eigene Konfigurationssprache von Varnish wird hier nicht beschrieben; lesen Sie in seiner Dokumentation nach. Die Quellen sind Kapitel 8, Abschnitt 8.8, Weitergeleiteten Headern wird nur von konfigurierten Proxys vertraut und Kapitel 15, Abschnitt 15.14.

Inhalt

  1. Brauchen Sie einen Proxy?
  2. Was der Proxy senden muss
  3. Dem Proxy vertrauen
  4. Ein zwischenspeichernder Proxy: was gespeichert werden darf
  5. Leeren: Exponential sendet nichts
  6. Prüfungen und Symptome
  7. Checkliste

Brauchen Sie einen Proxy?

GrundNötig?
Beenden von TLSnein für Velocity, das HTTPS selbst ausliefert; ja, wenn ein Load Balancer oder CDN TLS bereits beendet
Mehrere Dienste oder Instanzen von Kunden hinter einer öffentlichen Adresseein einfacher Reverse Proxy ist die richtige Form
Velocity als gewöhnlicher Benutzer auf einem hohen Port betreibenein Proxy oder eine Umleitung der Firewall davor
Anonyme Seiten zwischenspeichernnicht unbedingt: der Antwort-Cache von Velocity und der rollenbewusste HTTP-Cache tun das innerhalb von Exponential

Für Websites, die von älteren Plattformen mit Varnish migriert wurden, sagt das Installationsbuch: Lassen Sie Varnish entweder weg (der HTTP-Cache oder der Antwort-Cache von Velocity erledigt dieselbe Aufgabe innerhalb von Exponential), oder lassen Sie es anonyme Seiten nur kurz zwischenspeichern, oder leeren Sie es selbst.

Was der Proxy senden muss

HeaderWarum
X-Forwarded-Proto (vom Proxy gesetzt, nie vom Besucher durchgereicht)damit erzeugte URLs, Umleitungen und das Merkmal Secure des Sitzungscookies stimmen
X-Forwarded-For (angehängt oder gesetzt)die Adresse des Besuchers; Exponential liest die Liste von rechts, Anhängen ist also sicher
der ursprüngliche HostVelocity nutzt X-Forwarded-Host nicht; unter PHP-FPM ersetzt ein vertrauenswürdiges X-Forwarded-Host den Host

Abgeleitete Beispiele für nginx und Apache vor Velocity stehen auf Velocity neben Apache oder nginx.

Dem Proxy vertrauen

Weitergeleitete Header zählen nur von einer vertrauenswürdigen Gegenstelle. Es gibt zwei Listen:

Server hinter dem ProxyListeStandard
Apache oder nginx mit PHP-FPM, FrankenPHPsite.ini [HTTPHeaderSettings] TrustedProxies[]127.0.0.1, ::1
VelocityQ.webserver.proxy.trusted in der Konfiguration der Engine127.0.0.1, ::1

Ein Proxy auf derselben Maschine (einschließlich Varnish auf Loopback) ist abgedeckt. Ein Proxy anderswo muss aufgeführt werden:

# settings/override/site.ini.append.php
[HTTPHeaderSettings]
TrustedProxies[]
TrustedProxies[]=127.0.0.1
TrustedProxies[]=::1
TrustedProxies[]=10.0.0.0/16
ClientIpByCustomHTTPHeader=X-Forwarded-For
  • Einträge sind Adressen oder Bereiche, IPv4 und IPv6; Hostnamen werden nicht aufgelöst. Eine Überschreibung, die mit TrustedProxies[] allein in einer Zeile beginnt, ersetzt die Liste.
  • Kommentare gehören in eigene Zeilen: Nach einem Wert wird ein # als Teil des Werts gelesen, und der Eintrag wird ignoriert.
  • ClientIpByCustomHTTPHeader ist nur unter PHP-FPM nötig; unter Velocity übergibt die Engine die Adresse des Besuchers als REMOTE_ADDR.
  • Einem Proxy zu vertrauen heißt, ihm zu vertrauen, dass er die Header setzt. Ein lokaler Proxy, der das eigene X-Forwarded-Proto eines Besuchers weitergibt, würde es durchreichen; wenn Sie einen solchen Proxy nicht ändern können, setzen Sie TrustedProxies[] leer.
  • Stellen Sie sicher, dass der Origin nicht am Proxy vorbei erreichbar ist (Firewall, Sicherheitsgruppe).

Für Velocity legen Sie die Liste in ein Snippet wie /etc/vc/conf-available/reverse-proxy.conf und aktivieren es mit exp:velocity conf enable reverse-proxy (Velocity neben Apache oder nginx). Engine 0.0.4.44 oder später ist nötig, damit das weitergeleitete Protokoll nur von vertrauenswürdigen Proxys gelesen wird.

Ein zwischenspeichernder Proxy: was gespeichert werden darf

Warnung Ein zwischenspeichernder Proxy darf keine Seiten angemeldeter Benutzer speichern. Speichern Sie keine Antworten zwischen, die das Sitzungscookie setzen oder davon abhängen (Kapitel 8, Abschnitt 8.8).

Was Exponential einem Proxy zum Arbeiten gibt:

  • Seiten sind standardmäßig no-cache. Damit ein Proxy anonyme Seiten speichern darf, schalten Sie [HTTPHeaderSettings] mit OnlyForAnonymous=enabled und einem kurzen max-age ein (HTTP-Cache-Header).
  • Seiten, die ein Formular-Token tragen, werden private gesendet.
  • Der Name des Sitzungscookies folgt site.ini [Session] SessionNameHandler: Bei default benennt PHP es; bei custom ist es SessionNamePrefix (mitgeliefert eZSESSID) plus ein Digest pro Siteaccess. Der Kernel setzt außerdem is_logged_in für angemeldete Besucher. Eine Proxy-Regel, die den Cache bei einem der beiden Cookies umgeht, entspricht dem, was der eigene Antwort-Cache von Velocity tut.
  • Statische Dateien tragen unter Velocity lange Lebensdauern (StaticMaxAge) und können frei zwischengespeichert werden.

Leeren: Exponential sendet nichts

Exponential sendet keine Anfragen zum Leeren oder Sperren an einen Proxy; im Kernel gibt es kein PURGE oder BAN. Ein Proxy, der Seiten länger als ihr max-age behält, liefert nach einer Bearbeitung veraltete Seiten aus. Möglichkeiten aus dem Installationsbuch:

  1. Nur kurze Lebensdauern: Lassen Sie den Proxy anonyme Seiten für das konfigurierte max-age behalten, und nicht länger.
  2. Nach Tag leeren: httpcache.ini [HttpCacheSettings] TagHeader=xkey nennt die Purge-Tags jeder Seite in einem Header für das Modul xkey von Varnish (Surrogate-Key für Fastly, Cache-Tag für Cloudflare). Die Einstellung und die Tags gehören zum rollenbewussten HTTP-Cache (HTTP-Cache); testen Sie, dass Seiten sie tragen.
  3. Beim Veröffentlichen selbst leeren: Der Kernel löst bei jeder Veröffentlichung content/cache mit den IDs von Knoten und Objekten aus (kernel/classes/ezcontentcachemanager.php), was ein Listener in site.ini [Event] Listeners[] in ein Leeren umsetzen kann.
  4. Den Proxy-Cache weglassen und den Antwort-Cache von Velocity oder den HTTP-Cache nutzen, die sich selbst leeren.

Prüfungen und Symptome

Wenn die Website direkt erreichbar ist, darf ein weitergeleiteter Header eines Besuchers nichts ändern:

curl -s -o /dev/null -w '%{redirect_url}\n' -H 'X-Forwarded-Proto: https' http://example.com/user/logout
# expected: http://example.com/   -- https:// here means the header was believed
SymptomUrsacheAbhilfe
Umleitungen und absolute Links gehen auf http://dem Proxy wird nicht vertraut, oder er sendet kein X-Forwarded-Protoihn aufführen; den Header setzen
jeder Besucher hat die Adresse des Proxys (Sperre bei der Anmeldung, Logs)dem Proxy wird nicht vertraut, oder ClientIpByCustomHTTPHeader ist unter PHP-FPM nicht gesetztden Proxy aufführen; die Einstellung für den Header setzen
eine Umleitungsschleife nach dem Wechsel auf HTTPSder Server weiß nicht, dass der Besucher HTTPS genutzt hatwie in der ersten Zeile
Seiten angemeldeter Benutzer werden anderen Besuchern ausgeliefertein zwischenspeichernder Proxy speichert Seiten mit einem Sitzungscookieden Cache beim Sitzungscookie und bei is_logged_in umgehen
Seiten bleiben hinter Varnish veraltetExponential sendet nichts zum Leereneine der Möglichkeiten zum Leeren oben

Checkliste

  • To do: Der Proxy setzt X-Forwarded-Proto und hängt X-Forwarded-For an oder setzt es; er reicht Host durch.
  • To do: Dem Proxy wird vertraut (TrustedProxies[] oder Q.webserver.proxy.trusted für Velocity); der Origin ist nicht an ihm vorbei erreichbar.
  • To do: Die curl-Prüfung besteht direkt und über den Proxy.
  • To do: Ein zwischenspeichernder Proxy umgeht Anfragen mit dem Sitzungscookie oder is_logged_in und speichert nur public-Seiten.
  • To do: Eine Strategie zum Leeren ist gewählt und in den Tarif geschrieben.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x