Repolode
shivamanupadi

shivamanupadi/traks

Analytics web auto-hospedado e sem cookies, implantado inteiramente na sua própria conta Cloudflare, sem serviços de terceiros no fluxo de dados.

Alternativa open source a:Google AnalyticsPlausible

Estrelas
343
Forks
28
Issues abertas
5
Último commit
há 4 dias

O que é?

Traks é uma plataforma de analytics web que roda de ponta a ponta na plataforma de dados da Cloudflare, usando Workers, Durable Objects, D1, Pipelines, R2 Data Catalog (Apache Iceberg) e R2 SQL. Os visitantes são contabilizados com um hash HMAC que muda diariamente, em vez de cookies, e os endereços IP brutos não são armazenados. O tracker é uma única tag de script, e o dashboard é servido pela mesma implantação.

Os dados recentes são servidos por um Durable Object SQLite por site, com latência de milissegundos, e o dashboard recebe ao vivo visitantes, páginas, referenciadores e pontos no mapa em nível de cidade por WebSocket. Os dados históricos são armazenados como tabelas Iceberg no R2 e consultados com R2 SQL, com cache na edge. A autenticação usa Better Auth no D1, e o mapa-múndi é auto-hospedado.

O assistente de instalação em traks.dev provisiona na sua conta os dois Workers, o D1, o KV, o bucket R2 com Data Catalog e o stream e sink do Pipelines. O projeto é um monorepo Yarn e Turborepo que requer Node 20 ou posterior.

Recursos principais

  • 01Contabilização de visitantes sem cookies, com um hash que muda diariamente; os IPs brutos não são armazenados.
  • 02Visualização em tempo real de visitantes, páginas, referenciadores e localizações em nível de cidade via WebSocket.
  • 03Consultas históricas em tabelas Apache Iceberg no R2 usando R2 SQL, com cache na edge.
  • 04Implantação com um clique na sua própria conta Cloudflare por meio do assistente de instalação.
  • 05Autenticação com e-mail e senha via Better Auth no D1.
  • 06Disponibiliza analytics para agentes de IA por meio de ferramentas MCP/WebMCP e classifica o tráfego de bots.

Casos de uso

  • Usar analytics com foco em privacidade em um blog pessoal ou site pequeno, sem cookies.
  • Substituir uma assinatura de analytics hospedado e manter os dados dos visitantes na sua própria conta Cloudflare.
  • Monitorar picos de tráfego ao vivo durante um lançamento ou quando o site aparece na página inicial.
  • Permitir que agentes de IA acessem os dados de analytics do site em modo de leitura por meio de ferramentas MCP.

Início rápido

  1. 1

    Acesse traks.dev/deploy e entre com o Cloudflare; o assistente provisionará tudo na sua conta

  2. 2

    Instale as dependências para trabalhar no repositório (requer Node 20 ou superior)

    yarn install
  3. 3

    Migre o banco de dados D1 de desenvolvimento da API

    yarn workspace @traks/platform-api db:migrate:dev
  4. 4

    Inicie os servidores de desenvolvimento locais

    yarn dev

Antes de usar

  • Funciona apenas no Cloudflare e requer uma conta Cloudflare no plano Workers Paid, que custa cerca de US$ 5 por mês.
  • Para executar a plataforma localmente, você também precisa dos seus próprios projetos Doppler com secrets e de uma plataforma de dados Cloudflare provisionada.

Em coleções

Tópicos

Perguntas frequentes

O que é traks?
Analytics web auto-hospedado e sem cookies, implantado inteiramente na sua própria conta Cloudflare, sem serviços de terceiros no fluxo de dados. Traks é uma plataforma de analytics web que roda de ponta a ponta na plataforma de dados da Cloudflare, usando Workers, Durable Objects, D1, Pipelines, R2 Data Catalog (Apache Iceberg) e R2 SQL. Os visitantes são contabilizados com um hash HMAC que muda diariamente, em vez de cookies, e os endereços IP brutos não são armazenados. O tracker é uma única tag de script, e o dashboard é servido pela mesma implantação.
traks é gratuito? Qual é a licença?
traks é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
traks ainda é mantido?
Manutenção ativa. O último commit de traks foi em 4 de nov. de 2026.
Para que posso usar traks?
Usar analytics com foco em privacidade em um blog pessoal ou site pequeno, sem cookies. Substituir uma assinatura de analytics hospedado e manter os dados dos visitantes na sua própria conta Cloudflare. Monitorar picos de tráfego ao vivo durante um lançamento ou quando o site aparece na página inicial. Permitir que agentes de IA acessem os dados de analytics do site em modo de leitura por meio de ferramentas MCP.
Como instalar traks?
Acesse traks.dev/deploy e entre com o Cloudflare; o assistente provisionará tudo na sua conta Instale as dependências para trabalhar no repositório (requer Node 20 ou superior): yarn install Migre o banco de dados D1 de desenvolvimento da API: yarn workspace @traks/platform-api db:migrate:dev Inicie os servidores de desenvolvimento locais: yarn dev
Onde consigo traks?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/shivamanupadi/traks

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados