这个项目能做什么

OSLKS Radar 为网站流量追踪提供了一种高性能且隐私友好的解决方案。后端采集器使用 Rust 的 Axum 框架编写,并将事件存储在 TimescaleDB 中,通过内存缓存实现 O(1) 的来源验证,支持每秒数百万次请求。前端是一个使用 Vite 和 Shadcn UI 构建的 React 单页应用程序 (SPA),采用现代的玻璃拟态设计,支持暗黑模式和完整的 PWA 功能。 核心特性包括: - 在 8080 端口提供极速摄取,并可选使用隐身模式路由以绕过广告拦截器。 - 在 3000 端口提供实时仪表盘,显示页面浏览量、SPA 导航事件和地理数据(可选 MaxMind GeoIP)。 - 隐私优先运行:无 Cookie,无第三方脚本,兼容 GDPR 且完全自托管。 - 提供兼容 ARM 的二进制文件,适用于 Ampere 实例等低资源环境。 - 通过单个 Docker 镜像即可简单安装,该镜像运行采集器、Node API 和 Caddy 服务器,并由 s6-overlay 编排。Docker-Compose 还会配置一个 TimescaleDB 容器。 - 完善的站点管理、用于服务器间访问的 API 密钥,以及用于初始超级用户设置的安装向导。 集成方式是在页面头部添加一个小于 1KB 的脚本标签,指定网站 UUID 和采集器 URL。采集器强制执行 CORS 白名单,要求每个域名必须列在 CORS_ALLOWED_ORIGINS 中。 部署可以通过 Docker Compose 在任何 VPS、Coolify 或类似平台上完成。环境变量用于控制数据库连接、会话密钥、允许的来源以及可选的 GeoIP 数据库路径。VITE_* 变量在构建时被植入 SPA 中。 该项目基于 MIT 许可证开源,欢迎通过 fork-and-pull-request 工作流贡献代码。