Proxy do Flowsery Analytics com Firebase Hosting
Encaminhe o Flowsery Analytics pelo Firebase Hosting usando Cloud Functions para evitar interferência de bloqueadores de anúncios e capturar dados de visitantes mais precisos.
Observação: o Firebase Hosting não oferece suporte nativo a rewrites de reverse proxy para destinos externos. Este guia usa Firebase Cloud Functions como alternativa.
1. Inicializar Firebase Functions (se ainda não estiver configurado)
Se seu projeto ainda não inclui Firebase Functions, execute:
firebase init functionsSiga os passos de configuração adequados ao seu ambiente. No final, haverá um diretório /functions no seu projeto.
2. Instalar dependências
Entre no diretório functions/ e instale os pacotes necessários:
cd functions/
npm i -s express express-http-proxy3. Construir a Cloud Function de reverse proxy
Crie ou atualize functions/index.js com o seguinte:
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);Observação: Se seu projeto já usa uma rota /api/track, adicione data-api à tag de script do Flowsery Analytics para encaminhar eventos para outro caminho. Por exemplo, data-api="/flowsery-events" envia os dados para /flowsery-events.
Importante: Se todos os visitantes aparecerem na mesma localização no seu painel, confirme que o cabeçalho x-flowsery-real-ip está definido com o IP real do visitante (e não com o IP do servidor proxy) ao encaminhar requisições para o endpoint /events do Flowsery Analytics.
4. Configurar os rewrites do Firebase Hosting
Atualize firebase.json para encaminhar os caminhos correspondentes para a função 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. Modificar a tag de script
Substitua o snippet original do Flowsery Analytics pela versão com proxy:
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>6. Fazer deploy do Hosting e das Functions
Publique hosting e functions em um único deploy:
firebase deploy --only hosting,functionsConfirmar que funciona
Para validar que o proxy está funcionando corretamente:
- Acesse seu site
- Abra as ferramentas de desenvolvedor do navegador e mude para a aba Network
- Verifique se as requisições de analytics são servidas pelo seu domínio em vez de
analytics.flowsery.com
Solução de problemas
Todos os visitantes aparecem da mesma localização
Quando todos os visitantes mostram uma única localização geográfica, como a região do seu servidor, o proxy não está encaminhando corretamente os IPs reais dos visitantes.
Solução:
- Garanta que seu proxy inclua o cabeçalho
x-flowsery-real-ipcom o endereço IP real do visitante (e não o IP do servidor) ao encaminhar requisições para o endpoint/eventsdo Flowsery Analytics. - Se a Cloud Function estiver atrás de outro proxy (Cloudflare, Vercel etc.),
srcReq.ipserá o proxy upstream. Use diretamentecf-connecting-ipoux-real-ip.