Assistance/Guides proxy
Guides proxy

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 :

Nginx
# 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 :

Nginx
# 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

Nginx
# 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 :

HTML
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>
Terminal
sudo nginx -t           # validate config
sudo systemctl reload nginx

Vérifier que cela fonctionne

  1. Ouvrez votre site dans un onglet de navigateur classique.
  2. Dans DevTools → Réseau, filtrez sur /api/track. Vérifiez que les requêtes partent vers votre propre domaine.
  3. 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/track et que la valeur pointe vers la bonne variable selon votre configuration edge ($remote_addr pour du trafic direct, $http_cf_connecting_ip pour Cloudflare, $http_x_real_ip pour 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.