Umami是什么?从入门到部署使用的完整教程(2026最新自建指南)
2026-06-24 9 0
什么是 Umami:轻量级开源网站分析工具
Umami 是一款开源的网站统计与访问分析工具,主打隐私优先的设计理念。它可以替代 Google Analytics,为站长提供基础但关键的网站数据分析能力,例如访问量、访客来源、页面浏览、设备类型等。

Umami 官网:https://umami.is/
与传统统计工具不同,Umami 不使用 Cookie,也不会收集个人身份信息,因此天然符合 GDPR 等隐私规范,同时减少了对用户的追踪干扰。
根据官方说明,Umami 的核心优势包括:
- 无 Cookie、无跨站追踪
- 数据完全自托管
- 轻量级前端脚本(小于 2KB)
- 部署简单,几分钟即可启动
这些特点让它非常适合个人站长、中小型网站以及注重隐私的开发者使用。
Umami 的核心功能与适用场景
Umami 并不是重型分析平台,而是一个偏向实用主义的工具,它提供的功能集中在关键指标上:
- 页面访问量与独立访客统计
- 来源网站(Referrer)分析
- 设备、浏览器与系统分布
- 地域访问统计
- UTM 营销参数分析
- 自定义事件(按钮点击、表单提交等)
此外,它还支持 API 调用和多站点管理,适合用来做:
- 个人博客数据分析
- 企业官网流量监控
- 产品落地页转化追踪
- 自建数据看板系统
整体风格类似简化版 Google Analytics,但更干净、更专注核心指标。
值得一提的是,Umami 支持中文界面,而且支持多语言切换。Umami 内置了多语言系统,可以在后台界面点击顶部的地球图标来切换语言,其中就包含简体中文和繁体中文支持 。
Umami 的部署方式(Docker 最推荐)
目前最主流的方式是使用 Docker 部署 Umami,这是官方推荐的快速安装路径之一。
1. 基础环境准备
你需要准备:
- 一台 VPS(1GB 内存即可)
- 已安装 Docker + Docker Compose
- 一个数据库(PostgreSQL 或 MySQL)
2. 快速 Docker Compose 部署
典型部署流程如下:
docker compose up -d
启动后即可访问:http://服务器IP:3000
默认账号为:
- 用户名:admin
- 密码:umami
3. 标准生产环境部署(推荐)
在生产环境中,一般会使用 PostgreSQL + Docker Compose:
核心步骤包括:
- 创建数据库环境变量
- 编写 docker-compose.yml
- 启动容器
- 配置反向代理(Nginx / Caddy)
- 绑定域名 + HTTPS
这样可以保证:
- 数据持久化
- 更高安全性
- 支持域名访问
- 可扩展性更强
4. 推荐架构(生产环境)
一个较常见的部署结构是:
- Nginx / Caddy(反向代理 + HTTPS)
- Umami Web 服务
- PostgreSQL 数据库
- VPS 云服务器
通过反向代理,可以把 Umami 访问地址变成:https://analytics.yourdomain.com
如何在网站中接入 Umami
部署完成后,只需要在网站 <head> 中加入一段统计脚本:
<script async src="https://your-domain.com/script.js" data-website-id="YOUR_ID"></script>
然后:
- 登录 Umami 后台
- 添加你的网站
- 获取 Website ID
- 粘贴到页面即可开始统计
访问网站后,数据会实时出现在后台 Dashboard 中。
Umami 的优势与局限
优势:
- 极简设计,上手非常快
- 完全自托管,数据安全可控
- 无 Cookie,隐私友好
- 资源占用低,适合小服务器
局限:
- 不适合复杂广告归因分析
- 不支持 Google Analytics 那种深度行为建模
- 高级分析能力有限(但够用)
总结
Umami 是一款非常适合站长和开发者的轻量级统计工具。它的核心价值不是功能多,而是简单、隐私、可控。
如果你希望:
- 不依赖第三方分析平台
- 拥有自己的访问数据
- 快速搭建一个轻量统计系统
那么 Umami 是一个非常值得尝试的选择。