Proxy Flowsery Analytics przez DigitalOcean
Kieruj Flowsery Analytics przez DigitalOcean, aby uniknąć zakłóceń ze strony blokad reklam i zbierać dokładniejsze dane o odwiedzających. Ten przewodnik obejmuje zarówno App Platform, jak i konfiguracje oparte na Dropletach.
Opcja 1: DigitalOcean App Platform
Jeśli korzystasz z DigitalOcean App Platform z Node.js, skorzystaj z przewodnika dla swojego frameworka:
- Aplikacje Next.js: zobacz przewodnik proxy dla Next.js
- Aplikacje Express.js: zobacz przewodnik proxy dla Express.js
- Inne aplikacje Node.js: zastosuj podejście z Express.js
App Platform automatycznie przekazuje adresy IP w nagłówku X-Forwarded-For, więc konfiguracje z tych przewodników działają bez zmian.
Opcja 2: DigitalOcean Droplet z Nginx
Jeśli korzystasz z Dropleta DigitalOcean, na którym Nginx działa jako serwer WWW lub reverse proxy, użyj poniższej konfiguracji.
1. Połącz się z Dropletem
ssh root@your-droplet-ip2. Otwórz konfigurację Nginx
Edytuj plik konfiguracyjny witryny, na przykład /etc/nginx/sites-available/your-site:
sudo nano /etc/nginx/sites-available/your-site3. Dodaj bloki location dla proxy
Wstaw poniższe bloki location do konfiguracji serwera:
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...
}Uwaga: jeśli masz już blok location dla /api/track, dodaj data-api do tagu skryptu Flowsery Analytics, aby przekierować zdarzenia. Na przykład data-api="/flowsery-events" wysyła dane na /flowsery-events.
4. Przetestuj i przeładuj Nginx
Sprawdź, czy konfiguracja nie zawiera błędów składni:
sudo nginx -tJeśli test się powiedzie, przeładuj Nginx:
sudo systemctl reload nginx5. Opcjonalnie: włącz pamięć podręczną
Aby poprawić wydajność, skonfiguruj strefę pamięci podręcznej 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;
}Opcja 3: DigitalOcean Spaces CDN
Jeśli przed Dropletem używasz DigitalOcean Spaces CDN, upewnij się, że poprawnie przekazuje on adresy IP klientów:
- W panelu DigitalOcean przejdź do Networking > CDN
- Sprawdź, czy CDN jest skonfigurowany do przekazywania nagłówków żądań
- CDN automatycznie dodaje nagłówki
X-Forwarded-For - Konfiguracja Nginx odczyta z tych nagłówków adresy IP odwiedzających
Zmień tag skryptu
Zastąp oryginalny fragment kodu Flowsery Analytics wersją korzystającą z proxy:
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>Sprawdź, czy to działa
Aby upewnić się, że proxy działa poprawnie:
- Otwórz swoją witrynę
- Otwórz narzędzia deweloperskie przeglądarki i przejdź na kartę Network
- Sprawdź, czy żądania analityczne są obsługiwane przez twoją domenę, a nie przez analytics.flowsery.com
- Sprawdź w panelu Flowsery Analytics, czy lokalizacje odwiedzających są wyświetlane poprawnie
Rozwiązywanie problemów
Wszyscy odwiedzający są z tej samej lokalizacji
Jeśli wszyscy odwiedzający mają jedną lokalizację geograficzną, na przykład region twojego serwera, proxy nie przekazuje poprawnie ich prawdziwych adresów IP.
Rozwiązanie:
- Upewnij się, że przy przekazywaniu żądań do endpointu
/eventsFlowsery Analytics proxy dołącza nagłówekx-flowsery-real-ipz prawdziwym adresem IP odwiedzającego, a nie adresem serwera - Jeśli Nginx działa za innym proxy (Cloudflare, Vercel itp.),
$remote_addrbędzie adresem IP tego nadrzędnego proxy. Odczytuj wtedy adres bezpośrednio z$http_cf_connecting_iplub$http_x_real_ip