Proxy dla Flowsery Analytics w Vue.js
Kieruj Flowsery Analytics przez serwer deweloperski Vue.js, aby adblockery nie zakłócały śledzenia, a dane o odwiedzających były dokładniejsze.
1. Skonfiguruj proxy serwera deweloperskiego Vue.js
Jeśli korzystasz z Vue CLI, dodaj do pliku vue.config.js poniższe reguły proxy:
module.exports = {
devServer: {
proxy: {
'/js/main.js': {
target: 'https://analytics.flowsery.com',
changeOrigin: true,
pathRewrite: {
'^/js/main.js': '/js/main.js',
},
},
'/api/track': {
target: 'https://analytics.flowsery.com',
changeOrigin: true,
pathRewrite: {
'^/api/track': '/analytics/events',
},
},
},
},
};Uwaga: Jeśli twój projekt ma już trasę /api/track, dodaj data-api do tagu skryptu Flowsery Analytics, aby kierować dane o zdarzeniach w inne miejsce. Na przykład data-api="/flowsery-events" przekieruje dane na /flowsery-events.
2. Konfiguracja produkcyjna: serwer WWW
Nginx
location /js/main.js {
proxy_pass https://cdn.flowsery.com/main.js;
proxy_set_header Host analytics.flowsery.com;
proxy_cache_valid 200 1y;
add_header Cache-Control "public, max-age=31536000";
expires 1y;
}
location /api/track {
proxy_pass https://analytics.flowsery.com/analytics/events;
proxy_set_header Host analytics.flowsery.com;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header x-forwarded-for $remote_addr;
# CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
proxy_set_header x-flowsery-real-ip $remote_addr;
# Allow POST requests
proxy_method POST;
proxy_pass_request_body on;
}<Location "/js/main.js">
ProxyPass https://cdn.flowsery.com/main.js
ProxyPassReverse https://cdn.flowsery.com/main.js
Header set Cache-Control "public, max-age=31536000"
</Location>
<Location "/api/track">
ProxyPass https://analytics.flowsery.com/analytics/events
ProxyPassReverse https://analytics.flowsery.com/analytics/events
RequestHeader set x-forwarded-for %{REMOTE_ADDR}e
# CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
RequestHeader set x-flowsery-real-ip %{REMOTE_ADDR}e
</Location>Ważne: Jeśli w panelu wszyscy odwiedzający mają tę samą lokalizację, 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 zmian konfiguracja proxy zacznie działać automatycznie.
Sprawdzenie, czy wszystko działa
Aby upewnić się, że proxy działa prawidłowo:
- Otwórz swoją stronę
- 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
W środowisku produkcyjnym zalecamy dedykowany serwer WWW (Nginx lub Apache) zamiast proxy serwera deweloperskiego.
Rozwiązywanie problemów
Wszyscy odwiedzający pochodzą z tej samej lokalizacji
Jeśli wszyscy odwiedzający mają jedną lokalizację (na przykład region twojego serwera), proxy nie przekazuje prawidłowo 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 rzeczywistym adresem IP odwiedzającego (a nie adresem serwera) - Jeśli serwer WWW działa za innym proxy (Cloudflare, Vercel itp.),
$remote_addr/%{REMOTE_ADDR}ebędzie adresem tego proxy, dlatego użyj bezpośrednio$http_cf_connecting_ip/%{HTTP:CF-Connecting-IP}lub$http_x_real_ip