Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met Caddy

Stuur Flowsery Analytics via Caddy om adblockers te omzeilen en nauwkeurigere bezoekersdata te verzamelen. Dankzij de eenvoudige configuratie van Caddy is dit bijzonder snel ingesteld.

1. Basisconfiguratie van Caddy

Voeg de volgende directives toe aan je 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...
}

Let op: gebruikt je server het pad /api/track al, voeg dan data-api toe aan de scripttag van Flowsery Analytics om events ergens anders heen te sturen. Met data-api="/flowsery-events" gaat de data bijvoorbeeld naar /flowsery-events.

Belangrijk: lijken alle bezoekers in je dashboard vanaf dezelfde locatie te komen, controleer dan of x-flowsery-real-ip het echte IP-adres van de bezoeker bevat (niet dat van de proxyserver) wanneer je verzoeken doorstuurt naar het /events-endpoint van Flowsery Analytics.

2. Optioneel: caching inschakelen

Voor betere prestaties kun je een cachelaag toevoegen:

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. Pas de scripttag aan

Vervang de oorspronkelijke snippet van Flowsery Analytics door de geproxyde versie:

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

Controleren of het werkt

Zo controleer je of de proxy goed werkt:

  1. Ga naar je website
  2. Open de ontwikkelaarstools van je browser en ga naar het tabblad Network
  3. Controleer of de analyticsverzoeken vanaf je eigen domein komen in plaats van vanaf analytics.flowsery.com

Caddy regelt HTTPS-certificaten en HTTP/2 automatisch, wat het een goede keuze maakt om analytics te proxyen. Zorg dat je Caddy-server genoeg schijfruimte heeft als je de cacheconfiguratie inschakelt.

Problemen oplossen

Alle bezoekers komen vanaf dezelfde locatie

Tonen alle bezoekers één geografische locatie, bijvoorbeeld de regio van je server, dan stuurt de proxy de echte IP-adressen van bezoekers niet goed door.

Oplossing:

  1. Zorg dat je proxy x-flowsery-real-ip instelt op het echte IP-adres van de bezoeker (niet het IP-adres van de server) wanneer je verzoeken doorstuurt naar het /events-endpoint van Flowsery Analytics.
  2. Staat Caddy achter Cloudflare of een andere edge, dan is {remote_host} die upstream-proxy en niet de bezoeker. Gebruik in dat geval {http.request.header.Cf-Connecting-Ip} (Cloudflare) of {http.request.header.X-Real-Ip} (algemeen).