Proxy Flowsery Analytics avec Caddy
Faites transiter Flowsery Analytics via Caddy afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs plus précises. La configuration très directe de Caddy rend cette mise en place particulièrement simple.
1. Configuration Caddy de base
Ajoutez les directives suivantes à votre Caddyfile :
your_domain.com {
# Proxy the analytics script
handle /js/main.js {
reverse_proxy https://analytics.flowsery.com {
header_up Host {upstream_hostport}
header_up X-Real-IP {remote_host}
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto {scheme}
}
# Cache the script for 1 year
header Cache-Control "public, max-age=31536000"
header Expires "1y"
}
# Proxy the event collection endpoint + forward real visitor IP
handle /api/track {
reverse_proxy https://analytics.flowsery.com {
header_up Host {upstream_hostport}
# CRITICAL: Flowsery reads this header as the real visitor IP.
# Without it, every visitor resolves to your server's region.
# Replace {remote_host} with {http.request.header.Cf-Connecting-Ip}
# if Caddy sits behind Cloudflare.
header_up x-flowsery-real-ip {remote_host}
header_up X-Real-IP {remote_host}
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto {scheme}
}
}
# Your other site directives...
}Remarque : si votre serveur utilise déjà un chemin /api/track, ajoutez data-api à la balise script Flowsery Analytics pour envoyer les événements ailleurs. Par exemple, data-api="/flowsery-events" envoie les données vers /flowsery-events.
Important : si tous les visiteurs apparaissent au même endroit dans votre tableau de bord, vérifiez que x-flowsery-real-ip est bien défini sur la vraie IP du visiteur (et non celle du serveur proxy) lors du transfert des requêtes vers le endpoint /events de Flowsery Analytics.
2. Optionnel : activer le cache
Pour de meilleures performances, vous pouvez ajouter une couche de cache :
your_domain.com {
# Cache settings
cache {
path /var/cache/caddy
ttl 1y
capacity 10GB
}
handle /js/main.js {
cache
reverse_proxy https://analytics.flowsery.com {
header_up Host {upstream_hostport}
header_up X-Real-IP {remote_host}
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto {scheme}
}
header Cache-Control "public, max-age=31536000"
header Expires "1y"
}
# ... remainder of the configuration
}3. Modifier la balise script
Remplacez le snippet Flowsery Analytics par la version proxifiée :
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script># Validate the configuration
caddy validate
# If validation passes, reload Caddy
caddy reloadVérifier que cela fonctionne
Pour valider le bon fonctionnement du proxy :
- Ouvrez votre site web
- Ouvrez les outils de développement de votre navigateur et passez à l'onglet Réseau
- Vérifiez que les requêtes analytics sont servies depuis votre domaine plutôt que depuis analytics.flowsery.com
Caddy gère automatiquement les certificats HTTPS et HTTP/2, ce qui en fait un très bon choix pour proxifier l'analytics. Vérifiez aussi que votre serveur Caddy dispose d'un espace disque suffisant si vous activez le cache.
Dépannage
Tous les visiteurs apparaissent au même endroit
Lorsque tous les visiteurs affichent une seule localisation géographique, comme la région de votre serveur, le proxy ne transmet pas correctement les vraies IP des visiteurs.
Résolution :
- Assurez-vous que votre proxy définit
x-flowsery-real-ipsur la vraie IP du visiteur (et non l'IP du serveur) lors du transfert des requêtes vers le endpoint/eventsde Flowsery Analytics. - Si Caddy est derrière Cloudflare ou un autre edge,
{remote_host}sera l'IP du proxy amont, pas celle du visiteur. Utilisez{http.request.header.Cf-Connecting-Ip}(Cloudflare) ou{http.request.header.X-Real-Ip}(générique) à la place.