Repolode
benvinegar

benvinegar/counterscale

Cloudflare WorkersとWorkers Analytics Engineで動作する、セルフホスト型のWeb分析トラッカー兼ダッシュボード。

代替できる製品:Google Analytics

スター
2,177
フォーク
137
未解決の Issue
18
最終コミット
先月

これは何?

Counterscaleは、Cloudflare上で自分でホストできるシンプルなWeb分析トラッカー兼ダッシュボードです。Cloudflare WorkersとWorkers Analytics Engineを基盤とし、トラフィックが多い場合でも運用コストをほぼゼロに抑えることを目指しています。

デプロイはCLIインストーラーで行い、Worker、分析用データセット、任意のダッシュボード用パスワードを設定できます。デプロイ先のURLからトラッカーをスクリプトとして読み込む方法、ブラウザー向けnpmパッケージとしてインストールする方法、サーバーサイドモジュールを呼び出してバックエンドからページビューを記録する方法があります。

Workers Analytics Engineのデータ保持期間は最長90日のため、長期データはApache ArrowファイルとしてR2バケットにも書き込みます。この機能はデフォルトで有効で、CLIから無効にできます。

主な機能

  • 01scriptタグ、ブラウザー向けnpmモジュール、またはサーバーサイドモジュールでページビューを記録できます。
  • 02デプロイ用CLIインストーラーを備え、Cloudflare Workers上で動作します。
  • 03分析ダッシュボードを任意でパスワード保護できます。
  • 0490日のデータ保持期間を超える長期データを、Apache ArrowファイルとしてR2に保存します。
  • 05サーバーモジュールで、手動のページビュー記録とUTMパラメーターに対応しています。
  • 06インストーラーを再実行してアップグレードでき、既存データは失われません。

ユースケース

  • 個人ブログやプロジェクトサイトに、プライバシーに配慮したセルフホスト型のアクセス解析を追加する。
  • ブラウザースクリプトを使わず、バックエンドアプリケーションからページビューを記録する。
  • 1つのCloudflareアカウントで複数サイトの低コストなアクセス解析を運用する。

クイックスタート

  1. 1

    CloudflareにサインインしてWranglerを認証する

    npx wrangler login
  2. 2

    Counterscaleのインストーラーを実行し、表示される指示に従う

    npx @counterscale/cli@latest install
  3. 3

    トラッキングスクリプトのスニペットをウェブサイトのHTMLに追加する

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

  • READMEの要件により、Cloudflareアカウントが必要で、macOSまたはLinuxでのみ実行できます。
  • Workers Analytics Engineのデータ保持期間は最大90日間のため、ダッシュボードには直近90日間のデータのみが表示されます(長期保存にはR2を利用できます)。
  • ローカル開発用のテストデータベースはありません。書き込みは何も行われず、読み取りには本番データが表示されます。

収録されている特集

トピック

よくある質問

counterscale とは?
Cloudflare WorkersとWorkers Analytics Engineで動作する、セルフホスト型のWeb分析トラッカー兼ダッシュボード。 Counterscaleは、Cloudflare上で自分でホストできるシンプルなWeb分析トラッカー兼ダッシュボードです。Cloudflare WorkersとWorkers Analytics Engineを基盤とし、トラフィックが多い場合でも運用コストをほぼゼロに抑えることを目指しています。
counterscale は無料で使えますか?ライセンスは?
counterscale は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
counterscale は今もメンテナンスされていますか?
半年以内に更新あり。counterscale の最終コミットは 2026年10月4日 です。
counterscale は何に使えますか?
個人ブログやプロジェクトサイトに、プライバシーに配慮したセルフホスト型のアクセス解析を追加する。 ブラウザースクリプトを使わず、バックエンドアプリケーションからページビューを記録する。 1つのCloudflareアカウントで複数サイトの低コストなアクセス解析を運用する。
counterscale のインストール方法は?
CloudflareにサインインしてWranglerを認証する: npx wrangler login Counterscaleのインストーラーを実行し、表示される指示に従う: npx @counterscale/cli@latest install トラッキングスクリプトのスニペットをウェブサイトのHTMLに追加する
counterscale はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/benvinegar/counterscale

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

関連プロジェクト