⏰ 发布时间：2026年6月24日
⭐ 版本：v3.2.0
🆓 费用：开源免费
Umami 这次搞了个大的——热力图（Heatmaps）正式上线。以前想看用户在页面上点了哪、滚了多深，得额外接 Hotjar 之类的工具。现在 Umami 自带了，还是基于 Session Replay 快照渲染的，数据精度比传统热力图高不少。再加上属性报告、收入报表等一系列升级，这次更新诚意满满 👇
📦 v3.2.0 - 2026年6月24日
🔥 这次更新了什么？
1. 热力图功能上线 🔥
这是 v3.2 最核心的新功能。点击热力图和滚动热力图，直接在 Umami 后台就能看。渲染方式很特别——基于 Session Replay 的快照数据，用 iframe 预览叠加显示。支持按页面路径筛选、按屏幕宽度分组（响应式布局适配），还有深度标签和缩放控制。自托管用户也能用，录制和存储都支持。
2. Session Replay 大升级 ▶️
回放功能做了一轮可靠性优化。新增筛选器帮你快速定位目标会话，碎片化回放事件做了标准化处理，超大回放载荷会被拒绝（防止内存爆掉）。移动端的布局和弹窗样式也优化了。另外，页面关闭时回放事件会立即 flush，数据丢失更少。
3. 事件/会话属性报告 📊
属性报告现在支持更多数据类型了——布尔值、日期、数组、数值，全都能出图表。新增了「会话数据」页面，有筛选器、透视表和属性图表。事件数据和会话数据的筛选 UI 也统一了，体验一致多了。
4. 收入报表拆分优化 💰
收入报表拆成了独立的 API 和视图——图表、指标、统计、会话各自分开。新增累积模式（Cumulative），可以看收入的累积趋势。实时报表的 UI 也做了优化。
5. 表格组件改进 📋
DataGrid 支持手动切换表格/卡片视图了。非分析类表格（网站列表、看板、链接等）支持排序。溢出内容支持横向滚动。事件图表的颜色在日期范围变化时保持稳定，不会跳来跳去了。
6. 追踪器和 API 改进 🔧
新增 data-auto-pageview 属性，SPA 应用可以关闭自动页面浏览追踪。追踪器现在能处理带注解的容器的点击事件。pushState 的无效 URL 也不会再报错了。URL 查询参数现在会显示在页面报告里。
7. 分享功能增强 🔗
分享页面支持筛选和主题强制了。分享 token 的权限更细粒度——可以按网站、看板、链接、像素分别授权。没有 section 标志的分享 token 现在可以无限制访问。
8. 安全加固 🔒
这次安全修复很多：改密码后自动失效旧会话、日志脱敏、隐藏 Prisma/数据库错误、SSO 重定向 URL 校验、CSV 导出防CSV公式攻击、批量 API 限制 500 条、Redis key 登出时认证……基本上该加固的都加固了。
✅ 适合哪些人？
✅ 产品/运营团队：热力图 + Session Replay，用户行为分析终于不用再接第三方了
✅ 自托管用户：热力图录制和存储完全自托管，数据不出服务器
✅ 电商/SaaS 团队：收入报表的累积模式和会话级分析很有用
✅ 隐私合规要求高的团队：安全加固做得扎实，CSV 防安全问题、会话失效等都补上了
⚠️ 只看 PV/UV 的用户：如果你只关心基础流量数据，这些新功能用不太上
🛠️ 快速上手
Docker Compose 升级：
# 拉取最新镜像
docker compose pull
# 重启（数据库迁移自动执行）
docker compose up -d开启热力图录制：
热力图基于 Session Replay 数据，所以需要先开启回放功能。在追踪脚本里加上：
<script
defer
src="https://your-umami-instance/script.js"
data-website-id="your-website-id"
data-auto-pageview="true"
></script>然后在 Umami 后台的网站报告里就能看到「热力图」入口了。
数据库迁移：
这次迁移（20_add_heatmap）在构建过程中自动执行，不需要手动跑。
❓ 常见问题
Q：热力图需要额外配置吗？
A：需要开启 Session Replay。热力图是基于回放快照渲染的，没开回放就没有热力图数据。
Q：热力图会影响页面性能吗？
A：录制端的性能开销和 Session Replay 一样，不会额外增加。渲染端用 iframe 隔离，不影响主页面。
Q：回放载荷被拒绝是什么意思？
A：超大的回放数据（比如长时间录制的复杂页面）会被拒绝上传，防止服务端内存溢出。建议控制单次录制时长。
Q：改密码后旧会话会立刻失效吗？
A：是的，v3.2 改密码后所有已认证会话立即失效，需要重新登录。这是个安全增强。
🙌 写在最后
Umami v3.2 最大的亮点就是热力图。之前想做用户行为分析，要么接 Hotjar/Clarity 这类第三方工具（数据出去了），要么自己写埋点（太累了）。现在 Umami 一站式搞定，而且数据完全自托管。对于注重隐私的团队来说，这可能是选 Umami 的决定性因素。
Session Replay + 热力图 + 属性报告 + 收入报表，Umami 正在从「轻量统计工具」往「全功能分析平台」进化。值得关注。
🔗 GitHub Release ｜ 官方文档
#Umami #网站分析 #热力图 #SessionReplay #自托管 #隐私优先