Repolode
benvinegar

benvinegar/counterscale

Herramienta autoalojada para registrar analíticas web y consultar un panel, que funciona en Cloudflare Workers y Workers Analytics Engine.

Alternativa open source a:Google Analytics

Estrellas
2,177
Forks
137
Issues abiertos
18
Último commit
el mes pasado

¿Qué es?

Counterscale es una herramienta sencilla para registrar analíticas web y consultar un panel que alojas en tu propia cuenta de Cloudflare. Está desarrollada sobre Cloudflare Workers y Workers Analytics Engine, y el proyecto busca mantener los costos de operación cerca de cero, incluso con un volumen de tráfico elevado.

La implementación se gestiona mediante un instalador CLI que configura el Worker, el conjunto de datos de analíticas y una contraseña opcional para el panel. Puedes cargar el tracker como un script desde la URL donde lo hayas implementado, instalarlo como paquete npm para el navegador o llamar a un módulo del lado del servidor para registrar vistas de página desde tu backend.

Como Workers Analytics Engine conserva los datos durante un máximo de 90 días, el proyecto también guarda datos a largo plazo en un bucket de R2 como archivos Apache Arrow. Esta opción está activada de forma predeterminada y se puede desactivar mediante el CLI.

Funciones clave

  • 01Registra vistas de página mediante una etiqueta de script, un módulo npm para el navegador o un módulo del lado del servidor.
  • 02Funciona en Cloudflare Workers e incluye un instalador CLI para la implementación.
  • 03Permite proteger el panel de analíticas con una contraseña opcional.
  • 04Guarda datos a largo plazo en R2 como archivos Apache Arrow, más allá del límite de retención de 90 días.
  • 05Admite el seguimiento manual de vistas de página y parámetros UTM en el módulo del servidor.
  • 06Se actualiza al volver a ejecutar el instalador, sin perder los datos existentes.

Casos de uso

  • Añadir estadísticas de tráfico respetuosas con la privacidad y autoalojadas a un blog personal o al sitio de un proyecto.
  • Registrar vistas de página desde una aplicación backend que no utiliza scripts en el navegador.
  • Usar analíticas de bajo costo para varios sitios web en una cuenta de Cloudflare.

Inicio rápido

  1. 1

    Inicia sesión en Cloudflare y autoriza Wrangler

    npx wrangler login
  2. 2

    Ejecuta el instalador de Counterscale y sigue las indicaciones

    npx @counterscale/cli@latest install
  3. 3

    Añade el fragmento del script de seguimiento al HTML de tu sitio web

Antes de usarlo

  • Según los requisitos del README, necesitas una cuenta de Cloudflare y solo se ejecuta en macOS o Linux.
  • Workers Analytics Engine conserva los datos durante un máximo de 90 días, por lo que el panel solo muestra los últimos 90 días (hay almacenamiento R2 disponible para conservarlos a largo plazo).
  • El desarrollo local no tiene una base de datos de prueba: las escrituras no hacen nada y las lecturas muestran datos de producción.

En colecciones

Temas

Preguntas frecuentes

¿Qué es counterscale?
Herramienta autoalojada para registrar analíticas web y consultar un panel, que funciona en Cloudflare Workers y Workers Analytics Engine. Counterscale es una herramienta sencilla para registrar analíticas web y consultar un panel que alojas en tu propia cuenta de Cloudflare. Está desarrollada sobre Cloudflare Workers y Workers Analytics Engine, y el proyecto busca mantener los costos de operación cerca de cero, incluso con un volumen de tráfico elevado.
¿counterscale es gratuito? ¿Qué licencia tiene?
counterscale es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿counterscale sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de counterscale fue el 4 oct 2026.
¿Para qué puedo usar counterscale?
Añadir estadísticas de tráfico respetuosas con la privacidad y autoalojadas a un blog personal o al sitio de un proyecto. Registrar vistas de página desde una aplicación backend que no utiliza scripts en el navegador. Usar analíticas de bajo costo para varios sitios web en una cuenta de Cloudflare.
¿Cómo se instala counterscale?
Inicia sesión en Cloudflare y autoriza Wrangler: npx wrangler login Ejecuta el instalador de Counterscale y sigue las indicaciones: npx @counterscale/cli@latest install Añade el fragmento del script de seguimiento al HTML de tu sitio web
¿Dónde consigo counterscale?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/benvinegar/counterscale

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados