Proxy Flowsery Analytics przez Flask
Kieruj Flowsery Analytics przez aplikację Flask, aby uniknąć zakłóceń ze strony blokad reklam i zbierać dokładniejsze dane o odwiedzających.
1. Zainstaluj zależności
pip install flask requests2. Skonfiguruj proxy
Dodaj poniższe trasy i funkcję pomocniczą do aplikacji Flask:
from flask import Flask, request, Response
import requests
app = Flask(__name__)
def get_client_ip():
"""
Determine the actual visitor IP address.
When behind Cloudflare, prefer CF-Connecting-IP. Then X-Real-IP.
Then X-Forwarded-For's first entry. Finally fall back to request.remote_addr.
"""
cf_ip = request.headers.get("CF-Connecting-IP")
if cf_ip:
return cf_ip
real_ip = request.headers.get("X-Real-IP")
if real_ip:
return real_ip
xff = request.headers.get("X-Forwarded-For")
if xff:
# Comma-separated list: "client, proxy1, proxy2"
parts = [ip.strip() for ip in xff.split(",")]
if parts:
return parts[0] # the leftmost entry is the original client
return request.remote_addr
@app.route("/js/main.js")
def proxy_script():
response = requests.get("https://cdn.flowsery.com/main.js")
return Response(
response.content,
content_type="application/javascript",
headers={"Cache-Control": "public, max-age=31536000"},
)
@app.route("/api/track", methods=["POST"])
def proxy_events():
# Copy incoming headers but omit those that should match the target
excluded = {"host", "content-length"}
headers = {
key: value
for key, value in request.headers.items()
if key.lower() not in excluded
}
# The Origin header is required by the Flowsery Analytics API
if "Origin" not in headers:
scheme = request.scheme
host = request.host
headers["Origin"] = f"{scheme}://{host}"
# Attach the real visitor IP for accurate geolocation
client_ip = get_client_ip()
headers["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
# Forward the request body and headers to Flowsery Analytics
response = requests.post(
"https://analytics.flowsery.com/analytics/events",
data=request.get_data(),
headers=headers,
timeout=5,
)
# Return the upstream response to the browser
return Response(
response.content,
status=response.status_code,
content_type=response.headers.get("Content-Type", "application/json"),
)Uwaga: jeśli twoja aplikacja ma już endpoint /api/track, użyj atrybutu data-api w tagu skryptu Flowsery Analytics, aby wysyłać zdarzenia na inną ścieżkę. Na przykład data-api="/flowsery-events" kieruje 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.
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
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 dołącza nagłówekx-flowsery-real-ipz prawdziwym adresem IP odwiedzającego, a nie adresem serwera - Jeśli Flask działa za innym proxy (Cloudflare, Vercel itp.),
request.remote_addrwskaże to nadrzędne proxy. Odczytuj wtedy bezpośredniorequest.headers.get('CF-Connecting-IP')lubrequest.headers.get('X-Real-IP')