Proxy Flowsery Analytics przez Caddy
Kieruj Flowsery Analytics przez Caddy, aby uniknąć zakłóceń ze strony blokad reklam i zbierać dokładniejsze dane o odwiedzających. Dzięki prostej konfiguracji Caddy wdrożenie jest wyjątkowo łatwe.
1. Podstawowa konfiguracja Caddy
Dodaj poniższe dyrektywy do pliku Caddyfile:
your_domain.com {
# Proxy the analytics script
handle /js/main.js {
reverse_proxy https://analytics.flowsery.com {
header_up Host {upstream_hostport}
header_up X-Real-IP {remote_host}
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto {scheme}
}
# Cache the script for 1 year
header Cache-Control "public, max-age=31536000"
header Expires "1y"
}
# Proxy the event collection endpoint + forward real visitor IP
handle /api/track {
reverse_proxy https://analytics.flowsery.com {
header_up Host {upstream_hostport}
# CRITICAL: Flowsery reads this header as the real visitor IP.
# Without it, every visitor resolves to your server's region.
# Replace {remote_host} with {http.request.header.Cf-Connecting-Ip}
# if Caddy sits behind Cloudflare.
header_up x-flowsery-real-ip {remote_host}
header_up X-Real-IP {remote_host}
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto {scheme}
}
}
# Your other site directives...
}Uwaga: jeśli twój serwer używa już ścieżki /api/track, dodaj data-api do tagu skryptu Flowsery Analytics, aby kierować zdarzenia w inne miejsce. Na przykład data-api="/flowsery-events" wysyła dane na /flowsery-events.
Ważne: jeśli w panelu wszyscy odwiedzający są w tej samej lokalizacji, sprawdź, czy przy przekazywaniu żądań do endpointu /events Flowsery Analytics nagłówek x-flowsery-real-ip zawiera prawdziwy adres IP odwiedzającego, a nie adres serwera proxy.
2. Opcjonalnie: włącz pamięć podręczną
Aby poprawić wydajność, możesz dodać warstwę pamięci podręcznej:
your_domain.com {
# Cache settings
cache {
path /var/cache/caddy
ttl 1y
capacity 10GB
}
handle /js/main.js {
cache
reverse_proxy https://analytics.flowsery.com {
header_up Host {upstream_hostport}
header_up X-Real-IP {remote_host}
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto {scheme}
}
header Cache-Control "public, max-age=31536000"
header Expires "1y"
}
# ... remainder of the configuration
}3. 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># Validate the configuration
caddy validate
# If validation passes, reload Caddy
caddy reloadSprawdź, 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
Caddy automatycznie zarządza certyfikatami HTTPS i HTTP/2, dlatego dobrze sprawdza się jako proxy dla analityki. Jeśli włączysz konfigurację pamięci podręcznej, upewnij się, że serwer Caddy ma wystarczająco dużo miejsca na dysku.
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 ustawiax-flowsery-real-ipna prawdziwy adres IP odwiedzającego, a nie adres serwera. - Jeśli Caddy działa za Cloudflare lub inną warstwą brzegową,
{remote_host}wskazuje to nadrzędne proxy, a nie odwiedzającego. Użyj wtedy{http.request.header.Cf-Connecting-Ip}(Cloudflare) lub{http.request.header.X-Real-Ip}(rozwiązanie ogólne).