oslks-telemetry

OSLKS Radarは、ウェブトラフィックの追跡に特化した高性能かつプライバシーに配慮したソリューションです。バックエンドのコレクタはRustとAxumフレームワークで実装され、イベントはTimescaleDBに保存されます。インメモリキャッシュによるO(1)のオリジン検証を行い、秒間数百万件のリクエストを処理可能です。フロントエンドはViteとShadcn UIで構築されたReactシングルページアプリケーションで、モダンなガラスモーフィズムデザイン、ダークモード、完全なPWA機能を備えています。 主な機能は以下の通りです： - ポート8080での超高速インジェスト、広告ブロッカー回避用のステルスモードルートをオプションで提供。 - ポート3000でのリアルタイムダッシュボード、ページビュー、SPAナビゲーションイベント、ジオデータ（オプションでMaxMind GeoIP）を表示。 - プライバシー第一の運用：クッキー不要、サードパーティスクリプト不要、GDPR対応、完全自己ホスト。 - ARM対応バイナリを提供し、Ampereインスタンスなど低リソース環境でも動作。 - コレクタ、Node API、Caddyサーバーを単一Dockerイメージで実行し、s6‑overlayでオーケストレーション。Docker‑ComposeでTimescaleDBコンテナも自動プロビジョン。 - サイト管理機能、サーバー間アクセス用APIキー、初期スーパーユーザー設定ウィザードを完備。 統合は、ページヘッドに<1KBのスクリプトタグを追加し、サイトUUIDとコレクタURLを指定するだけです。コレクタはCORSホワイトリストを強制し、各ドメインをCORS_ALLOWED_ORIGINSに列挙する必要があります。 デプロイはVPS、Coolify、その他類似プラットフォーム上でDocker Composeを使用して実行可能です。環境変数でデータベース接続、セッションシークレット、許可オリジン、オプションのGeoIPデータベースパスを制御します。VITE_*変数はビルド時にSPAに埋め込まれます。 本プロジェクトはMITライセンスの下でオープンソース化されており、フォーク＆プルリクエストによる貢献を歓迎します。