Repolode
提交项目
benvinegar

benvinegar/counterscale

运行在 Cloudflare 上的自托管网站访问统计工具，包含追踪脚本和仪表盘。

可替代:Google Analytics

在 GitHub 查看官网
Star
2,177
Fork
137
未关闭 Issue
18
最近提交
上个月

这是什么？

Counterscale 是一个简单的网站访问统计追踪器和仪表盘，部署在你自己的 Cloudflare 账户中。它基于 Cloudflare Workers 和 Workers Analytics Engine 构建，目标是在高流量下运行成本也接近于零。

项目提供命令行安装器，自动完成 Worker、分析数据集以及可选的仪表盘密码配置。追踪代码既可以通过部署地址上的 tracker.js 脚本引入，也可以作为 npm 包在浏览器中使用，还支持在后端通过服务端模块记录页面访问。

由于 Workers Analytics Engine 最多只保留 90 天数据，项目还会把长期数据以 Apache Arrow 文件的形式写入 R2 存储桶，此功能默认开启，可通过 CLI 关闭。

核心功能

  • 01支持通过脚本标签、浏览器 npm 模块或服务端模块记录页面访问。
  • 02基于 Cloudflare Workers 运行，并提供 CLI 安装器完成部署。
  • 03可为统计仪表盘设置密码保护。
  • 04将超过 90 天保留期的数据以 Apache Arrow 文件形式长期存储到 R2。
  • 05服务端模块支持 UTM 参数，也可关闭自动追踪改为手动调用。
  • 06重新运行安装器即可升级，已有数据保留。

适用场景

  • 为个人博客或项目站点添加自托管的访问统计。
  • 在不使用浏览器脚本的后端应用中记录页面访问。
  • 在一个 Cloudflare 账户上以较低成本为多个网站提供统计。

快速上手

  1. 1

    登录 Cloudflare 并授权 Wrangler CLI

    npx wrangler login
  2. 2

    运行 Counterscale 安装程序并按提示操作

    npx @counterscale/cli@latest install
  3. 3

    将跟踪脚本代码片段添加到你的网站 HTML 中

使用前须知

  • 需要 Cloudflare 账户，且按 README 要求仅支持 macOS 或 Linux 环境。
  • Workers Analytics Engine 最多保留 90 天数据，仪表板只能显示最近 90 天（可使用 R2 长期存储）。
  • 本地开发没有测试数据库：写入不生效，读取的是生产数据。

收录于专题

自托管应用

标签

#web-analytics#cloudflare-workers#self-hosted#analytics-dashboard#typescript#serverless#analytics#cloudflare-analytics#google-analytics#website-stats

常见问题

counterscale 是什么？
运行在 Cloudflare 上的自托管网站访问统计工具，包含追踪脚本和仪表盘。 Counterscale 是一个简单的网站访问统计追踪器和仪表盘，部署在你自己的 Cloudflare 账户中。它基于 Cloudflare Workers 和 Workers Analytics Engine 构建，目标是在高流量下运行成本也接近于零。
counterscale 可以免费使用吗？用的什么许可证？
counterscale 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
counterscale 还在维护吗？
半年内有更新。counterscale 最近一次提交是在 2026年10月4日。
counterscale 适合用来做什么？
为个人博客或项目站点添加自托管的访问统计。 在不使用浏览器脚本的后端应用中记录页面访问。 在一个 Cloudflare 账户上以较低成本为多个网站提供统计。
counterscale 怎么安装和运行？
登录 Cloudflare 并授权 Wrangler CLI: npx wrangler login 运行 Counterscale 安装程序并按提示操作: npx @counterscale/cli@latest install 将跟踪脚本代码片段添加到你的网站 HTML 中
在哪里获取 counterscale？
源代码和安装说明在 GitHub 上：https://github.com/benvinegar/counterscale

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目