oslks-telemetry

OSLKS Radar ofrece una solución de alto rendimiento y respetuosa con la privacidad para rastrear el tráfico web. El colector backend está escrito en Rust usando el framework Axum y almacena eventos en TimescaleDB, ofreciendo validación de origen O(1) mediante una caché en memoria y soportando millones de solicitudes por segundo. El frontend es una aplicación de una sola página en React construida con Vite y Shadcn UI, que ofrece un diseño moderno con glassmorphism, modo oscuro y capacidades PWA completas. Características principales: - Ingesta ultrarrápida en el puerto 8080, con rutas opcionales de modo stealth para evitar bloqueadores de publicidad. - Paneles en tiempo real en el puerto 3000, mostrando vistas de página, eventos de navegación SPA y datos geográficos (GeoIP opcional de MaxMind). - Operación privacy-first: sin cookies, sin scripts de terceros, compatible con GDPR y totalmente autoalojada. - Binarios compatibles con ARM para entornos de bajos recursos como instancias Ampere. - Instalación sencilla mediante una única imagen Docker que ejecuta el colector, una API Node y un servidor Caddy, orquestados con s6-overlay. Docker Compose también provisiona un contenedor de TimescaleDB. - Gestión integral de sitios, claves API para acceso servidor a servidor y asistente de instalación para configuración inicial del superusuario. La integración se realiza añadiendo una etiqueta script de menos de 1KB al encabezado de la página, especificando el UUID del sitio y la URL del colector. El colector aplica una lista blanca CORS, requiriendo que cada dominio esté registrado en CORS_ALLOWED_ORIGINS. El despliegue puede realizarse con Docker Compose en cualquier VPS, Coolify o plataforma similar. Las variables de entorno controlan la conexión a la base de datos, el secreto de sesión, los orígenes permitidos y la ruta opcional de la base de datos GeoIP. Las variables VITE_* se incorporan en la SPA durante la compilación. El proyecto es de código abierto bajo la licencia MIT y acepta contribuciones mediante el flujo de fork y pull request.