Pomoc/Przewodniki proxy
Przewodniki proxy

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:

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;
}

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:

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;

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

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. Zmień tag skryptu

Zastąp fragment kodu Flowsery Analytics wersją korzystającą z proxy:

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

Sprawdzenie, czy wszystko działa

  1. Otwórz swoją stronę w zwykłej karcie przeglądarki.
  2. W DevTools → Network przefiltruj po /api/track. Sprawdź, czy żądania trafiają do twojej domeny.
  3. 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/track i czy wartość wskazuje zmienną właściwą dla twojej konfiguracji edge ($remote_addr dla ruchu bezpośredniego, $http_cf_connecting_ip dla Cloudflare, $http_x_real_ip dla 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.