Proxy Flowsery Analytics przez Firebase Hosting
Kieruj Flowsery Analytics przez Firebase Hosting za pomocą Cloud Functions, aby uniknąć zakłóceń ze strony blokad reklam i zbierać dokładniejsze dane o odwiedzających.
Uwaga: Firebase Hosting nie obsługuje natywnie reguł rewrite typu reverse proxy kierujących do zewnętrznych adresów. Dlatego ten przewodnik wykorzystuje Firebase Cloud Functions.
1. Zainicjuj Firebase Functions (jeśli nie są jeszcze skonfigurowane)
Jeśli twój projekt nie zawiera jeszcze Firebase Functions, uruchom:
firebase init functionsWykonaj kroki konfiguracji odpowiednie dla swojego środowiska. Po ich zakończeniu w projekcie pojawi się katalog /functions.
2. Zainstaluj zależności
Przejdź do katalogu functions/ i zainstaluj wymagane pakiety:
cd functions/
npm i -s express express-http-proxy3. Utwórz funkcję reverse proxy
Utwórz lub zaktualizuj plik functions/index.js, dodając poniższy kod:
const { onRequest } = require('firebase-functions/v2/https');
const express = require('express');
const proxy = require('express-http-proxy');
const app = express();
app.set('trust proxy', true);
// Proxy the Flowsery Analytics tracking script
app.use(
'/js/main.js',
proxy('https://analytics.flowsery.com', {
proxyReqPathResolver: () => '/js/main.js',
})
);
// Proxy the event collection endpoint
app.use(
'/api/track',
proxy('https://analytics.flowsery.com', {
proxyReqPathResolver: () => '/analytics/events',
proxyReqOptDecorator: (proxyReqOpts, srcReq) => {
// Forward the real visitor IP for accurate geolocation
const clientIp =
srcReq.headers['cf-connecting-ip'] || srcReq.headers['x-real-ip'] || srcReq.headers['x-forwarded-for']?.split(',')[0]?.trim() || srcReq.ip;
proxyReqOpts.headers['x-forwarded-for'] = clientIp;
if (clientIp) {
// CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
proxyReqOpts.headers['x-flowsery-real-ip'] = clientIp;
}
return proxyReqOpts;
},
})
);
exports.reverseProxy = onRequest(app);Uwaga: jeśli twój projekt używa już trasy /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.
4. Skonfiguruj reguły rewrite w Firebase Hosting
Zaktualizuj plik firebase.json, aby kierować pasujące ścieżki do funkcji reverseProxy:
{
"hosting": {
"public": "public",
"ignore": ["firebase.json", "**/.*", "**/node_modules/**"],
"rewrites": [
{
"source": "/js/main.js",
"function": "reverseProxy"
},
{
"source": "/api/track",
"function": "reverseProxy"
}
]
},
"functions": [
{
"source": "functions",
"codebase": "default",
"ignore": ["node_modules", ".git", "firebase-debug.log", "firebase-debug.*.log", "*.local"]
}
]
}5. 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>6. Wdróż Hosting i Functions
Opublikuj hosting i funkcje w jednym wdrożeniu:
firebase deploy --only hosting,functionsSprawdź, 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 Cloud Function działa za innym proxy (Cloudflare, Vercel itp.),
srcReq.ipwskaże to nadrzędne proxy. Użyj wtedy bezpośredniocf-connecting-iplubx-real-ip