Prise en main

Cloakiz réunit une console de gestion des flows, un journal des visites et des rapports de trafic. Un flow associe un lien public à une destination et à ses réglages de traitement.

1. Depuis le dossier du projet, démarrez le serveur avec python3 server.py.
2. Ouvrez la console locale et connectez-vous avec le compte configuré sur votre installation.
3. Ouvrez Paramètres → Affichage pour choisir le fuseau utilisé dans les rapports et le journal.

Comptes et permissions

Administrateur

Crée, modifie, duplique et supprime des flows. Peut les mettre en pause et consulter le journal d’audit.

Lecture seule

Utilise le bouton Consulter pour ouvrir la configuration d’un flow. Peut consulter le tableau de bord, le journal et les statistiques.

Gérer les flows

1. Ouvrez Nouveau flow et donnez-lui un nom identifiable. La description interne apparaît dans la liste.
2. Dans Destinations et répartition, saisissez l’URL de destination. Exemple pour un lien de test sur un domaine que vous contrôlez https://exemple.com/accueil.
3. Vérifiez l’état dans l’éditeur. Décochez Pause si le lien doit être mis en ligne, puis enregistrez.

La liste se filtre par nom et par état. Modifier rouvre l’éditeur. Dupliquer crée un brouillon distinct dont vous pouvez modifier les réglages. Retrouvez les changements dans le journal d’audit.

Actif

Le lien traite les nouvelles requêtes.

En pause

Le lien renvoie un HTTP 503 tant que le flow reste en pause.

Brouillon ou archivé

Le lien public est indisponible. Ces états restent visibles dans les filtres de la liste.

Destinations et variantes

Cochez Répartir le trafic entre plusieurs destinations pour ajouter des variantes. Vous pouvez ajouter jusqu’à neuf variantes en plus de la destination A. Indiquez la part des variantes actives. La destination A reçoit le pourcentage restant.

Exemple. Si B reçoit 30 % et C reçoit 20 %, A reçoit 50 %. Ces pourcentages s’appliquent au tirage de chaque requête. Sur un petit nombre de visites, la répartition observée peut s’écarter de ces proportions.

Avec Conserver les paramètres de l’URL, les paramètres reçus suivent la redirection, hors paramètres internes. Si un nom existe aussi dans l’URL de destination, la valeur de la destination est prioritaire.

Lien et actions de redirection

Après l’enregistrement, ouvrez Lien et autres formats dans le panneau d’intégration pour copier le lien du flow ou télécharger le lien HTML. Pour une redirection classique sur un site que vous gérez, choisissez l’action selon le comportement attendu.

HTTP 302

Redirection temporaire courante pour un lien ouvert dans un navigateur.

HTTP 307

Redirection temporaire qui conserve la méthode HTTP.

Redirection JavaScript

Le serveur renvoie une page HTML et le navigateur effectue la navigation lorsque JavaScript est disponible.

Vérifier un flow

1. Enregistrez le flow et les changements en cours.
2. Dans Vérification du flow, cliquez sur Lancer le diagnostic.
3. Lisez le code HTTP et le motif. Quand une destination est prévue, vérifiez aussi son URL et sa variante.

Le diagnostic utilise la configuration enregistrée et ne crée aucune entrée dans le journal. Le bouton Ouvrir le lien réel déclenche une requête normale que vous pouvez retrouver dans le journal.

Lire le tableau de bord

Aujourd’hui commence à minuit dans le fuseau configuré. Survolez ou touchez le graphique horaire pour afficher les visites et les redirections de l’heure. Au clavier, placez le focus sur le graphique et utilisez les flèches. Le tableau Voir les chiffres par heure donne les mêmes valeurs.

Trafic par jour affiche jusqu’à sept dates, avec une mention pour le jour encore incomplet. Le récapitulatif 7 jours couvre une fenêtre glissante. Cette fenêtre peut commencer sur une date partielle plus ancienne que les sept dates affichées.

Utiliser le journal des visites

