Proxy Flowsery Analytics avec Nginx
Faites transiter Flowsery Analytics via Nginx afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs précises. Ce guide s'applique aussi bien à Nginx autonome qu'à Nginx utilisé comme reverse proxy devant un serveur applicatif.
La configuration repose sur deux éléments essentiels : un proxy_pass qui rend les événements first-party (résistants aux bloqueurs), et un proxy_set_header x-flowsery-real-ip qui transporte la vraie IP du visiteur à travers le saut proxy afin que Flowsery résolve la géolocalisation à partir du visiteur, et non de votre serveur.
1. Configuration Nginx de base
Ajoutez ces blocs location dans /etc/nginx/sites-available/your-site ou /etc/nginx/conf.d/your-site.conf :
# Proxy the analytics script
location /js/main.js {
proxy_pass https://cdn.flowsery.com/main.js;
proxy_set_header Host cdn.flowsery.com;
# Cache the script for 1 year
proxy_cache_valid 200 1y;
add_header Cache-Control "public, max-age=31536000";
expires 1y;
}
# Proxy the event collection endpoint + forward real visitor IP
location /api/track {
proxy_pass https://analytics.flowsery.com/analytics/events;
proxy_set_header Host analytics.flowsery.com;
# CRITICAL: forwards the real visitor IP to the analytics backend.
# Without this, every visitor resolves to your server's location.
proxy_set_header x-flowsery-real-ip $remote_addr;
# Standard forwarding (kept for compatibility with other consumers)
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
# Allow POST requests
proxy_pass_request_body on;
}Si Nginx est derrière Cloudflare (ou un autre edge), $remote_addr est l'IP du CDN edge, pas celle du visiteur. Utilisez plutôt l'en-tête d'IP réelle du CDN :
# Behind Cloudflare: the visitor IP is in $http_cf_connecting_ip
proxy_set_header x-flowsery-real-ip $http_cf_connecting_ip;
# Behind Vercel / Fly.io / a generic L7 proxy
# proxy_set_header x-flowsery-real-ip $http_x_real_ip;Remarque : si votre serveur utilise déjà /api/track, choisissez un autre chemin et indiquez-le au tracker avec data-api="/flowsery-events".
2. Optionnel : activer le cache pour le script
# At the top of your nginx.conf (http {} block)
proxy_cache_path /var/cache/nginx/flowsery_cache levels=1:2 keys_zone=flowsery_cache:10m max_size=10g inactive=60m use_temp_path=off;
# In your server {} block, augment the /js/main.js location
location /js/main.js {
proxy_cache flowsery_cache;
proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504;
proxy_cache_valid 200 1y;
proxy_cache_bypass $http_pragma;
proxy_cache_revalidate on;
# ...rest of the config from step 1
}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>sudo nginx -t # validate config
sudo systemctl reload nginxVérifier que cela fonctionne
- Ouvrez votre site dans un onglet de navigateur classique.
- Dans DevTools → Réseau, filtrez sur
/api/track. Vérifiez que les requêtes partent vers votre propre domaine. - Dans votre tableau de bord Flowsery, vérifiez que les pays des visiteurs correspondent à votre audience, et non à votre région d'hébergement.
Dépannage
Tous les visiteurs apparaissent au même endroit
Le proxy transfère bien les événements, mais pas la vraie IP du visiteur. x-flowsery-real-ip est absent ou contient l'IP de votre serveur au lieu de celle du visiteur.
- Vérifiez que la ligne
proxy_set_header x-flowsery-real-ip <value>est bien présente sur/api/tracket que la valeur pointe vers la bonne variable selon votre configuration edge ($remote_addrpour du trafic direct,$http_cf_connecting_ippour Cloudflare,$http_x_real_ippour un edge L7 générique). - Si Nginx est derrière un autre proxy, n'utilisez pas
$remote_addr: ce sera l'IP du proxy amont, pas celle du visiteur. Utilisez l'en-tête injecté par le proxy amont.