Repolode
umami-software

umami-software/umami

无 Cookie、注重隐私的网站分析平台,可自托管或使用云服务,统一查看流量、营销活动、用户行为与转化。

可替代:Google Analytics

Star
39,513
Fork
8,367
未关闭 Issue
125
最近提交
昨天

这是什么?

Umami 是一个注重隐私的开源网站分析平台,在同一个面板中汇总流量、营销活动、用户行为、转化和收入数据。它不使用 Cookie,适合作为 Google Analytics 类跟踪工具的轻量替代方案。

项目基于 TypeScript 开发,运行在 Node.js 上,数据存储在 PostgreSQL 中。既可以通过 pnpm 从源码安装,也可以使用官方提供的 Docker 镜像或 Docker Compose 文件部署,后者会同时启动 PostgreSQL 数据库。配置通过 DATABASE_URL、API_URL、BASE_PATH 等环境变量完成。

项目还支持可选的双因素认证(需设置加密密钥),以及默认关闭、通过 API Key 鉴权的 MCP 接口。

核心功能

  • 01在同一面板中查看流量、营销活动、用户行为、转化与收入数据。
  • 02不使用 Cookie 进行追踪。
  • 03支持自托管,也可使用 Umami 云服务。
  • 04基于 Node.js 运行,数据存储于 PostgreSQL。
  • 05提供 Docker 镜像与 Docker Compose 部署方案。
  • 06支持可选的双因素认证和 API Key。

适用场景

  • 在自有服务器上统计网站流量,避免访客数据交给第三方。
  • 在不希望使用 Cookie 同意横幅的网站上替代 Google Analytics。
  • 为营销团队追踪营销活动效果与转化数据。
  • 为内部或客户项目搭建自托管的分析服务。

快速上手

  1. 1

    从 GitHub 克隆源代码

    git clone https://github.com/umami-software/umami.git
  2. 2

    进入项目目录并使用 pnpm 安装依赖

    cd umami && pnpm install
  3. 3

    创建包含指向 PostgreSQL 数据库的 DATABASE_URL 的 .env 文件,然后构建应用

    pnpm run build
  4. 4

    启动应用(默认运行在 http://localhost:3000)

    pnpm run start

使用前须知

  • 从源码安装需要 PostgreSQL 数据库(v12.14+)和 Node.js 18.18+。
  • 构建时会创建默认登录账户,用户名 admin,密码 umami,应及时修改。

标签

常见问题

umami 是什么?
无 Cookie、注重隐私的网站分析平台,可自托管或使用云服务,统一查看流量、营销活动、用户行为与转化。 Umami 是一个注重隐私的开源网站分析平台,在同一个面板中汇总流量、营销活动、用户行为、转化和收入数据。它不使用 Cookie,适合作为 Google Analytics 类跟踪工具的轻量替代方案。
umami 可以免费使用吗?用的什么许可证?
umami 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
umami 还在维护吗?
活跃维护中。umami 最近一次提交是在 2026年10月20日。
umami 适合用来做什么?
在自有服务器上统计网站流量,避免访客数据交给第三方。 在不希望使用 Cookie 同意横幅的网站上替代 Google Analytics。 为营销团队追踪营销活动效果与转化数据。 为内部或客户项目搭建自托管的分析服务。
umami 怎么安装和运行?
从 GitHub 克隆源代码: git clone https://github.com/umami-software/umami.git 进入项目目录并使用 pnpm 安装依赖: cd umami && pnpm install 创建包含指向 PostgreSQL 数据库的 DATABASE_URL 的 .env 文件,然后构建应用: pnpm run build 启动应用(默认运行在 http://localhost:3000): pnpm run start
在哪里获取 umami?
源代码和安装说明在 GitHub 上:https://github.com/umami-software/umami

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

相关项目