Google Analytics 提供了极其全面的访问数据，代价是把访客的行为也拱手交给 Google。随着 GDPR、CCPA 等法规普及，越来越多站长在寻找一个合规又足够好用的替代方案。Umami 就是目前热度最高的开源网站分析工具之一：轻量、不用 Cookie、默认 GDPR 合规。
一、什么是 Umami？
Umami 官方定位为 "an open-source web analytics platform that respects user privacy"——一款尊重隐私的开源网站分析平台。它能提供页面浏览量、访客数、跳出率、会话时长、来源渠道、设备/地区等所有主流指标，但不写入 Cookie、不采集个人信息。
- 官网：umami.is
- 文档：docs.umami.is
二、核心能力
- 主流分析指标：页面浏览量 (PV)、独立访客 (UV)、跳出率、会话时长、来源/引荐、浏览器、操作系统、地理位置、设备类型。
- 自定义事件：通过
data-umami-event属性或 JS 调用，追踪按钮点击、表单提交、下载等业务事件。 - 漏斗 / 留存 / 用户旅程：分析行为路径与留存曲线。
- 多站点共用：一个实例可以管理多个站点的 tracking code。
- 公开分享链接：把数据仪表板公开给客户或团队成员。
三、为什么"隐私友好"
- 不使用 Cookie，不跨站追踪；
- 不采集 IP、用户 ID 等可识别个人身份的信息；
- 官方描述为 "GDPR compliant out of the box"——开箱即用即满足 GDPR；
- 追踪脚本体积 < 2KB，对页面性能影响极小。
四、架构一览
Umami 本质是一个 Next.js 应用，搭配一个关系数据库即可运行：
[访客浏览器]
│
│ ① 加载 tracker script.js (<2KB)
│
▼
[Umami Next.js App] ←→ [PostgreSQL / MySQL]
│
│ ② 数据写入：pageviews / events / sessions
│
▼
[管理仪表盘 + 分享链接]官方要求：
- Node.js：18.18 及以上
- 数据库：PostgreSQL 12.14+ 或 MySQL（文档推荐 PostgreSQL，且建议使用 UTC 时区）
五、Docker Compose 部署
官方推荐最简部署方式：
# 克隆仓库
git clone https://github.com/umami-software/umami.git
cd umami
# 启动（含 Postgres）
docker compose up -d默认访问地址为 http://localhost:3000，初始用户名/密码为 admin / umami——登录后务必立即修改密码。
六、在 1Panel 上的部署
1Panel 应用商店提供了 Umami 一键安装，自动完成 Next.js 应用与 PostgreSQL 的编排，只需设置端口、卷路径即可。后续可在"网站"中创建反代，绑定 analytics.your-domain.com 并自动签发 TLS 证书。
七、嵌入追踪脚本
登录 Umami → 在 Websites 添加站点 → 查看追踪代码。代码形如：
<script defer
src="https://analytics.your-domain.com/script.js"
data-website-id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx">
</script>把这段代码放到目标站点的 <head> 中。几分钟后，仪表板就会开始显示访客数据。
八、自定义事件示例
想要追踪一个"订阅"按钮点击，只需：
<button data-umami-event="subscribe-click">订阅</button>或通过 JS：
umami.track('subscribe-click', { plan: 'pro' });九、使用前需要注意
- 首次登录务必改密码：默认
admin / umami公开可查。 - 数据库备份：分析数据会持续累积，按周/月备份 Postgres 数据目录。
- 反向代理与 HTTPS：追踪脚本跨域加载，强烈建议通过 HTTPS 服务，避免浏览器拦截。
- AdBlock 拦截：部分广告拦截列表会屏蔽通用
analytics路径，建议将脚本托管在自有域名的子路径上（Umami 支持自定义路径）。
参考链接
- Umami 官网：https://umami.is/
- 安装文档：https://docs.umami.is/docs/install
- GitHub 仓库：https://github.com/umami-software/umami
评论