azoth

Azoth 是一款开源、自托管的 Web 分析解决方案，专为注重隐私的网站设计。它完全运行在 Cloudflare Workers 与 Cloudflare Analytics Engine 之上，无需任何外部服务或第三方脚本。 ### 核心特性 - **无 Cookie 追踪** – 客户端追踪器仅约 1.4 KB（压缩后约 0.6 KB），通过 `sendBeacon` API 上报页面浏览量，确保不存储任何 Cookie 或个人数据。 - **隐私优先** – 不收集个人身份信息（PII），也不依赖任何第三方基础设施，是符合 GDPR 部署需求的 Google Analytics 强力替代方案。 - **Cloudflare 自托管** – 部署为两个 Worker：一个用于追踪端点，另一个用于 React 仪表板，均由 Cloudflare Analytics Engine 提供快速、可扩展的存储支持。 - **React 仪表板** – 现代 UI，查询 Analytics Engine 以展示页面浏览量统计、引荐来源、设备分布等信息。 - **CLI 驱动部署** – `azoth` CLI（基于 Bun 构建）引导用户完成 Cloudflare 认证、配置修补、密钥管理（`AUTH_SECRET`、`CF_API_TOKEN`）以及一键部署（`bunx azoth install`）。 - **诊断工具** – `azoth doctor` 执行只读检查，`azoth status` 显示当前部署状态，`--dry-run` 模式可在不实际执行的情况下预览更改。 - **开发者工具链** – 包含 Linting（Biome）、类型检查（TypeScript）及工作区测试脚本，全部可通过 Bun 运行。 ### 快速开始 ```bash bun install bunx azoth install ``` 安装程序将： 1. 验证您的 Cloudflare 登录状态。 2. 用您的账户 ID 修补 `wrangler.toml`。 3. 设置所需密钥。 4. 部署两个 Worker。 5. 执行健康检查并输出供您网站嵌入的代码片段。 其他命令： - `bunx azoth doctor` – 部署前诊断（支持 `--json`）。 - `bunx azoth status` – 查看账户、Worker、密钥及最近部署信息。 - `bunx azoth install --yes` – 非交互模式。 - `bunx azoth install --dry-run` – 预览更改。 ### 技术栈 - **运行时**：Bun（v1.3.14）—— 快速的端到端 JavaScript 运行时。 - **平台**：Cloudflare Workers + Analytics Engine。 - **前端**：React 用于仪表板。 - **CLI**：基于 Bun 构建，利用 Cloudflare API 实现自动化。 ### 许可证 Azoth 根据 MIT 许可证发布（© 2026 Ediz Yurdakul）。 该项目适合需要轻量级、尊重隐私的 Web 分析解决方案的开发者和网站所有者，可完全托管并控制于 Cloudflare 边缘网络之上。