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
pip install fastapi uvicorn httpx2. Skonfiguruj proxy
Dodaj poniższy kod do aplikacji FastAPI:
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:
<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:
- 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