一、项目简介

Umami 是一款轻量、高效、隐私优先的开源网站数据分析平台，主打无 Cookie、无用户隐私追踪，是 Google Analytics、百度统计的优质开源替代品。项目基于 Next.js + TypeScript 开发，支持自托管与云端部署，所有数据完全由用户自主掌控，规避了第三方统计工具的数据泄露与隐私合规风险，广泛适用于个人博客、企业官网、产品站点等各类网站的流量与行为分析场景。

项目开源地址：https://github.com/umami-software/umami

开源协议：MIT License，可自由商用、二次开发

二、核心特性

1. 极致隐私合规

全程不使用 Cookie 追踪、不收集用户个人隐私信息，完全符合 GDPR、PECR 等全球主流隐私法规，无需在网站添加繁琐的隐私授权弹窗，兼顾用户体验与合规性。所有统计数据留存于自有服务器，无第三方数据共享、无数据采集滥用问题。

2. 全面的数据分析能力

集成一站式网站数据分析能力，覆盖网站运营核心需求：

• 基础流量统计：实时访问量、访客数、页面浏览量、访问时长、跳出率等核心指标

• 访客行为分析：用户访问轨迹、页面停留偏好、热门内容、设备类型、浏览器、地域分布统计

• 进阶数据洞察：漏斗分析、用户留存、队列分析、转化目标统计、UTM 营销活动追踪

• 团队协作能力：支持多用户管理、网站权限分配、角色划分，适配团队运营场景

• 完整 API 支持：提供全套 REST API，支持程序化读取、管理分析数据，可对接自有系统

3. 轻量高效、低侵入性

统计追踪脚本体积极小，加载速度快，对网站页面加载性能几乎无影响，同时可规避主流浏览器广告拦截插件的误拦截问题，保障数据统计的完整性与准确性。后台界面简洁直观，数据可视化清晰，核心指标一目了然，上手门槛极低。

4. 灵活部署、高度可控

支持源码部署、Docker 一键部署、Podman 部署等多种方式，适配服务器、NAS、云服务器等各类环境。支持自定义 API 地址、二级密码验证、加密密钥配置，功能可灵活裁剪拓展，适配个人、小型团队、企业等不同使用场景。

三、环境依赖

部署 Umami 需满足以下基础环境要求：

• Node.js：18.18 及以上版本

• 数据库：PostgreSQL 12.14 及以上版本

• 包管理工具：pnpm（项目默认依赖）

四、详细部署教程

1. 源码部署方式

适合需要二次开发、自定义修改功能的用户，步骤简单清晰：

# 克隆源码仓库
git clone https://github.com/umami-software/umami.git
cd umami

# 安装项目依赖
pnpm install

# 配置环境变量，新建 .env 文件
# 核心配置：数据库连接地址
DATABASE_URL=postgresql://username:mypassword@localhost:5432/mydb
# 可选：自定义内部 API 地址
API_URL=/internal-api
# 可选：开启双重验证（生成64位十六进制密钥：openssl rand -hex 32）
TWO_FACTOR_ENCRYPTION_KEY=你的64位加密密钥

# 构建项目（自动初始化数据库表结构）
pnpm run build

# 启动服务（默认端口3000）
pnpm run start

默认登录账号：admin，默认密码：umami，首次登录建议立即修改密码。

2. Docker 一键部署（推荐）

无需配置复杂环境，开箱即用，自动适配 PostgreSQL 数据库：

# 拉取官方镜像
docker pull docker.umami.is/umami-software/umami:latest

# Docker Compose 启动（包含数据库服务）
docker compose up -d

部署完成后，通过 http://localhost:3000 即可访问后台管理界面。

五、项目更新方式

1. 源码部署更新

# 拉取最新源码
git pull

# 更新依赖、重新构建
pnpm install
pnpm build

2. Docker 部署更新

# 拉取最新镜像并重启服务
docker compose pull
docker compose up --force-recreate -d

六、项目优势总结

相较于传统第三方网站统计工具，Umami 核心优势十分突出：摒弃隐私追踪机制，合规无负担；数据私有化部署，自主可控不泄露；轻量无性能损耗，统计精准高效；开源免费无广告，功能全面且可自由拓展。无论是个人站长搭建独立站点统计，还是企业搭建私有化数据分析体系，都是性价比极高的选择。