Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met Nginx

Stuur Flowsery Analytics via Nginx, zodat adblockers er niet tussen komen en je nauwkeurige bezoekersdata verzamelt. Deze handleiding geldt voor een losse Nginx en voor Nginx als reverse proxy voor een applicatieserver.

De setup heeft twee essentiële onderdelen: een proxy_pass die events first-party maakt (bestand tegen adblockers) en een proxy_set_header x-flowsery-real-ip die het echte IP-adres van de bezoeker door de proxystap draagt, zodat Flowsery de locatie van de bezoeker bepaalt en niet die van je server.

1. Basisconfiguratie van Nginx

Voeg deze location-blokken toe in /etc/nginx/sites-available/your-site of /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;
}

Draait Nginx achter Cloudflare (of een andere edge), dan is $remote_addr het IP-adres van de CDN-edge en niet dat van de bezoeker. Gebruik in dat geval de real-IP-header van het 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;

Let op: bedient je server /api/track al, kies dan een ander pad en geef dat aan de tracker door met data-api="/flowsery-events".

2. Optioneel: caching voor het script inschakelen

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. De scripttag aanpassen

Vervang het Flowsery Analytics-fragment door de geproxyde versie:

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

Controleren of het werkt

  1. Open je site in een gewoon browsertabblad.
  2. DevTools → Network, filter op /api/track. Controleer dat de verzoeken naar je eigen domein gaan.
  3. Controleer in je Flowsery-dashboard dat de landen van bezoekers bij je publiek passen en niet bij je hostingregio.

Probleemoplossing

Elke bezoeker lijkt van dezelfde locatie te komen

De proxy stuurt events door, maar niet het echte IP-adres van de bezoeker. x-flowsery-real-ip ontbreekt of bevat het IP-adres van je server in plaats van dat van de bezoeker.

  • Controleer dat de regel proxy_set_header x-flowsery-real-ip <value> op /api/track staat en dat de waarde naar de juiste variabele voor jouw edge-setup verwijst ($remote_addr voor direct verkeer, $http_cf_connecting_ip voor Cloudflare, $http_x_real_ip voor een algemene L7-edge).
  • Zit Nginx achter een andere proxy, gebruik dan geen $remote_addr: dat is de upstream-proxy en niet de bezoeker. Gebruik de header die de upstream-proxy toevoegt.