oslks-telemetry

OSLKS Radar는 웹사이트 트래픽 추적을 위한 고성능, 프라이버시 친화적 솔루션을 제공합니다. 백엔드 수집기는 Rust의 Axum 프레임워크로 작성되었으며, TimescaleDB에 이벤트를 저장하고 인메모리 캐시를 통해 O(1) 원본 검증을 제공하며 초당 수백만 개의 요청을 처리할 수 있습니다. 프론트엔드는 Vite와 Shadcn UI로 구축된 React 단일 페이지 애플리케이션(SPA)으로, 모던한 글래스모피즘 디자인, 다크 모드, 완전한 PWA 기능을 갖춥니다. 주요 기능은 다음과 같습니다: - 포트 8080에서 초고속 데이터 수집, 광고차단기 우회를 위한 선택형 스텔스 모드의 경로 지원 - 포트 3000에서 실시간 대시보드: 페이지뷰, SPA 내비게이션 이벤트, 지리적 데이터(MaxMind GeoIP 선택사항) 표시 - 프라이버시 우선 운영: 쿠키 없음, 제3자 스크립트 없음, GDPR 호환, 완전한 자체 호스팅 - Ampere 인스턴스 같은 저자원 환경용 ARM 호환 바이너리 - 수집기, Node API, Caddy 서버가 s6-오버레이로 오케스트레이션된 단일 Docker 이미지로 간편 설치. Docker-Compose는 TimescaleDB 컨테이너도 프로비저닝합니다. - 포괄적인 사이트 관리, 서버 간 접근용 API 키, 초기 슈퍼유저 설정을 위한 설치 마법사 연결은 웹사이트 UUID와 수집기 URL을 지정하는 tiny <1KB 스크립트 태그를 페이지 헤드에 추가하는 방식으로 이루어집니다. 수집기는 CORS 화이트리스트를 강제하며, 각 도메인은 CORS_ALLOWED_ORIGINS에 명시되어야 합니다. 배포는 Docker Compose를 통해 모든 VPS, Coolify 또는 유사한 플랫폼에서 수행할 수 있습니다. 환경 변수는 데이터베이스 연결, 세션 비밀키, 허용된 origins, 선택사항 GeoIP 데이터베이스 경로 등을 제어합니다. VITE_* 변수는 빌드 시점에 SPA에 내장됩니다. 이 프로젝트는 MIT 라이선스로 오픈소스이며, 포크 앤 풀 리퀘스트 워크플로를 통해 기여를 환영합니다.