Le journal affiche jusqu’à 30 visites par page. Sélectionnez une date pour consulter une journée dans le fuseau du compte. Le filtre Résultat s’applique à toute la période du journal. Utilisez Détails pour consulter le résultat, le statut HTTP et les données disponibles pour une visite.

Le menu Colonnes permet de choisir les champs du tableau, notamment Appareil, Système et Navigateur. Ce choix est mémorisé dans votre navigateur. Sur un écran étroit, ouvrez Détails depuis la liste compacte.

Pour examiner une entrée sans qu’elle se déplace pendant la lecture, désactivez Actualisation auto. Une valeur manquante indique que le journal ne dispose pas de cette donnée pour la visite.

Statistiques et export CSV

Choisissez un regroupement Par jour, Par pays, Par système, Par navigateur ou Par flow. Le filtre Flow s’applique dans chaque regroupement. Une date précise couvre la journée dans le fuseau du compte. Pour revenir à une période glissante, choisissez une durée dans le menu Période.

Visites et visites uniques

Nombre de requêtes retenues et nombre d’adresses IP distinctes enregistrées dans le groupe.

Redirections et redirections uniques

Nombre de requêtes redirigées et nombre d’adresses IP distinctes parmi ces requêtes.

Taux de redirection

Redirections divisées par les visites. Par exemple, 25 redirections sur 100 visites donnent 25 %.

Cliquez sur un en-tête pour trier la colonne, puis cliquez à nouveau pour inverser le tri. Exporter en CSV reprend le tableau filtré, avec ses colonnes et son ordre. Réinitialiser revient aux sept derniers jours, par jour et tous flows confondus.

Le rapport exclut les tests et les préchargements. Pour expliquer un écart avec le tableau de bord, comparez la période, le fuseau et les exclusions indiqués sur chaque écran.

Paramètres et administration

Affichage règle le fuseau horaire des graphiques, de la sélection par date et du journal. Le changement s’applique au compte connecté.

État des données indique la disponibilité des bases utilisées par la console. Quota ProxyCheck affiche la consommation sur une fenêtre glissante de 24 heures. Le Journal d’audit, réservé aux administrateurs, retrace les opérations de gestion comme les modifications, les duplications et les changements de fuseau.

Dépannage

Le diagnostic est indisponible

Enregistrez le flow et les modifications en cours, puis relancez le diagnostic.

Le lien renvoie un HTTP 503

Vérifiez si le flow est en pause. Si le flow doit être actif, remettez-le en ligne et vérifiez le résultat.

Une visite manque dans le journal

Vérifiez la période et le filtre Résultat, puis actualisez. Un diagnostic n’ajoute aucune visite.

Le tableau de statistiques est vide

Essayez Réinitialiser pour revenir à une période plus large et inclure tous les flows. Vérifiez ensuite la date dans le fuseau du compte.

Le nom du navigateur ou de l’appareil manque

Consultez les détails de la visite. Certaines requêtes n’apportent pas assez d’informations pour identifier le navigateur ou l’appareil.

API de consultation

Ces routes JSON s’utilisent sur l’adresse de votre installation avec une session Cloakiz authentifiée. Les routes de la console renvoient un HTTP 401 lorsque la session manque ou expire.

GET /api/me

Rôle de la session et adresse publique configurée.

GET /api/flows et GET /api/flows/{id}

Liste des flows ou configuration d’un flow.

GET /api/profile

Préférences et fuseau horaire du compte connecté.

GET /api/visits?period=today&limit=30

Les 30 dernières visites depuis minuit dans le fuseau du compte. Le paramètre flow_id peut limiter la liste à un flow.

GET /api/stats?days=7

Totaux par résultat, séries quotidiennes et répartition par variante.

GET /api/stats/report?group=country&days=7

Rapport agrégé par pays sur sept jours. Les valeurs de group sont day, country, os, browser et flow. Utilisez date=AAAA-MM-JJ pour une journée précise et flow_id pour filtrer par flow.