Wolkenwald
wowa-edge

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

  • DocumentRoot mit DirectoryIndex als 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, ETag und Last-Modified.
  • ExpiresActive, ExpiresByType und ExpiresDefault setzen Cache-Control: max-age und Expires.

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 GET ohne Authorization unter den eingetragenen Präfixen. Beachtet werden Cache-Control, Set-Cookie, Vary und Age; die Antwort trägt X-Cache: HIT oder MISS, ein passendes If-None-Match ergibt 304.
  • Der Cache liegt im Speicher. CacheRoot schreibt die Einträge zusätzlich auf die Platte, sodass sie einen Neustart überstehen.
  • Abgelaufene Einträge werden mit If-None-Match bzw. If-Modified-Since beim Backend nachgefragt. Bei 304 wird nur die Frist verlängert.
  • CacheStaleOnError liefert den alten Eintrag, wenn das Backend nicht erreichbar ist. CacheStaleWhileRevalidate liefert ihn sofort und frischt danach auf.
  • CacheMaxEntries, CacheMaxTotalSize und CacheDiskMaxSize deckeln 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.

Kontakt

Fragen zu Inhalte ausliefern und bearbeiten?

Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.