Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met DigitalOcean

Stuur Flowsery Analytics via DigitalOcean om adblockers te omzeilen en nauwkeurigere bezoekersdata te verzamelen. Deze handleiding behandelt zowel App Platform als opstellingen met Droplets.

Optie 1: DigitalOcean App Platform

Draai je op DigitalOcean App Platform met Node.js, gebruik dan de handleiding voor jouw framework:

App Platform stuurt IP-adressen automatisch door via de header X-Forwarded-For, dus de configuraties uit die handleidingen werken zonder aanpassingen.

Optie 2: DigitalOcean Droplet met Nginx

Draai je een DigitalOcean Droplet met Nginx als webserver of reverse proxy, gebruik dan de volgende configuratie.

1. Maak verbinding met je Droplet

Terminal
ssh root@your-droplet-ip

2. Open de Nginx-configuratie

Bewerk het configuratiebestand van je site, bijvoorbeeld /etc/nginx/sites-available/your-site:

Terminal
sudo nano /etc/nginx/sites-available/your-site

3. Voeg de location-blokken voor de proxy toe

Voeg de volgende location-blokken toe aan je serverconfiguratie:

Nginx
server {
    listen 80;
    server_name your_domain.com;
 
    # Your existing configuration...
 
    # Proxy the analytics script
    location /js/main.js {
        proxy_pass https://cdn.flowsery.com/main.js;
        proxy_set_header Host analytics.flowsery.com;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
 
        # Cache the script for 1 year
        add_header Cache-Control "public, max-age=31536000";
        expires 1y;
    }
 
    # Proxy the event collection endpoint
    location /api/track {
        proxy_pass https://analytics.flowsery.com/analytics/events;
        proxy_set_header Host analytics.flowsery.com;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        # CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
        proxy_set_header x-flowsery-real-ip $remote_addr;
 
        # Allow POST requests
        proxy_method POST;
        proxy_pass_request_body on;
    }
 
    # Your other location blocks...
}

Let op: heb je al een location-blok voor /api/track, voeg dan data-api toe aan de scripttag van Flowsery Analytics om events om te leiden. Met data-api="/flowsery-events" gaat de data bijvoorbeeld naar /flowsery-events.

4. Test en herlaad Nginx

Controleer de configuratie op syntaxfouten:

Terminal
sudo nginx -t

Slaagt de test, herlaad Nginx dan:

Terminal
sudo systemctl reload nginx

5. Optioneel: caching inschakelen

Voor betere prestaties stel je een cachezone in Nginx in:

Nginx
# Place this outside the server block (typically at the top of nginx.conf)
proxy_cache_path /var/cache/nginx/flowsery_cache
    levels=1:2
    keys_zone=flowsery_cache:10m
    max_size=100m
    inactive=60m
    use_temp_path=off;
 
# In your server block, update the script 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;
 
    proxy_pass https://cdn.flowsery.com/main.js;
    proxy_set_header Host analytics.flowsery.com;
 
    add_header Cache-Control "public, max-age=31536000";
    expires 1y;
}

Optie 3: DigitalOcean Spaces CDN

Gebruik je DigitalOcean Spaces CDN vóór je Droplet, zorg dan dat het de IP-adressen van clients goed doorstuurt:

  1. Ga in het DigitalOcean-dashboard naar Networking > CDN
  2. Controleer of je CDN is ingesteld om request-headers door te geven
  3. Het CDN voegt automatisch X-Forwarded-For-headers toe
  4. Je Nginx-configuratie haalt de IP-adressen van bezoekers uit die headers

Pas de scripttag aan

Vervang de oorspronkelijke snippet van Flowsery Analytics door de geproxyde versie:

HTML
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>

Controleren of het werkt

Zo controleer je of de proxy goed werkt:

  1. Ga naar je website
  2. Open de ontwikkelaarstools van je browser en ga naar het tabblad Network
  3. Controleer of de analyticsverzoeken vanaf je eigen domein komen in plaats van vanaf analytics.flowsery.com
  4. Kijk in je Flowsery Analytics-dashboard of de locaties van bezoekers kloppen

Problemen oplossen

Alle bezoekers komen vanaf dezelfde locatie

Tonen alle bezoekers één geografische locatie, bijvoorbeeld de regio van je server, dan stuurt de proxy de echte IP-adressen van bezoekers niet goed door.

Oplossing:

  1. Zorg dat je proxy de header x-flowsery-real-ip meestuurt met het echte IP-adres van de bezoeker (niet het IP-adres van de server) wanneer je verzoeken doorstuurt naar het /events-endpoint van Flowsery Analytics
  2. Staat Nginx achter een andere proxy (Cloudflare, Vercel, enz.), dan is $remote_addr het IP-adres van die upstream-proxy: lees in dat geval rechtstreeks $http_cf_connecting_ip of $http_x_real_ip uit