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:
- Next.js-apps: zie de Next.js-proxyhandleiding
- Express.js-apps: zie de Express.js-proxyhandleiding
- Andere Node.js-apps: volg de aanpak voor Express.js
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
ssh root@your-droplet-ip2. Open de Nginx-configuratie
Bewerk het configuratiebestand van je site, bijvoorbeeld /etc/nginx/sites-available/your-site:
sudo nano /etc/nginx/sites-available/your-site3. Voeg de location-blokken voor de proxy toe
Voeg de volgende location-blokken toe aan je serverconfiguratie:
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:
sudo nginx -tSlaagt de test, herlaad Nginx dan:
sudo systemctl reload nginx5. Optioneel: caching inschakelen
Voor betere prestaties stel je een cachezone in Nginx in:
# 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:
- Ga in het DigitalOcean-dashboard naar Networking > CDN
- Controleer of je CDN is ingesteld om request-headers door te geven
- Het CDN voegt automatisch
X-Forwarded-For-headers toe - 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:
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>Controleren of het werkt
Zo controleer je of de proxy goed werkt:
- Ga naar je website
- Open de ontwikkelaarstools van je browser en ga naar het tabblad Network
- Controleer of de analyticsverzoeken vanaf je eigen domein komen in plaats van vanaf analytics.flowsery.com
- 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:
- Zorg dat je proxy de header
x-flowsery-real-ipmeestuurt 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 - Staat Nginx achter een andere proxy (Cloudflare, Vercel, enz.), dan is
$remote_addrhet IP-adres van die upstream-proxy: lees in dat geval rechtstreeks$http_cf_connecting_ipof$http_x_real_ipuit