Logging

Das Live-Log zeigt jede Anfrage, die über die Node läuft, in Echtzeit: wer gekommen ist, auf welche Domain, was das Backend geantwortet hat und wie lange das gedauert hat. So erkennen Sie am schnellsten, was gerade mit Ihrem Traffic geschieht — ohne Zugriff auf das Backend und ohne Dateien auszuwerten.

Das Log wird nicht auf die Festplatte geschrieben: Die Node liefert die Zeilen nur an diejenigen aus, die in diesem Moment die Ansichtsseite geöffnet haben. Wir sehen und speichern Ihren Traffic nicht — das Log existiert nur auf Ihrer Node.

Aktivieren#

Standardmäßig ist das Log deaktiviert. Es wird über Umgebungsvariablen in der Datei /opt/wafclient/.env auf der Node aktiviert.

Verbinden Sie sich per SSH mit der Node und fügen Sie in /opt/wafclient/.env Folgendes hinzu:

LOGROUTE=/my-secret-log
LOGUSER=admin
LOGPASS=strong-password

Starten Sie den Dienst neu:

systemctl restart privateflare

Öffnen Sie im Browser die Adresse des Logs auf einer beliebigen Domain, die diese Node bedient:

https://ihre-domain.com/my-secret-log

Der Browser fragt nach Login und Passwort — geben Sie die Werte von LOGUSER und LOGPASS ein.

Variable	Beschreibung	Standard
`LOGROUTE`	Adresse der Log-Seite. Ist sie nicht gesetzt, ist das Log deaktiviert	deaktiviert
`LOGUSER`	Login	`log`
`LOGPASS`	Passwort	`log`
`LOGFORMAT`	Zeilenformat: `json` oder Text	Text

Wichtig: Die Log-Seite ist auf jeder Domain der Node erreichbar. Legen Sie ein eigenes Passwort und anstelle von /log eine nicht offensichtliche Adresse fest — die Standardwerte sind allgemein bekannt.

Ansichtsseite#

Auf der Seite erscheinen neue Anfragen sofort, ohne Neuladen:

Der Indikator links zeigt den Zustand der Verbindung: Grün bedeutet, dass das Log eintrifft. Bei einem Verbindungsabbruch verbindet sich die Seite automatisch neu.
Der Filter lässt nur Zeilen mit dem angegebenen Text stehen — zum Beispiel eine Domain, eine IP oder einen Antwortcode.
Autoscroll scrollt das Log zu den neuen Zeilen. Deaktivieren Sie die Option, um einen bestimmten Ausschnitt in Ruhe zu untersuchen.

Die Seite behält die letzten 2000 Zeilen. Eine Ansichtssitzung ist 24 Stunden gültig, danach muss die Seite erneut geöffnet werden.

Zeilenformat#

Text (Standard)#

Das Format ähnelt dem Access-Log von Nginx:

203.0.113.7 - DE [04/Oct/2026:12:30:15 +0000] "GET https://example.com/landing HTTP/2.0" 200 "https://google.com/" "Mozilla/5.0 ..." rt=0.142 uct=0.118

Feld	Bedeutung
`203.0.113.7`	IP des Besuchers
`DE`	Land des Besuchers
`[04/Oct/2026:12:30:15 +0000]`	Zeitpunkt der Anfrage
`"GET https://example.com/landing HTTP/2.0"`	Methode, vollständige Adresse und Protokoll
`200`	Antwortcode
`"https://google.com/"`	Referer
`"Mozilla/5.0 ..."`	User-Agent
`rt`	Gesamte Verarbeitungszeit der Anfrage, in Sekunden
`uct`	Antwortzeit des Backends, in Sekunden. `-`, wenn die Anfrage das Backend nicht erreicht hat

JSON#

Setzen Sie LOGFORMAT=json, wenn das Log von einem Skript oder einem externen System gelesen wird:

{"time":"2026-10-04T12:30:15Z","status":200,"duration_ms":142,"backend_ms":118,"ip":"203.0.113.7","geo":"DE","method":"GET","host":"example.com","path":"/landing","ua":"Mozilla/5.0 ...","proto":"HTTP/2.0","tls":true}

Feld	Bedeutung
`time`	Zeitpunkt der Anfrage
`status`	Antwortcode
`duration_ms`	Gesamte Verarbeitungszeit der Anfrage, in Millisekunden
`backend_ms`	Antwortzeit des Backends, in Millisekunden. `null`, wenn die Anfrage das Backend nicht erreicht hat
`ip`	IP des Besuchers
`geo`	Land des Besuchers
`method`	HTTP-Methode
`host`	Domain
`path`	Pfad der Anfrage
`ua`	User-Agent
`proto`	Protokoll
`tls`	`true` — die Anfrage kam über HTTPS

Ein Vergleich von duration_ms und backend_ms (oder rt und uct) zeigt schnell, wo die Zeit verloren geht: im Backend oder auf dem Weg dorthin.

Was nicht im Log erscheint#

Anfragen des PrivateFlare-Dienstbots (Verfügbarkeitsprüfungen der Domains) — damit das Log übersichtlich bleibt.
Anfragen, die vor dem Öffnen der Seite gestellt wurden: Das Log speichert keinen Verlauf.

Deaktivieren#

Entfernen Sie die Zeile LOGROUTE aus /opt/wafclient/.env und starten Sie den Dienst neu:

systemctl restart privateflare

Log des Dienstes selbst#

Meldungen des Clients zu Start und Fehlern werden in das Systemjournal geschrieben. Anzeigen können Sie sie mit dem Befehl:

journalctl -u privateflare -f