Pomoc/Przewodniki proxy
Przewodniki proxy

Proxy Flowsery Analytics przez FastAPI

Kieruj Flowsery Analytics przez serwer FastAPI, aby uniknąć zakłóceń ze strony blokad reklam i zbierać dokładniejsze dane o odwiedzających.

1. Zainstaluj zależności

Terminal
pip install fastapi uvicorn httpx

2. Skonfiguruj proxy

Dodaj poniższy kod do aplikacji FastAPI:

Python
from fastapi import FastAPI, Request
from fastapi.responses import Response
import httpx
 
app = FastAPI()
 
def get_client_ip(request: Request) -> str:
    """Resolve the actual visitor IP address"""
    # Prefer Cloudflare's CF-Connecting-IP if available
    if cf_connecting_ip := request.headers.get("cf-connecting-ip"):
        return cf_connecting_ip
 
    # Then X-Real-IP
    if x_real_ip := request.headers.get("x-real-ip"):
        return x_real_ip
 
    # Fall back to X-Forwarded-For (first entry)
    if x_forwarded_for := request.headers.get("x-forwarded-for"):
        return x_forwarded_for.split(",")[0].strip()
 
    # Last resort: direct connection host
    return request.client.host if request.client else ""
 
@app.get("/js/main.js")
async def proxy_script():
    async with httpx.AsyncClient() as client:
        response = await client.get('https://cdn.flowsery.com/main.js')
        return Response(
            content=response.content,
            media_type='application/javascript',
            headers={
                'Cache-Control': 'public, max-age=31536000'
            }
        )
 
@app.post("/api/track")
async def proxy_events(request: Request):
    body = await request.json()
 
    # Determine the origin from the request or construct it from the base URL
    origin = request.headers.get('origin') or str(request.base_url).rstrip('/')
 
    # Resolve visitor IP for accurate geolocation
    client_ip = get_client_ip(request)
 
    async with httpx.AsyncClient() as client:
        headers = {
            'Content-Type': 'application/json',
            'User-Agent': request.headers.get('user-agent'),
            'Origin': origin,
            'x-forwarded-for': client_ip
        }
 
        if client_ip:
            # CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
            headers['x-flowsery-real-ip'] = client_ip
 
        response = await client.post(
            'https://analytics.flowsery.com/analytics/events',
            json=body,
            headers=headers
        )
        return Response(
            content=response.content,
            media_type='application/json',
            status_code=response.status_code
        )
 
if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)

Uwaga: jeśli twoja aplikacja ma już endpoint /api/track, użyj atrybutu data-api w tagu skryptu Flowsery Analytics, aby kierować zdarzenia na inną ścieżkę. 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. Jeśli FastAPI działa za innym proxy (Cloudflare, Vercel itp.), request.client.host wskaże to nadrzędne proxy, więc odczytuj bezpośrednio cf-connecting-ip lub x-real-ip.

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>

4. Wdróż zmiany

Po wdrożeniu serwera konfiguracja proxy zacznie działać automatycznie.

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