Proxy do Flowsery Analytics com DigitalOcean
Encaminhe o Flowsery Analytics pelo DigitalOcean para evitar interferência de bloqueadores de anúncios e capturar dados de visitantes mais precisos. Este guia cobre tanto a App Platform quanto configurações baseadas em Droplets.
Opção 1: DigitalOcean App Platform
Se você estiver rodando na DigitalOcean App Platform com Node.js, consulte o guia específico do framework que corresponde à sua stack:
- Aplicativos Next.js: veja o guia de proxy para Next.js
- Aplicativos Express.js: veja o guia de proxy para Express.js
- Outros aplicativos Node.js: siga a abordagem do Express.js
A App Platform cuida automaticamente do encaminhamento de IP pelo cabeçalho X-Forwarded-For, por isso as configurações desses guias funcionam sem alterações.
Opção 2: DigitalOcean Droplet com Nginx
Se você estiver rodando em um Droplet da DigitalOcean com Nginx como servidor web ou reverse proxy, use a configuração seguinte.
1. Conectar-se ao seu Droplet
ssh root@your-droplet-ip2. Abrir a configuração do Nginx
Edite o arquivo de configuração do site, por exemplo /etc/nginx/sites-available/your-site:
sudo nano /etc/nginx/sites-available/your-site3. Adicionar os blocos location do proxy
Insira os seguintes blocos location na configuração do seu servidor:
server {
listen 80;
server_name your_domain.com;
# Your existing configuration...
# Proxy the analytics script
location /js/main.js {
proxy_pass https://cdn.flowsery.com/main.js;
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;
# Cache the script for 1 year
add_header Cache-Control "public, max-age=31536000";
expires 1y;
}
# Proxy the event collection endpoint
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;
# 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;
}
# Your other location blocks...
}Observação: Se você já tiver um bloco location para /api/track, adicione data-api à tag de script do Flowsery Analytics para redirecionar os eventos. Por exemplo, data-api="/flowsery-events" envia os dados para /flowsery-events.
4. Testar e recarregar o Nginx
Valide a configuração para detectar erros de sintaxe:
sudo nginx -tSe o teste passar, recarregue o Nginx:
sudo systemctl reload nginx5. Opcional: ativar cache
Para melhorar o desempenho, configure uma zona de cache do Nginx:
# Place this outside the server block (typically at the top of nginx.conf)
proxy_cache_path /var/cache/nginx/flowsery_cache
levels=1:2
keys_zone=flowsery_cache:10m
max_size=100m
inactive=60m
use_temp_path=off;
# In your server block, update the script location
location /js/main.js {
proxy_cache flowsery_cache;
proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504;
proxy_cache_valid 200 1y;
proxy_cache_bypass $http_pragma;
proxy_cache_revalidate on;
proxy_pass https://cdn.flowsery.com/main.js;
proxy_set_header Host analytics.flowsery.com;
add_header Cache-Control "public, max-age=31536000";
expires 1y;
}Opção 3: DigitalOcean Spaces CDN
Se você estiver usando a DigitalOcean Spaces CDN na frente do seu Droplet, confirme que ela encaminha corretamente os IPs dos clientes:
- No painel da DigitalOcean, vá até Networking > CDN
- Confirme que sua CDN está configurada para fazer passthrough dos cabeçalhos da requisição
- A CDN adiciona automaticamente cabeçalhos
X-Forwarded-For - A configuração do seu Nginx vai coletar os IPs dos visitantes a partir desses cabeçalhos
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>Confirmar que funciona
Para validar que o proxy está funcionando corretamente:
- Acesse seu site
- Abra as ferramentas de desenvolvedor do navegador e vá para a aba Network
- Verifique se as requisições de analytics são servidas a partir do seu domínio em vez de
analytics.flowsery.com - Verifique no seu painel do Flowsery Analytics se as localizações dos visitantes são exibidas corretamente
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 o Nginx estiver atrás de outro proxy (Cloudflare, Vercel, etc.),
$remote_addrserá o IP do proxy upstream. Em vez disso, leia diretamente de$http_cf_connecting_ipou$http_x_real_ip.