Umami 网站统计把访问数据握在自己手里
开源、轻量、可自托管的网站分析工具。无 Cookie、脚本约 2KB,提供实时访客、来源分析、事件目标与多站点管理。 本站已完成私有化部署,数据只保存在 123ONE 自己的服务器上。
- 脚本体积
- ≈2KB
- Cookie
- 不使用
- 数据位置
- 自有服务器
- 开源协议
- MIT
看板示意预览 · 实际数据请登录后台查看
三分钟把统计代码装到你的网站
在 Umami 后台「设置 → 网站」里复制 Website ID,选择你的技术栈,粘到页面里即可。同一个 ID 可以同时用于多个域名。
登录后台 → 设置 → 网站 → 添加网站 → 复制 UUID。
把脚本放到 </head> 前,或按框架示例接入。
打开网站,看后台「实时」是否有你的访问记录。
多个域名用英文逗号分隔。限定后,其他域名的访问不会被统计,适合防止测试环境污染数据。
脚本从 123one.online/Umami/script.js 加载,无需自己部署即可使用。
把代码粘到 </head> 之前,defer 保证不阻塞首屏。
<!-- 放在 </head> 之前 -->
<script defer
src="https://123one.online/Umami/script.js"
data-website-id="YOUR_WEBSITE_ID"></script>给元素加 data-umami-event 属性即可,无需写 JS;也可以在关键节点手动上报。
<!-- 任意可点击元素 -->
<button
data-umami-event="download-click"
data-umami-event-file="installer.exe"
>
立即下载
</button>
<!-- 或手动上报事件 -->
<script>
window.umami?.track('signup', { plan: 'pro' })
</script>采集脚本会自动监听 history 变化。若你的路由实现较特殊,可在路由切换后手动补报一次页面浏览。
// React Router:路由变化后补一次页面浏览(通常可省略,脚本会自动监听)
useEffect(() => {
window.umami?.track()
}, [location.pathname])一个安静、够用的统计后台
不追求把每个访客画像到个人,只回答站长最关心的几个问题:谁来了、从哪来、看了什么、做了什么。
实时在线访客
近 30 分钟在线人数、今日趋势与实时事件流,发布内容后立刻能看到谁在访问。
页面 / 来源 / 渠道
落地页、退出页、引荐来源、UTM 参数与搜索引擎关键词,一张看板看清流量结构。
事件与转化目标
给按钮、下载、注册加上 data-umami-event,统计点击量并设置为目标,衡量真实转化。
设备 / 地域 / 环境
浏览器、操作系统、设备类型、国家地区与屏幕尺寸,定位兼容性问题与区域差异。
无 Cookie 追踪
默认不写入 Cookie,不跨站识别个人,减少 Cookie 同意弹窗对体验与转化的干扰。
数据完全自有
PostgreSQL 部署在自己的服务器上,可随时导出、备份、删除,不被第三方平台锁定。
轻量、不拖慢网站
采集脚本约 2KB,defer 异步加载,不阻塞渲染;不影响 Lighthouse 性能评分。
多站点与团队
一个后台管理多个网站,支持成员角色与只读分享链接,给客户看数据不用给账号。
开放 API
提供 REST API 与分享链接,可把统计接入自有后台、报表系统或自动化脚本。
六个核心指标的含义
不同工具对同一指标的定义可能略有差异,这里给出 Umami 的口径与常见解读方式。
| 指标 | 含义 | 怎么用 |
|---|---|---|
| 浏览量 PV | 页面被打开的总次数,同一访客刷新会重复计入。 | 看内容总量与抓取/爬虫波动 |
| 访客数 UV | 按匿名标识去重后的独立访客数量。 | 看真实覆盖人数,不看刷量 |
| 会话 Sessions | 一次访问中连续操作的集合,默认 30 分钟无操作后结束。 | 看访问深度与回访 |
| 跳出率 | 只浏览了一个页面就离开的会话占比。 | 越低说明落地页越能留住人 |
| 平均停留 | 会话从进入到离开的平均时长。 | 结合内容页判断可读性 |
| 事件 Events | 按钮点击、下载、表单提交等自定义行为次数。 | 衡量转化路径的关键动作 |
Umami 与常见统计方案对比
下表为常见版本的概览对比,具体能力与价格以各产品官方说明为准。
| 对比项 | Umami(本站) | Google Analytics 4 | 百度统计 | Plausible |
|---|---|---|---|---|
| 部署方式 | 自托管 Docker | 云端 SaaS | 云端 SaaS | 自托管 / 云 |
| 数据存放 | 自己的服务器 | Google 服务器 | 百度服务器 | 自己或官方 |
| Cookie | 默认不使用 | 使用 | 使用 | 默认不使用 |
| 采集脚本 | 约 2KB | 约 90KB+ | 约 30KB | 约 1KB |
| 费用 | 仅服务器成本 | 免费但受额度/采样限制 | 免费 | 自托管免费 |
| 国内访问 | 自有服务器,稳定 | 脚本常被拦截 | 稳定 | 取决于部署位置 |
| 开源协议 | MIT | 闭源 | 闭源 | AGPL-3.0 |
| 适合场景 | 重视隐私、数据主权 | 深度营销归因 | 国内站长常规统计 | 极简隐私统计 |
注:GA4 与百度统计为云端闭源服务;Plausible 自托管版遵循 AGPL-3.0。Umami 采用 MIT 协议,可自由修改与商用。
部署与使用答疑
相关文档与入口
Docker + PostgreSQL + Nginx 完整步骤、运维与故障排查。
采集哪些字段、不采集什么、如何删除数据与合规建议。
登录 Umami 后台,查看实时访客、来源与事件。
Umami 官方 GitHub,查看源码、版本更新与使用文档。
看板每几秒刷新一次,发布内容后可以立刻观察到实时访客。