Journalisation

Le journal en direct affiche en temps réel chaque requête qui passe par le noeud : qui est venu, sur quel domaine, ce que le backend a répondu et combien de temps cela a pris. C’est le moyen le plus rapide de comprendre ce qui arrive à votre trafic à l’instant présent — sans accès au backend et sans analyse de fichiers.

Le journal n’est pas écrit sur le disque : le noeud ne transmet les lignes qu’aux personnes qui ont la page de consultation ouverte à ce moment-là. Nous ne voyons pas et ne conservons pas votre trafic — le journal n’existe que sur votre noeud.

Comment l’activer#

Par défaut, le journal est désactivé. Il s’active à l’aide de variables d’environnement dans le fichier /opt/wafclient/.env sur le noeud.

Connectez-vous au noeud par SSH et ajoutez dans /opt/wafclient/.env :

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

Redémarrez le service :

systemctl restart privateflare

Ouvrez dans un navigateur l’adresse du journal sur n’importe quel domaine desservi par ce noeud :

https://votre-domaine.com/my-secret-log

Le navigateur demandera un identifiant et un mot de passe — saisissez les valeurs de LOGUSER et LOGPASS.

Variable	Description	Par défaut
`LOGROUTE`	Adresse de la page du journal. Si elle n’est pas définie, le journal est désactivé	désactivé
`LOGUSER`	Identifiant	`log`
`LOGPASS`	Mot de passe	`log`
`LOGFORMAT`	Format des lignes : `json` ou texte	texte

Important : la page du journal est accessible sur n’importe quel domaine du noeud. Définissez votre propre mot de passe et une adresse difficile à deviner à la place de /log — les valeurs par défaut sont connues de tous.

Page de consultation#

Sur la page, les nouvelles requêtes apparaissent immédiatement, sans actualisation :

L’indicateur à gauche montre l’état de la connexion : vert — le journal est reçu. En cas de coupure, la page se reconnecte automatiquement.
Le filtre ne conserve que les lignes contenant le texte indiqué — par exemple un domaine, une IP ou un code de réponse.
Autoscroll fait défiler le journal jusqu’aux nouvelles lignes. Désactivez-le pour examiner tranquillement le passage qui vous intéresse.

La page conserve les 2000 dernières lignes. La session de consultation est valable 24 heures, après quoi il faut rouvrir la page.

Format des lignes#

Texte (par défaut)#

Le format est proche du journal d’accès de 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

Champ	Signification
`203.0.113.7`	IP du visiteur
`DE`	Pays du visiteur
`[04/Oct/2026:12:30:15 +0000]`	Heure de la requête
`"GET https://example.com/landing HTTP/2.0"`	Méthode, adresse complète et protocole
`200`	Code de réponse
`"https://google.com/"`	Referer
`"Mozilla/5.0 ..."`	User-Agent
`rt`	Durée totale de traitement de la requête, en secondes
`uct`	Temps de réponse du backend, en secondes. `-` si la requête n’a pas atteint le backend

JSON#

Définissez LOGFORMAT=json si le journal est lu par un script ou un système externe :

{"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}

Champ	Signification
`time`	Heure de la requête
`status`	Code de réponse
`duration_ms`	Durée totale de traitement de la requête, en millisecondes
`backend_ms`	Temps de réponse du backend, en millisecondes. `null` si la requête n’a pas atteint le backend
`ip`	IP du visiteur
`geo`	Pays du visiteur
`method`	Méthode HTTP
`host`	Domaine
`path`	Chemin de la requête
`ua`	User-Agent
`proto`	Protocole
`tls`	`true` — la requête est arrivée en HTTPS

En comparant duration_ms et backend_ms (ou rt et uct), il est facile de voir où le temps est perdu : sur le backend ou sur le chemin qui y mène.

Ce qui n’apparaît pas dans le journal#

Les requêtes du bot de service PrivateFlare (vérifications de disponibilité des domaines) — afin de ne pas encombrer le journal.
Les requêtes effectuées avant l’ouverture de la page : le journal ne conserve pas d’historique.

Comment le désactiver#

Supprimez la ligne LOGROUTE dans /opt/wafclient/.env et redémarrez le service :

systemctl restart privateflare

Journal du service lui-même#

Les messages du client concernant le démarrage et les erreurs sont écrits dans le journal système. Vous pouvez les consulter avec la commande :

journalctl -u privateflare -f