Umami

在线

Umami 是一个开源、隐私优先的网站分析工具，支持实时流量统计、自定义事件追踪、多站点管理，适合作为 Google Analytics 的轻量且安全替代方案。

最后更新: 2025/7/5

详细描述

Umami – 隐私优先的开源网站分析工具

什么是 Umami？

Umami 是一个简单、快速、专注隐私的网站分析工具。它是 Google Analytics 的轻量级开源替代方案，可让网站所有者全权控制数据，同时避免收集访客个人信息，符合 GDPR/CCPA 等隐私法规

为什么选择 Umami？

隐私优先：不使用 cookie，也不追踪个人用户；数据全掌握在自己手中
开源自托管：免费使用，无闭源黑盒，社区持续优化，可自行部署或使用官方云服务。
界面简洁：提供实时统计、页面流量、设备/语言/地区数据，直观易用
快速部署：支持 Docker 和手动安装，兼容 PostgreSQL/MySQL/MariaDB 等常见数据库

Umami 的核心功能

实时页面访问统计：包括页面浏览量、唯一访客、来源、设备类型等。
自定义事件追踪：跟踪按钮点击、表单提交等交互事件
访客行为分析：会话、留存率、转化渠道等趋势对比分析。
UTM 与渠道统计：支持 UTM 参数跟踪，可分组监控广告活动表现
多用户与多站点管理：可设置团队权限、管理多个站点，支持导出 CSV

如何安装与开始使用 Umami？

一、快速部署（推荐 Docker）

确保已安装 Docker 和 Docker Compose 后，创建 docker-compose.yml 文件：

version: '3'
services:
  umami:
    image: ghcr.io/umami-software/umami:postgresql-latest
    ports:
      - '3000:3000'
    environment:
      DATABASE_URL: postgresql://umami:password@db:5432/umami
      DATABASE_TYPE: postgresql
      APP_SECRET: 随机字符串
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: password
    volumes:
      - umami-db-data:/var/lib/postgresql/data
volumes:
  umami-db-data:

执行：

docker compose up -d

访问 http://localhost:3000，使用默认 admin 账号登录。

二、本地安装（Node.js 方式）

克隆代码：

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

配置环境变量：
在 .env 文件里设置 DATABASE_URL=postgresql://... 或 mysql://...。
构建并运行应用：
```
npm run build
npm run start
```

登录地址通常为 http://localhost:3000。

使用小贴士

部署到云端：官方云和第三方平台（如 Render、Elestio）支持一键部署
添加追踪代码：在 <head> 插入 <script defer src="…/script.js" data-website-id="…"> 即可开始收集页面数据 ([dev.to][5])。
追踪事件交互：使用 JS 调用 umami.track('button_click') 跟踪具体交互事件
多站点管理：在仪表盘中可添加多个站点，适合管理多个项目。