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=301bisR=308,L,NC,QSAundP(Ziel direkt weiterleiten, auchws://undwss://). RewriteCond: Request-, Host-, Client-, Zeit- und TLS-Variablen,%{HTTP:Kopfzeile},%{ENV:NAME}, Datei-Tests-f,-d,-sund lexikografische Vergleiche. Der TestString darf Variablen und Text mischen.RewriteMap:txt:,rnd:,rr:(Round-Robin),int:undprg:. Einprg:-Helfer läuft dauerhaft, wird nach einem Absturz neu gestartet und hat 5 Sekunden Zeit für eine Antwort; danach gilt der Vorgabewert.RedirectundRedirectMatch: 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 onantwortet 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_INFOwird am Skript-Ende abgetrennt (/index.php/fooergibtPATH_INFO=/foo). - Kompression:
AddOutputFilterByTypewirkt auf den ganzen VirtualHost, nicht auf den Pfad einer<Location>. - .htaccess: Unbekannte Direktiven ergeben eine Warnung statt 500, ausser mit
HtaccessStrict on. - Protokolle:
%Dhat Millisekunden-Auflösung,%>swird wie%sbehandelt.LogLevelkennt 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 onentfällt; TLS kommt überListen 443 ssl.SSLCertificateChainFileentfällt; die Kette gehört inSSLCertificateFile.Order,AllowundDenywerden aufRequireumgestellt.- PHP über
SetHandlerwird zuProxyPassMatch "\.php$" "fcgi://…".
Zurück zur Übersicht wowa-edge. Weiter mit Protokolle und Zertifikate.
Fragen zu Konfiguration und Umstieg von Apache?
Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.