Pomoc/Przewodniki proxy
Przewodniki proxy

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:

Text
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:

Text
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:

HTML
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>
Terminal
# Validate the configuration
caddy validate
 
# If validation passes, reload Caddy
caddy reload

Sprawdź, czy to działa

Aby upewnić się, że proxy działa poprawnie:

  1. Otwórz swoją witrynę
  2. Otwórz narzędzia deweloperskie przeglądarki i przejdź na kartę Network
  3. 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:

  1. Upewnij się, że przy przekazywaniu żądań do endpointu /events Flowsery Analytics proxy ustawia x-flowsery-real-ip na prawdziwy adres IP odwiedzającego, a nie adres serwera.
  2. 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).