Pomoc/Przewodniki proxy
Przewodniki proxy

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:

Terminal
firebase init functions

Wykonaj 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:

Terminal
cd functions/
npm i -s express express-http-proxy

3. Utwórz funkcję reverse proxy

Utwórz lub zaktualizuj plik functions/index.js, dodając poniższy kod:

JavaScript
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:

JSON
{
  "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:

HTML
<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:

Terminal
firebase deploy --only hosting,functions

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

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:

  1. Upewnij się, że przy przekazywaniu żądań do endpointu /events Flowsery Analytics proxy dołącza nagłówek x-flowsery-real-ip z prawdziwym adresem IP odwiedzającego, a nie adresem serwera
  2. Jeśli Cloud Function działa za innym proxy (Cloudflare, Vercel itp.), srcReq.ip wskaże to nadrzędne proxy. Użyj wtedy bezpośrednio cf-connecting-ip lub x-real-ip