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):
// 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):
// 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:
// 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:
// 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:
---
// 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:
- Otwórz swoją witrynę
- Otwórz narzędzia deweloperskie przeglądarki i przejdź na kartę Network
- 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:
- Upewnij się, że proxy ustawia
x-flowsery-real-ipna faktyczny adres IP odwiedzającego (a nie serwera) przy przekazywaniu żądań do punktu końcowego/eventsFlowsery Analytics. - 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-forlubx-real-ip. Odczytaj najpierw ten nagłówek, który dostarcza twoja warstwa brzegowa.