这个项目能做什么
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 工作流贡献代码。
评论
0 评分人数达到10人后显示
登录后参与讨论。