Repolode
shivamanupadi

shivamanupadi/traks

データ処理経路にサードパーティサービスを介さず、自分のCloudflareアカウント内だけで完結する、セルフホスト型・Cookie不要のWebアナリティクス。

代替できる製品:Google AnalyticsPlausible

スター
343
フォーク
29
未解決の Issue
5
最終コミット
3 日前

これは何?

Traksは、Workers、Durable Objects、D1、Pipelines、R2 Data Catalog(Apache Iceberg)、R2 SQLを利用し、Cloudflareのデータプラットフォーム上で一貫して稼働するWebアナリティクスプラットフォームです。訪問者のカウントにはCookieの代わりに日次でローテーションするHMACハッシュを使い、生のIPアドレスは保存しません。トラッカーは単一のscriptタグで設置でき、ダッシュボードも同じデプロイ環境から配信されます。

直近のデータはサイトごとのSQLite Durable Objectからミリ秒単位のレイテンシで配信されます。ダッシュボードはWebSocket経由で、リアルタイムの訪問者数、ページ、リファラー、都市レベルの地図上の地点を受信します。過去のデータはR2上のIcebergテーブルに保存され、エッジキャッシュを利用してR2 SQLでクエリされます。認証にはD1上のBetter Authを使用し、世界地図もセルフホストされます。

traks.devのインストールウィザードを使うと、2つのWorkers、D1、KV、Data Catalog付きのR2バケット、Pipelinesのストリームとシンクを自分のアカウントにプロビジョニングできます。このプロジェクトはYarnとTurborepoを使うモノレポで、Node 20以降が必要です。

主な機能

  • 01日次でローテーションするハッシュを使ったCookie不要の訪問者カウント。生のIPアドレスは保存されません。
  • 02WebSocket経由で、リアルタイムの訪問者数、ページ、リファラー、都市レベルの所在地を確認。
  • 03エッジキャッシュを利用し、R2上のApache IcebergテーブルをR2 SQLでクエリして過去のデータを分析。
  • 04インストールウィザードから、自分のCloudflareアカウントにワンクリックでデプロイ。
  • 05D1上のBetter Authによるメールアドレスとパスワードでの認証。
  • 06MCP/WebMCPツールを通じてAIエージェントにアナリティクスを提供し、ボットトラフィックを分類。

ユースケース

  • 個人ブログや小規模なWebサイトで、Cookieを使わずプライバシーに配慮したアナリティクスを運用する。
  • 訪問者データを自分のCloudflareアカウント内に保ちながら、ホスト型アナリティクスのサブスクリプションを置き換える。
  • ローンチ時やトップページへの掲載時に発生するリアルタイムのトラフィック急増を監視する。
  • MCPツール経由でAIエージェントにサイトのアナリティクスへの読み取りアクセスを提供する。

クイックスタート

  1. 1

    traks.dev/deploy を開いて Cloudflare でサインインします。ウィザードがすべてのリソースをアカウントにプロビジョニングします

  2. 2

    リポジトリで作業するための依存関係をインストールします(Node 20 以降が必要です)

    yarn install
  3. 3

    API 用の開発 D1 データベースをマイグレーションします

    yarn workspace @traks/platform-api db:migrate:dev
  4. 4

    ローカルの開発サーバーを起動します

    yarn dev

使う前に知っておきたいこと

  • Cloudflare でのみ動作し、月額約 5 ドルの Workers Paid プランが適用された Cloudflare アカウントが必要です。
  • プラットフォームをローカルで実行するには、シークレットを含む独自の Doppler プロジェクトと、プロビジョニング済みの Cloudflare データプラットフォームも必要です。

収録されている特集

トピック

よくある質問

traks とは?
データ処理経路にサードパーティサービスを介さず、自分のCloudflareアカウント内だけで完結する、セルフホスト型・Cookie不要のWebアナリティクス。 Traksは、Workers、Durable Objects、D1、Pipelines、R2 Data Catalog(Apache Iceberg)、R2 SQLを利用し、Cloudflareのデータプラットフォーム上で一貫して稼働するWebアナリティクスプラットフォームです。訪問者のカウントにはCookieの代わりに日次でローテーションするHMACハッシュを使い、生のIPアドレスは保存しません。トラッカーは単一のscriptタグで設置でき、ダッシュボードも同じデプロイ環境から配信されます。
traks は無料で使えますか?ライセンスは?
traks は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
traks は今もメンテナンスされていますか?
活発にメンテナンス中。traks の最終コミットは 2026年11月4日 です。
traks は何に使えますか?
個人ブログや小規模なWebサイトで、Cookieを使わずプライバシーに配慮したアナリティクスを運用する。 訪問者データを自分のCloudflareアカウント内に保ちながら、ホスト型アナリティクスのサブスクリプションを置き換える。 ローンチ時やトップページへの掲載時に発生するリアルタイムのトラフィック急増を監視する。 MCPツール経由でAIエージェントにサイトのアナリティクスへの読み取りアクセスを提供する。
traks のインストール方法は?
traks.dev/deploy を開いて Cloudflare でサインインします。ウィザードがすべてのリソースをアカウントにプロビジョニングします リポジトリで作業するための依存関係をインストールします(Node 20 以降が必要です): yarn install API 用の開発 D1 データベースをマイグレーションします: yarn workspace @traks/platform-api db:migrate:dev ローカルの開発サーバーを起動します: yarn dev
traks はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/shivamanupadi/traks

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト