Wolkenwald
wowa-edge

Konfiguration und Umstieg von Apache

wowa-edge liest eine Konfiguration in der Syntax von Apache HTTPD 2.4. Direktivennamen sind übernommen, wo Syntax und Bedeutung sich abbilden lassen. Wo das Verhalten trotz gleicher Schreibweise abweicht, steht es unten in der Liste der Abweichungen.

Aufbau

Die Hauptdatei liegt unter /etc/wowa-edge/wowa-edge.conf. Sie enthält die server-globalen Einstellungen und holt die VirtualHosts per Include nach, auch mit Glob. Ein VirtualHost wird über ServerName, ServerAlias und den Selektor <VirtualHost ADRESSE:PORT> gewählt; _default_ fängt alles übrige.

Listen 443 ssl
Listen 443 quic
Include conf.d/*.conf

<VirtualHost *:443>
    ServerName      example.org
    ServerAlias     www.example.org
    DocumentRoot    /srv/www/example.org
    DirectoryIndex  index.html index.htm
    ACMEAutoCert    on
    ErrorLog        /var/log/wowa-edge/example.error.log
    CustomLog       /var/log/wowa-edge/example.access.log combined
</VirtualHost>

Viele Direktiven dürfen ausserhalb jedes <VirtualHost> stehen und gelten dann für alle. Einzelwerte wie DirectoryIndex ersetzt der VirtualHost, Header und RequestHeader werden verkettet, Alias, ProxyPass und Redirect zusammengelegt. Rewrite-Regeln werden wie bei Apache nicht vererbt.

Abschnitte

<Location>, <Directory>, <Files>, <FilesMatch>, <LocationMatch>, <DirectoryMatch>, <Limit> und <LimitExcept> tragen Zugriffsregeln und Kopfzeilen, im VirtualHost und server-global.

Rewrite und Redirect

RewriteRule bildet eine Kette: jede Regel prüft den bereits umgeschriebenen Pfad, [L] beendet sie. Interne Umschreibungen werden im Prozess bedient. Trifft das Ziel eine FastCGI-Regel, wird das Skript ausgeführt; darüber laufen die Front-Controller von WordPress und Nextcloud.

  • Flags: R=301 bis R=308, L, NC, QSA und P (Ziel direkt weiterleiten, auch ws:// und wss://).
  • RewriteCond: Request-, Host-, Client-, Zeit- und TLS-Variablen, %{HTTP:Kopfzeile}, %{ENV:NAME}, Datei-Tests -f, -d, -s und lexikografische Vergleiche. Der TestString darf Variablen und Text mischen.
  • RewriteMap: txt:, rnd:, rr: (Round-Robin), int: und prg:. Ein prg:-Helfer läuft dauerhaft, wird nach einem Absturz neu gestartet und hat 5 Sekunden Zeit für eine Antwort; danach gilt der Vorgabewert.
  • Redirect und RedirectMatch: Präfix- bzw. Regex-Treffer mit Rückverweisen, Status als Schlüsselwort oder Zahl.
RewriteEngine on
RewriteCond   %{REQUEST_FILENAME}  !-f
RewriteCond   %{REQUEST_FILENAME}  !-d
RewriteRule   ^/(.*)$              /index.php  [L]

RewriteMap    ziele  txt:/etc/wowa-edge/ziele.txt
RewriteRule   ^/go/(.*)$  https://${ziele:$1|www}.example.org/  [R=302,L]

RedirectMatch 301 ^/blog/(.*)$ https://blog.example.org/$1

Makros, Bedingungen und Variablen

<Macro> und Use erzeugen parametrisierte Blöcke, auch über Include-Grenzen hinweg. Define setzt Präprozessor-Variablen, die als ${NAME} überall eingesetzt werden. <IfDefine>, <IfModule> und <IfVersion> werden beim Einlesen ausgewertet.

<Macro Kunde $name>
    ServerName    $name.example.org
    DocumentRoot  /srv/www/$name
</Macro>

<VirtualHost *:443>
    Use Kunde alpha
    ACMEAutoCert on
</VirtualHost>

SetEnv, SetEnvIf, SetEnvIfNoCase und BrowserMatch setzen Variablen für eine Anfrage. Sie stehen in RewriteCond, in bedingten Kopfzeilen, im Log-Format und als Bedingung an CustomLog bereit.

.htaccess

wowa-edge liest .htaccess selbst. Wie bei Apache 2.4 ist das ausgeschaltet, bis AllowOverride Klassen freigibt: AuthConfig, FileInfo, Indexes, Limit und Options, einzelne Direktiven über AllowOverrideList. Rewrites arbeiten im Verzeichniskontext mit RewriteBase.

  • Änderungen greifen ohne Neuladen; je Verzeichnisebene werden Grösse und Änderungszeit geprüft.
  • Eine unbekannte oder nicht freigegebene Direktive ergibt eine Warnung, die Seite bleibt erreichbar. Mit HtaccessStrict on antwortet wowa-edge wie Apache mit 500.
  • Die Datei selbst ist nie abrufbar.

Konfiguration prüfen

wowa-edge -t liest und prüft die ganze Konfiguration, ohne zu starten. Ein Regex-Muster, das sich nicht übersetzen lässt, ist ein Fehler. Gewarnt wird unter anderem bei Proxy-Regeln, die nie erreicht werden, bei unbekannten Variablen in RewriteCond und bei zwei Require ip-Zeilen in einem <RequireAll>, die zusammen nie zutreffen.

wowa-edge -c /etc/wowa-edge/wowa-edge.conf -t

Abweichungen zu Apache

Diese Direktiven werden angenommen, verhalten sich aber anders als bei Apache:

  • Mehrere passende Abschnitte: Jeder passende <Location>-, <Directory>- oder <Files>-Abschnitt muss zustimmen. Ein Abschnitt kann Schutz hinzufügen, aber keinen wegnehmen. Bei Apache ersetzt der innerste die äusseren.
  • HTTPS als Vorgabe: Ein Host auf einem Klartext-Port wird auf HTTPS umgeleitet, ausser es gibt einen passenden Port-Selektor oder <VirtualHost _default_:PORT>.
  • Pfade: Punktsegmente und doppelte Schrägstriche werden immer aufgelöst; das ist nicht abschaltbar. Was über die Wurzel hinausführt, ergibt 400. Steuerzeichen in Pfad oder Kopfzeilen ergeben ebenfalls 400.
  • FastCGI: PATH_INFO wird am Skript-Ende abgetrennt (/index.php/foo ergibt PATH_INFO=/foo).
  • Kompression: AddOutputFilterByType wirkt auf den ganzen VirtualHost, nicht auf den Pfad einer <Location>.
  • .htaccess: Unbekannte Direktiven ergeben eine Warnung statt 500, ausser mit HtaccessStrict on.
  • Protokolle: %D hat Millisekunden-Auflösung, %>s wird wie %s behandelt. LogLevel kennt keine Modul-Selektoren.
  • Prozessmodell: Es gibt keine ladbaren Module und kein User/Group; das Dienstkonto setzt die systemd-Unit.

Nicht vorhanden sind unter anderem Digest-, LDAP- und Formular-Authentifizierung, RewriteMap dbm: und dbd:, Content-Negotiation und SSI.

Umstieg von Apache

Das Werkzeug apache-migrate liest eine bestehende Apache-2.4-Konfiguration und schreibt eine wowa-edge-Konfiguration in ein eigenes Verzeichnis. Am System ändert es nichts. Die Dateistruktur bleibt erhalten: jede Apache-Datei bekommt ihr Gegenstück, die Include-Zeilen zeigen auf die neuen Namen.

apache-migrate -s /etc/apache2 -o /tmp/umstieg -r /tmp/umstieg
wowa-edge -c /tmp/umstieg/wowa-edge.conf -t

Das eigentliche Ergebnis ist der Bericht MIGRATION.md. Er listet mit Datei, Zeile und Begründung, was unverändert übernommen, was angepasst und was nicht übertragbar ist. <IfModule> wird gegen die geladenen Module ausgewertet, <IfDefine> gegen die gesetzten Server-Flags. Gefundene .htaccess-Dateien werden aufgeführt; sie müssen nicht übersetzt werden.

Typische Anpassungen:

  • SSLEngine on entfällt; TLS kommt über Listen 443 ssl.
  • SSLCertificateChainFile entfällt; die Kette gehört in SSLCertificateFile.
  • Order, Allow und Deny werden auf Require umgestellt.
  • PHP über SetHandler wird zu ProxyPassMatch "\.php$" "fcgi://…".

Zurück zur Übersicht wowa-edge. Weiter mit Protokolle und Zertifikate.

Kontakt

Fragen zu Konfiguration und Umstieg von Apache?

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