Betrieb
wowa-edge läuft als systemd-Dienst. Konfiguration, Zertifikate und neue VirtualHosts lassen sich im laufenden Betrieb übernehmen, Protokolle werden ohne Neustart gewechselt, und eine Verwaltungsschnittstelle über HTTP liefert Kennzahlen und steuert den Dienst.
Installation
- Pakete: RPM und DEB für openSUSE, Fedora, Debian und Ubuntu, zusammen mit dem eigenen OpenSSL-Paket. Konfiguration, Zertifikate und Protokolle bleiben beim Update unangetastet.
- Installationsprogramm:
install-wowa-edgeerkennt Erstinstallation und Update. Bei der Erstinstallation legt es Verzeichnisse und Unit an und erzeugt aus wenigen Fragen eine lauffähige Konfiguration; als TLS-Modus stehen interne CA, Let’s Encrypt, selbstsigniert oder kein TLS zur Wahl. Beim Update ersetzt es nur das Programm und auf Wunsch die Unit.--yesläuft ohne Rückfragen,--uninstallentfernt.
wowa-edge -c /etc/wowa-edge/wowa-edge.conf -t
systemctl enable --now wowa-edge
journalctl -u wowa-edge -f
Der Start bricht ab, wenn ein Port belegt ist, und nennt den Prozess, der ihn hält, etwa einen noch laufenden Apache. Ebenso bricht er ab, wenn schon eine Instanz läuft; eine verwaiste PID-Datei hält ihn nicht auf.
Signale und Neuladen
SIGHUP(systemctl reload wowa-edge): Die Konfiguration wird neu gelesen und geprüft. Ist sie fehlerhaft, bleibt die laufende aktiv. Sonst entsteht ein vollständiger neuer Stand, der in einem Zug eingewechselt wird. Laufende Anfragen arbeiten auf dem alten Stand zu Ende; er wird erst freigegeben, wenn keine Anfrage mehr auf ihm läuft. Neu geladen werden DocumentRoot, Rewrites, Redirects, Protokollziele, Zertifikate und neue VirtualHosts.SIGUSR1: Protokolldateien neu öffnen, für die Rotation von aussen.SIGTERM: geordnet herunterfahren.
Einen Neustart brauchen neue Listen-Ports, die Thread-Pools, H2WebSockets, H3WebSockets, ServerTokens und die SSLProxy*-Direktiven.
Protokolle
- Fehlerprotokoll global und je VirtualHost. Im Protokoll des VirtualHosts stehen auch Proxy- und Backend-Fehler, Zertifikatsereignisse und abgebrochene Datenströme.
- Zugriffsprotokoll je VirtualHost im Apache-Format:
common,combinedoder eigeneLogFormat-Namen, je Kontext. MehrereCustomLogje VirtualHost, jedes mitenv=- oderexpr=-Bedingung. LogLevelserver-global und je VirtualHost, sodass ein einzelner Host ausführlich protokollieren kann.- Rotation: wowa-edge rotiert seine Dateien selbst nach Grösse. Für Kompression und Aufräumen liegt eine logrotate-Konfiguration bei, die umbenennt und danach
SIGUSR1schickt.copytruncateist nicht nötig. - Die Zeilen werden zusätzlich ins systemd-Journal gespiegelt.
SetEnvIf Request_URI "^/health$" keinlog
CustomLog /var/log/wowa-edge/access.log combined env=!keinlog
CustomLog /var/log/wowa-edge/fehler.log combined "expr=%{REQUEST_STATUS} >= '400'"
EdgeAPI
Die EdgeAPI ist ein Handler in einem VirtualHost, kein eigener Listener. Sie erbt dessen TLS-Politik, Zugriffsschutz und Protokolle. Empfohlen ist ein eigener VirtualHost auf einem internen Namen und einer internen Adresse.
<VirtualHost 192.0.2.10:9443>
ServerName api.example.org
SSLCertificateFile /etc/wowa-edge/certs/api.crt
SSLCertificateKeyFile /etc/wowa-edge/certs/api.key
EdgeAPI /api
EdgeAPILevel control
<Location /api>
Require ip 192.0.2.0/24
</Location>
</VirtualHost>
Die Stufen bauen aufeinander auf:
status(Vorgabe): Kennzahlen und Balancer-Mitglieder lesen.control: zusätzlich VirtualHosts auflisten und ihren Text lesen, Neuladen auslösen, Protokolle neu öffnen, Balancer-Mitglieder setzen.config: zusätzlich VirtualHost-Blöcke schreiben und löschen.off: aus.
Die Stufen control und config verlangen einen Zugriffsschutz auf dem Pfad, sonst lehnt wowa-edge -t die Konfiguration ab.
Kennzahlen
GET <präfix>/status liefert Fassung, Laufzeit, Anfragen gesamt und aktiv, die Aufteilung des Speichers, die Generation der Konfiguration und den letzten Konfigurationsfehler. Das Format ist JSON, eine HTML-Seite für Browser oder auf Anforderung der Stil von mod_status.
Neuladen über HTTP
POST <präfix>/reload und POST <präfix>/reopen-logs brauchen den Kopf X-EdgeAPI: 1 und antworten mit 202: der Hauptlauf führt den Auftrag aus, an derselben Stelle wie bei SIGHUP. Ob der neue Stand gilt, zeigt config_generation; sie steigt erst, wenn er eingewechselt ist. Bei einem Fehler bleibt sie stehen, und der Grund steht in config_last_error.
curl -s -X POST -H 'X-EdgeAPI: 1' https://api.example.org/api/reload
curl -s "https://api.example.org/api/status?format=json"
VirtualHosts lesen und ändern
GET <präfix>/vhosts listet alle VirtualHosts mit Datei und Zeilen. GET <präfix>/vhosts/<name> liefert den Blocktext aus der Originaldatei mit ETag, PUT ersetzt ihn, DELETE entfernt ihn. Im Browser gibt es dafür einen Editor.
- Nur der Zeilenbereich des Blocks wird ersetzt; Kommentare und der Rest der Datei bleiben bytegleich.
- Schreiben verlangt
If-Matchmit demETagder ganzen Datei. Fehlt es, kommt 428, ist es veraltet, 409. - Gesendet werden darf genau ein
<VirtualHost>-Block, nichts ausserhalb. - Vor dem Umschalten entsteht eine Sicherungskopie, danach wird die ganze Konfiguration geprüft. Scheitert die Prüfung, wird zurückgerollt und mit 400 geantwortet.
- VirtualHosts aus
<Macro>werden am Makro geändert, nicht über die Schnittstelle.
Die Balancer-Endpunkte sind unter Reverse-Proxy und Lastverteilung beschrieben.
Zertifikate zwischen Knoten abgleichen
Zeigt die öffentliche Namensauflösung für einen Namen auf einen anderen Knoten, kann der eigene Knoten für diesen Namen kein ACME-Zertifikat beschaffen. Der Server-Abgleich holt es dann vom Knoten, der es hat. Beide Rollen sind server-global.
# auf dem Knoten, der das Zertifikat hat
<AbgleichQuelle>
Listen 192.0.2.10:8443
ClientCA /etc/wowa-edge/certs/abgleich-ca.pem
Zertifikat cloud.example.org
</AbgleichQuelle>
# auf dem Knoten, der es braucht
<Abgleich>
Quelle https://abgleich.example.org:8443/
CAFile /etc/wowa-edge/certs/abgleich-ca.pem
ClientCert /etc/wowa-edge/certs/knoten2.crt.pem
ClientKey /etc/wowa-edge/certs/knoten2.key.pem
Intervall 3600
Zertifikat cloud.example.org
</Abgleich>
- Die Quelle bindet einen eigenen Listener an eine feste Adresse, verlangt Client-Zertifikate und hat keinen Schreibpfad. Ausgeliefert wird nur, was benannt ist; die Antwort unterscheidet nicht zwischen «gibt es nicht» und «nicht freigegeben».
- Der Abonnent prüft Kette und Namen der Quelle. Er holt erst, wenn sich der Fingerabdruck ändert, und übernimmt nur ein Zertifikat, das benutzbar ist, den Namen deckt und später abläuft als das vorhandene.
- Geschrieben wird daneben, geprüft und erst dann umbenannt; der Schlüssel bekommt
0600. Danach lädt der Abonnent das Zertifikat für den Namen und alle Aliasse nach. - Jede Auslieferung, Ablehnung und Übernahme steht im Protokoll, nie das Schlüsselmaterial.
Übernommen werden Zertifikate. Ein eingetragener VHost-Gegenstand wird mit einer Meldung übersprungen.
Dimensionierung
Die Thread-Pools und Verbindungsgrenzen sind server-global: NetworkThreads, DataThreads, TLSThreads, MaxConnections, MaxConnectionsPerIP, ListenBacklog. Eine Anfrage belegt ihren Data-Thread bis zum Ende, auch während sie auf ein Backend wartet. Bei vielen langsamen Backends gehört DataThreads deutlich über die Zahl der Kerne. Die geltenden Werte stehen beim Start in der Zeile MPM:.
Antworten an langsame Clients gehen über einen Schreibpuffer (ClientWriteBufferMax); wer ClientWriteStallTimeout lang nichts abholt, wird getrennt. KeepAliveTimeout schliesst stille Verbindungen, server-global und je VirtualHost.
Diagnose
wowa-edge -tprüft die Konfiguration,-vnennt Fassung und Bau-Kennung.- Selbstauskunft im Protokoll: Auf
LogLevel noticemelden sich Speicher-Aufräumer, TLS-Bilanz, Verbindungsbestand und abgebaute Backend-Verbindungen regelmässig, auch wenn nichts zu tun war. - Abgebrochene Verbindungen: Endet eine HTTP/2- oder HTTP/3-Verbindung nicht sauber, steht eine Warnung mit Fehlercode im Protokoll; bei HTTP/2 mit der Zahl der offenen Ströme, bei HTTP/3 mit Rundlaufzeit und Verlusten.
- Spuren über Umgebungsvariablen:
WOWA_CONN_TRACE=1zeigt jeden Verbindungsaufbau zum Backend,WOWA_H2_TRACE=1Beginn und Ende jedes HTTP/2-Stroms. Ein Beginn ohne passendes Ende zeigt den Strom, der nie abgeschlossen wurde, auch wenn das Zugriffsprotokoll ihn als erledigt führt.WOWA_QLOG_DIRschreibt qlog für QUIC. - Diagnosebau: Ein eigener Bau meldet über
MemoryCensusIntervalden Bestand der internen Register.
Die mitgelieferte Unit setzt MALLOC_ARENA_MAX=8; ein Speicher-Aufräumer gibt freien Speicher in einem lastabhängigen Takt an das System zurück und meldet jedes Mal, wie viel.
Zurück zur Übersicht wowa-edge. Davor: Sicherheit.
Fragen zu Betrieb?
Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.