Proxy dla Flowsery Analytics w Nginx
Kieruj Flowsery Analytics przez Nginx, aby adblockery nie zakłócały śledzenia, a dane o odwiedzających były dokładne. Ten przewodnik dotyczy zarówno samodzielnego Nginx, jak i Nginx działającego jako reverse proxy przed serwerem aplikacji.
Konfiguracja ma dwa kluczowe elementy: proxy_pass, dzięki któremu zdarzenia stają się first-party (i są odporne na adblockery), oraz proxy_set_header x-flowsery-real-ip, który przenosi prawdziwy adres IP odwiedzającego przez proxy, aby Flowsery określało lokalizację na podstawie odwiedzającego, a nie twojego serwera.
1. Podstawowa konfiguracja Nginx
Dodaj te bloki location w pliku /etc/nginx/sites-available/your-site lub /etc/nginx/conf.d/your-site.conf:
# 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;
}Jeśli Nginx działa za Cloudflare (lub innym edge'em), $remote_addr to adres IP serwera brzegowego CDN, a nie odwiedzającego. W takim przypadku użyj nagłówka CDN z prawdziwym adresem IP:
# 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;Uwaga: Jeśli twój serwer obsługuje już ścieżkę /api/track, wybierz inną i wskaż ją trackerowi za pomocą data-api="/flowsery-events".
2. Opcjonalnie: włącz cache dla skryptu
# 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. Zmień tag skryptu
Zastąp fragment kodu Flowsery Analytics wersją korzystającą z proxy:
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>sudo nginx -t # validate config
sudo systemctl reload nginxSprawdzenie, czy wszystko działa
- Otwórz swoją stronę w zwykłej karcie przeglądarki.
- W DevTools → Network przefiltruj po
/api/track. Sprawdź, czy żądania trafiają do twojej domeny. - W panelu Flowsery sprawdź, czy kraje odwiedzających odpowiadają twoim odbiorcom, a nie regionowi hostingu.
Rozwiązywanie problemów
Wszyscy odwiedzający pochodzą z tej samej lokalizacji
Proxy przekazuje zdarzenia, ale nie przekazuje prawdziwego adresu IP odwiedzającego. Nagłówka x-flowsery-real-ip brakuje albo zawiera on adres IP Twojego serwera zamiast adresu odwiedzającego.
- Sprawdź, czy wiersz
proxy_set_header x-flowsery-real-ip <value>znajduje się w bloku/api/tracki czy wartość wskazuje zmienną właściwą dla twojej konfiguracji edge ($remote_addrdla ruchu bezpośredniego,$http_cf_connecting_ipdla Cloudflare,$http_x_real_ipdla ogólnego edge'a L7). - Jeśli Nginx działa za innym proxy, nie używaj
$remote_addr: to adres tego proxy, a nie odwiedzającego. Użyj nagłówka dodawanego przez proxy nadrzędne.