Pomoc/Przewodniki proxy
Przewodniki proxy

Proxy Flowsery Analytics w Astro

Kieruj Flowsery Analytics przez swoją aplikację Astro za pomocą middleware, aby uniknąć blokowania przez adblockery i zbierać dokładniejsze dane o odwiedzających.

1. Utwórz middleware

Utwórz plik middleware src/middleware.js (lub src/middleware.ts w projektach TypeScript):

JavaScript
// src/middleware.js
export async function onRequest(context, next) {
  const { request } = context;
  const url = new URL(request.url);
 
  // Proxy the Flowsery Analytics tracking script
  if (url.pathname === '/js/main.js') {
    const response = await fetch('https://cdn.flowsery.com/main.js');
    const script = await response.text();
 
    return new Response(script, {
      headers: {
        'Content-Type': 'application/javascript',
        'Cache-Control': 'public, max-age=31536000',
      },
    });
  }
 
  // Proxy the event collection endpoint
  if (url.pathname === '/api/track' && request.method === 'POST') {
    const body = await request.text();
 
    // Resolve the real visitor IP for accurate geolocation
    const clientIp =
      request.headers.get('cf-connecting-ip') || request.headers.get('x-real-ip') || request.headers.get('x-forwarded-for')?.split(',')[0] || '';
 
    const response = await fetch('https://analytics.flowsery.com/analytics/events', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'User-Agent': request.headers.get('User-Agent') || '',
        Origin: request.headers.get('Origin') || url.origin,
        // Flowsery reads `x-flowsery-real-ip` as the authoritative visitor IP.
        // Without it, every visitor resolves to your server's region because
        // Cloudflare rewrites `cf-connecting-ip` on the proxy hop.
        ...(clientIp && { 'x-flowsery-real-ip': clientIp }),
      },
      body: body,
    });
 
    const responseText = await response.text();
 
    return new Response(responseText, {
      status: response.status,
      headers: {
        'Content-Type': 'application/json',
      },
    });
  }
 
  return next();
}

2. Włącz renderowanie po stronie serwera w Astro

Zaktualizuj plik astro.config.mjs, aby obsługiwał SSR (wymagany przez middleware):

JavaScript
// astro.config.mjs
import { defineConfig } from 'astro/config';
import node from '@astrojs/node';
 
export default defineConfig({
  output: 'server', // or 'hybrid'
  adapter: node({
    mode: 'standalone',
  }),
});

Potrzebny będzie też adapter Node.js: npm install @astrojs/node

3. Alternatywa: statyczna witryna z trasami API

Jeśli wolisz zachować w pełni statyczną witrynę, zamiast middleware utwórz trasy API:

Trasa proxy skryptu

Utwórz src/pages/js/main.js.js:

JavaScript
// src/pages/js/main.js.js
export async function GET() {
  const response = await fetch('https://cdn.flowsery.com/main.js');
  const script = await response.text();
 
  return new Response(script, {
    headers: {
      'Content-Type': 'application/javascript',
      'Cache-Control': 'public, max-age=31536000',
    },
  });
}

Trasa proxy zdarzeń

Utwórz src/pages/api/track.js:

JavaScript
// src/pages/api/track.js
export async function POST({ request }) {
  const body = await request.text();
  const url = new URL(request.url);
 
  // Resolve the real visitor IP for accurate geolocation
  const clientIp =
    request.headers.get('x-real-ip') || request.headers.get('x-forwarded-for')?.split(',')[0] || request.headers.get('cf-connecting-ip') || '';
 
  const response = await fetch('https://analytics.flowsery.com/analytics/events', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'User-Agent': request.headers.get('User-Agent') || '',
      Origin: request.headers.get('Origin') || url.origin,
      'x-forwarded-for': clientIp,
    },
    body: body,
  });
 
  const responseText = await response.text();
 
  return new Response(responseText, {
    status: response.status,
    headers: {
      'Content-Type': 'application/json',
    },
  });
}

Uwaga: jeśli twój projekt ma już trasę /api/track, dodaj data-api do tagu skryptu Flowsery Analytics, aby kierować zdarzenia gdzie indziej. Na przykład data-api="/flowsery-events" wysyła dane na /flowsery-events.

Ważne: jeśli w panelu wszyscy odwiedzający mają tę samą lokalizację, sprawdź, czy przy przekazywaniu żądań do punktu końcowego /events Flowsery Analytics nagłówek x-flowsery-real-ip zawiera prawdziwy adres IP odwiedzającego (a nie adres serwera proxy).

4. Zmień tag skryptu

Zastąp oryginalny fragment kodu Flowsery Analytics w swoim layoucie wersją korzystającą z proxy:

ASTRO
---
// src/layouts/Layout.astro
const { title } = Astro.props;
---
 
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width" />
    <title>{title}</title>
    <script
      defer
      data-fl-website-id="flid_******"
      src="/js/main.js"
    ></script>
  </head>
  <body>
    <slot />
  </body>
</html>

5. Wdróż

Po wdrożeniu konfiguracja proxy zacznie działać automatycznie. Sprawdź, czy twój dostawca hostingu obsługuje:

  • Renderowanie po stronie serwera (w podejściu z middleware)
  • Trasy API (w podejściu ze statyczną witryną)

Popularne hostingi zgodne z Astro to Vercel, Netlify i Cloudflare Pages.

Sprawdź, czy 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 z twojej domeny, a nie z analytics.flowsery.com

Uwaga: podejście z middleware wymaga renderowania po stronie serwera, a trasy API działają zarówno w witrynach statycznych, jak i renderowanych na serwerze.

Rozwiązywanie problemów

Wszyscy odwiedzający mają tę samą lokalizację

Gdy wszyscy odwiedzający pokazują się w jednym miejscu, na przykład w regionie twojego serwera, proxy nie przekazuje poprawnie ich prawdziwych adresów IP.

Rozwiązanie:

  1. Upewnij się, że proxy ustawia x-flowsery-real-ip na faktyczny adres IP odwiedzającego (a nie serwera) przy przekazywaniu żądań do punktu końcowego /events Flowsery Analytics.
  2. Jeśli wdrożenie Astro działa za innym proxy (Vercel, Cloudflare, Netlify), potrzebny adres IP znajduje się zwykle w cf-connecting-ip, x-vercel-forwarded-for lub x-real-ip. Odczytaj najpierw ten nagłówek, który dostarcza twoja warstwa brzegowa.