Proxy Flowsery Analytics avec DigitalOcean
Faites transiter Flowsery Analytics via DigitalOcean afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs plus précises. Ce guide couvre à la fois App Platform et les configurations basées sur Droplet.
Option 1 : DigitalOcean App Platform
Si vous utilisez DigitalOcean App Platform avec Node.js, reportez-vous au guide spécifique au framework correspondant à votre stack :
- Applications Next.js : consultez le guide proxy Next.js
- Applications Express.js : consultez le guide proxy Express.js
- Autres applications Node.js : suivez l'approche Express.js
App Platform gère automatiquement le transfert des IP via l'en-tête X-Forwarded-For, donc les configurations de ces guides fonctionnent sans modification.
Option 2 : DigitalOcean Droplet avec Nginx
Si vous utilisez un DigitalOcean Droplet avec Nginx comme serveur web ou reverse proxy, utilisez la configuration suivante.
1. Vous connecter à votre Droplet
ssh root@your-droplet-ip2. Ouvrir la configuration Nginx
Modifiez le fichier de configuration de votre site, par exemple /etc/nginx/sites-available/your-site :
sudo nano /etc/nginx/sites-available/your-site3. Ajouter les blocs location proxy
Insérez les blocs location suivants dans votre configuration serveur :
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...
}Remarque : si vous avez déjà un bloc location /api/track, ajoutez data-api à la balise script Flowsery Analytics pour rediriger les événements. Par exemple, data-api="/flowsery-events" envoie les données vers /flowsery-events.
4. Tester et recharger Nginx
Vérifiez la configuration pour détecter les erreurs de syntaxe :
sudo nginx -tSi le test est concluant, rechargez Nginx :
sudo systemctl reload nginx5. Optionnel : activer le cache
Pour améliorer les performances, configurez une zone de cache 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;
}Option 3 : DigitalOcean Spaces CDN
Si vous utilisez DigitalOcean Spaces CDN devant votre Droplet, assurez-vous qu'il transfère correctement les IP clientes :
- Dans le tableau de bord DigitalOcean, allez dans Networking > CDN
- Vérifiez que votre CDN est configuré pour laisser passer les en-têtes de requête
- Le CDN ajoute automatiquement des en-têtes
X-Forwarded-For - Votre configuration Nginx récupérera les IP visiteurs depuis ces en-têtes
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>Vérifier que cela fonctionne
Pour valider le bon fonctionnement du proxy :
- Ouvrez votre site web
- Ouvrez les outils de développement de votre navigateur et passez à l'onglet Réseau
- Vérifiez que les requêtes analytics sont servies depuis votre domaine plutôt que depuis analytics.flowsery.com
- Vérifiez dans votre tableau de bord Flowsery Analytics que les localisations des visiteurs sont affichées correctement
Dépannage
Tous les visiteurs apparaissent au même endroit
Lorsque tous les visiteurs affichent une seule localisation géographique, comme la région de votre serveur, le proxy ne transmet pas correctement les vraies IP des visiteurs.
Résolution :
- Assurez-vous que votre proxy inclut l'en-tête
x-flowsery-real-ipcontenant la vraie adresse IP du visiteur (et non celle du serveur) lors du transfert des requêtes vers le endpoint/eventsde Flowsery Analytics - Si Nginx est derrière un autre proxy (Cloudflare, Vercel, etc.),
$remote_addrsera l'IP du proxy amont : lisez plutôt$http_cf_connecting_ipou$http_x_real_ip