benvinegar/counterscale

O que é?

Recursos principais

• 01Rastreia pageviews com uma tag de script, um módulo npm para navegador ou um módulo server-side.
• 02Roda no Cloudflare Workers e inclui um instalador de CLI para implantação.
• 03Proteção opcional por senha para o dashboard de analytics.
• 04Armazena dados de longo prazo no R2 como arquivos Apache Arrow, além do limite de retenção de 90 dias.
• 05Oferece suporte ao rastreamento manual de pageviews e a parâmetros UTM no módulo server-side.
• 06Permite atualizar executando novamente o instalador, sem perder os dados existentes.

Casos de uso

• Adicionar estatísticas de tráfego com foco em privacidade e auto-hospedadas a um blog pessoal ou site de projeto.
• Rastrear pageviews de uma aplicação backend que não usa scripts no navegador.
• Rodar analytics de baixo custo para vários sites em uma conta do Cloudflare.

Início rápido

1. 1

   Faça login no Cloudflare e autorize o Wrangler

   npx wrangler login
2. 2

   Execute o instalador do Counterscale e siga as instruções

   npx @counterscale/cli@latest install
3. 3

   Adicione o trecho do script de rastreamento ao HTML do seu site

Antes de usar

• !De acordo com os requisitos do README, é necessária uma conta do Cloudflare, e a execução é compatível apenas com macOS ou Linux.
• !O Workers Analytics Engine mantém os dados por no máximo 90 dias; por isso, o painel mostra apenas os últimos 90 dias (há armazenamento R2 disponível para retenção de longo prazo).
• !O desenvolvimento local não tem um banco de dados de teste: as gravações não fazem nada e as leituras exibem dados de produção.

Em coleções

Tópicos

Perguntas frequentes

O que é counterscale?

Ferramenta de analytics web auto-hospedada, com rastreador e dashboard que rodam no Cloudflare Workers e no Workers Analytics Engine. Counterscale é uma ferramenta simples de analytics web, com rastreador e dashboard que você hospeda por conta própria no Cloudflare. Ela é baseada no Cloudflare Workers e no Workers Analytics Engine, e o projeto busca manter os custos operacionais próximos de zero, mesmo com volumes altos de tráfego.

counterscale é gratuito? Qual é a licença?

counterscale é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

counterscale ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de counterscale foi em 4 de out. de 2026.

Para que posso usar counterscale?

Adicionar estatísticas de tráfego com foco em privacidade e auto-hospedadas a um blog pessoal ou site de projeto. Rastrear pageviews de uma aplicação backend que não usa scripts no navegador. Rodar analytics de baixo custo para vários sites em uma conta do Cloudflare.

Como instalar counterscale?

Faça login no Cloudflare e autorize o Wrangler: npx wrangler login Execute o instalador do Counterscale e siga as instruções: npx @counterscale/cli@latest install Adicione o trecho do script de rastreamento ao HTML do seu site

Onde consigo counterscale?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/benvinegar/counterscale