Inhalte ausliefern und bearbeiten
Neben der Weiterleitung liefert wowa-edge Dateien selbst aus und bearbeitet Antworten unterwegs: Kopfzeilen, Textersetzung im Rumpf, Kompression und ein Cache für Proxy-Antworten.
Statische Inhalte
DocumentRootmitDirectoryIndexals Liste; ausgeliefert wird der erste vorhandene Kandidat.Alias /url/ /verzeichnis/bildet Pfade auf Verzeichnisse ausserhalb des DocumentRoot ab, der längste Präfix gewinnt.- Bereichsanfragen,
ETagundLast-Modified. ExpiresActive,ExpiresByTypeundExpiresDefaultsetzenCache-Control: max-ageundExpires.
Verzeichnis-Listing
Ausgeschaltet, bis Options Indexes es für einen VirtualHost oder Abschnitt einschaltet. IndexOptions FancyIndexing mit Sortierung, IndexIgnore, HeaderName, ReadmeName, AddIcon und DefaultIcon verhalten sich wie bei Apache. Punktdateien erscheinen nie, Dateinamen werden maskiert.
<VirtualHost *:443>
ServerName files.example.org
DocumentRoot /srv/www/files
Options Indexes
IndexOptions FancyIndexing FoldersFirst VersionSort
IndexIgnore *~ *.bak
</VirtualHost>
Fehlerseiten
ErrorDocument nimmt eine lokale Datei, ein lokales Skript, einen Text, eine externe Adresse oder default. Eine lokale Datei kommt mit dem ursprünglichen Status. Trifft der Pfad eine FastCGI-Regel, wird das Skript ausgeführt und bekommt REDIRECT_STATUS und REDIRECT_URL. Das Ziel muss unterhalb des DocumentRoot liegen.
Kopfzeilen
Header set|append|add|unset wirkt auf alle Antworten: statisch, Fehler, Proxy und gestreamt. RequestHeader setzt oder entfernt Kopfzeilen auf dem Weg zum Backend. Beide gelten auch in <Location>, <Files> und .htaccess. Mehrfach vorkommende Felder wie Set-Cookie bleiben über HTTP/1.1, HTTP/2 und HTTP/3 getrennt.
Ein dritter Parameter expr= macht die Regel bedingt, mit einem Ausschnitt der Apache-Ausdrücke: Variablen wie in RewriteCond, %{REQUEST_STATUS}, Vergleiche, Regex-Vergleiche, -z, -n, !, &&, || und Klammern. Eine Bedingung, die sich nicht zerlegen lässt, verwirft die ganze Regel.
Header set Strict-Transport-Security "max-age=31536000; includeSubDomains"
Header set X-Robots-Tag "noindex" "expr=%{REQUEST_URI} =~ m#^/intern/#"
Header unset X-Powered-By
RequestHeader set X-Scope "intern"
Setzen alle VirtualHosts dieselbe HSTS-Politik, wird sie auf jede Antwort gelegt. Sonst gilt sie je VirtualHost, auch auf Fehlerseiten.
Text im Rumpf ersetzen
Substitute schreibt den Rumpf von Proxy-Antworten um, als fester Text oder als Regex. SubstituteBase64 findet zusätzlich Zeichenketten, die vollständig Base64 sind, ersetzt im entschlüsselten Inhalt und kodiert neu. So lassen sich auch eingebettete Adressen umschreiben.
Substitute "s|https://intern.example.org/|https://www.example.org/|n"
SubstituteBase64 "https://intern.example.org/" "https://www.example.org/"
AddOutputFilterByType SUBSTITUTE text/html text/css text/javascript
Die Ersetzung braucht den ganzen Rumpf und puffert deshalb. Solange Regeln aktiv sind, geht Accept-Encoding nicht ans Backend, damit die Regeln auf Klartext arbeiten.
Kompression
AddOutputFilterByType DEFLATE text/html text/css application/javascript application/json
AddOutputFilterByType BROTLI_COMPRESS text/html text/css application/javascript application/json
DeflateCompressionLevel 6
BrotliCompressionQuality 5
Komprimiert wird gestreamt über HTTP/1.1, HTTP/2 und HTTP/3, für statische Dateien und Proxy-Antworten. Ausgehandelt wird br vor gzip vor deflate, Vary: Accept-Encoding ist gesetzt. Fehlt libbrotlienc, geht gzip hinaus.
Komprimiert wird nur ausgehend; Anfragerümpfe werden nie entpackt. Cache-Control: no-transform der Anwendung schaltet die Kompression für diese Antwort ab, etwa für Seiten mit Geheimnissen neben Benutzereingaben.
Cache
CacheEnable mem /api/
CacheDefaultExpire 3600
CacheMaxExpire 86400
CacheMaxFileSize 1048576
CacheRoot /var/cache/wowa-edge
CacheStaleOnError On
CacheStaleWhileRevalidate 30
- Gecacht werden Proxy-Antworten auf
GETohneAuthorizationunter den eingetragenen Präfixen. Beachtet werdenCache-Control,Set-Cookie,VaryundAge; die Antwort trägtX-Cache: HIToderMISS, ein passendesIf-None-Matchergibt 304. - Der Cache liegt im Speicher.
CacheRootschreibt die Einträge zusätzlich auf die Platte, sodass sie einen Neustart überstehen. - Abgelaufene Einträge werden mit
If-None-Matchbzw.If-Modified-Sincebeim Backend nachgefragt. Bei 304 wird nur die Frist verlängert. CacheStaleOnErrorliefert den alten Eintrag, wenn das Backend nicht erreichbar ist.CacheStaleWhileRevalidateliefert ihn sofort und frischt danach auf.CacheMaxEntries,CacheMaxTotalSizeundCacheDiskMaxSizedeckeln Speicher und Platte; der Dienst räumt selbst auf.
Gestreamte Antworten und statische Dateien gehen nicht in den Cache. Expires wird nicht ausgewertet, nur Cache-Control.
Zurück zur Übersicht wowa-edge. Davor: Reverse-Proxy und Lastverteilung, danach: Sicherheit.
Fragen zu Inhalte ausliefern und bearbeiten?
Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.