Umami – 简单、快速、注重隐私的 Google Analytics 替代方案。

Umami 是一个现代、注重隐私的开源网站分析平台，是 Google Analytics、Mixpanel 和 Amplitude 的替代方案。

核心特点

• 简单快速：界面简洁，部署和使用门槛低
• 隐私优先：无需 Cookie 横幅，符合 GDPR 等隐私法规，不追踪个人身份信息
• 开源免费：代码完全开源，可自托管，数据完全由自己掌控

技术栈与部署

项目	要求
运行环境	Node.js 18.18+
数据库	PostgreSQL 12.14+
包管理器	pnpm

快速安装（源码方式）

git clone https://github.com/umami-software/umami.git
cd umami
pnpm install

创建 .env 文件配置数据库连接：

DATABASE_URL=postgresql://username:mypassword@localhost:5432/mydb    # 连接URL格式

然后构建并启动：

pnpm run build    # 首次构建会自动创建数据库表和默认管理员账户（admin / umami）
pnpm run start    # 默认运行在 http://localhost:3000

Docker 部署

docker pull docker.umami.is/umami-software/umami:latest

也可以使用项目自带的 docker compose up -d 一键启动（包含 PostgreSQL）。

获取更新

docker compose pull
docker compose up --force-recreate -d

官方资源

• 官网与文档：umami.is/docs
• GitHub 仓库：github.com/umami-software/umami