Umami | 隐私优先的开源网站分析平台，支持自托管部署

Umami 是采用 MIT 许可的开源网站分析平台，可自托管，也有云端服务。它把页面访问、来源、活动、行为、转化和收入放在同一套分析界面里，适合想掌握网站数据、并愿意维护应用与数据库的站长和小团队。

先决定想知道什么，再增加采集内容

对内容站，常见问题是“读者从哪里来、主要看哪些文章”；对产品站，还会关心“看完介绍的人有没有点击试用”。前一类主要靠页面与来源数据，后一类需要给关键动作定义事件。只看访问量，无法知道读者有没有完成你希望发生的动作。

Umami 的报告需要建立在实际采集上。自托管成功后，还要在后台添加网站，把该网站的追踪代码放进页面的 <head>。服务能登录，只能说明后台已启动，不能证明站点已经开始上报访问。

添加需要统计的网站，从该网站的 Tracking code 区域复制代码。
把代码加入站点公共模板，确认需要统计的页面都能加载它。Next.js 等框架按官方集成方式使用对应脚本组件。
访问一页，检查后台数据；没有出现时，先查看脚本加载和请求是否成功，再看网站标识与时间范围。
页面采集稳定以后，再给下载、试用或其他关键动作增加事件，并核对事件是否按预期触发。

广告拦截、网络失败和部署遗漏都会造成漏报，统计结果也不会自动等同服务器访问日志。单页应用的导航可以由 Umami 自动追踪，仍应在自己的路由与部署环境中确认结果。

按钮点击与业务完成，别取同一个名字

假设有一个“试用”按钮，可以把点击记为 trial-click。下面是事件属性的用法示例，前提是页面已安装 Umami 追踪脚本：

<button data-umami-event="trial-click">试用</button>

这个事件说明按钮被点击了，不说明试用账户已经创建。如果要衡量注册完成，应在真正成功的位置另记事件。事件名称清楚，漏斗里的每一步才有含义；同一次业务动作重复上报，也会改变你看到的数量。

数据属性适合简单点击，JavaScript 的 umami.track() 适合由应用判断的动作和动态数据。事件属性只传分析所需的信息，不把邮箱、令牌、订单备注或完整查询参数顺手塞进去。每个字段是否收集，都应有明确的分析用途。

Umami GitHub 仓库文件结构与项目概览 — Umami GitHub 仓库页面：可看到 `src`、`prisma`、`docker` 等目录，以及主分支、MIT 许可证和 v3.3.1 Release。页面信息核对于 2026-09-02。

自托管要保存两部分：应用配置与数据库

Docker Compose 路线

官方 docker-compose.yml 连接 Umami 与 PostgreSQL，并为数据库挂载 umami-db-data 卷。取得文件后，先修改数据库密码、DATABASE_URL 和 APP_SECRET；如启用双因素认证，再生成所需的 64 位十六进制 TWO_FACTOR_ENCRYPTION_KEY。示例占位值不能直接作为正式配置。

docker compose up -d

默认应用端口为 3000。首次登录账号为 admin、密码为 umami，应立即更改。对外访问时配好域名、HTTPS 和访问控制；备份 PostgreSQL 与必要配置，重建镜像不能找回丢失的统计数据。

源码路线

源码安装使用 Node.js、pnpm 与 PostgreSQL，在根目录设置 DATABASE_URL，依次安装依赖、构建和启动。README 的最低环境说明与主分支依赖可能不同时更新，选择版本时应一并查看包配置和依赖要求，不把旧最低值当成任意新版本的兼容承诺。

git clone https://github.com/umami-software/umami.git
cd umami
pnpm install
# 配置 .env 中的 DATABASE_URL 后
pnpm run build
pnpm run start

修改后台和接口可从 src/ 入手，数据库结构与迁移看 prisma/，追踪产物的构建看根目录 tracker 相关配置。依赖清单不等于外部服务清单，按所用功能和对应文档增加组件。

“无 Cookie”不能替你决定该收集什么

README 以“隐私优先、无 Cookie”描述产品，但自定义事件、服务器日志、数据库副本和访问权限仍由部署方控制。选择自托管，主要改变应用和数据由谁维护、放在哪里，不会自动完成数据最小化或用户告知。

可以先记录页面与少量有明确用途的事件，再根据实际问题增加字段。共享报告、保留多久、谁能访问后台，也要与数据内容一起安排。可选 MCP 入口默认关闭，只有需要自动化访问分析数据时再按文档启用并配置 API Key。

升级前备份数据库，查看所选版本的迁移和变更，再检查登录、追踪脚本、事件与常用报告。固定应用版本，有助于分清统计变化来自网站行为，还是采集和软件配置变化。

项目仓库与自托管说明：https://github.com/umami-software/umami
采集代码安装：https://docs.umami.is/docs/collect-data
事件追踪：https://docs.umami.is/docs/track-events

1.本站所发布资源部分收集于网络，仅限用于学习和研究测试使用。2.本站资源售价仅为赞助网站，赞助收费仅用于网站维护运营更新，感谢您的支持。3.本站仅保证资源的正常下载和测试使用，售后不包含相关技术咨询服务，请知悉谅解。4.本站所发布资源为非实物商品，不接受退款，请考虑好再进行支付赞助获取下载。
赞助获取下载注意：
1.支付赞助成功后请勿关闭窗口或其他操作，等待系统自动确认，按钮变为获取下载按钮。2.游客操作请使用 Chrome、Edge 或 FireFox 浏览器，以免支付刷新失败(浏览器缓存7天有效)。3.如支付赞助成功后刷新无法显示下载按钮、链接失效等问题请到 【公告留言】 处理或参考下载说明文档。

THE END