Umami V3.0.2 是开源网站统计程序,舍弃 MySQL 全面支持 PostgreSQL,新增链接监控与像素追踪,优化界面交互,强化隐私合规。支持多种部署,轻量设计,升级路径清晰,适合对数据合规有要求且追求轻量统计的站长。
开源 Umami V3.0.2 网站统计源码介绍
Umami 是一款可自主部署的网站统计程序,同时用户也能选择使用官方提供的统计代码。其具备基本的统计功能,与国内百度统计相比,缺少搜索关键词展示,但对于轻量级使用场景已足够。若您的服务器无法支撑网站访问量,建议使用官方统计代码,自行部署可能因访问量过大导致统计效果不佳。以下是 Umami V3.0.2 版本核心特性与变更概述:
一、数据库支持调整:全面拥抱 PostgreSQL
MySQL 停止支持
V3.0.2 彻底移除 MySQL 数据库支持,仅保留 PostgreSQL 作为唯一选项。此变更旨在优化数据查询性能,支持更复杂的分析场景。
- 迁移建议:若从 MySQL 升级,需先通过中间版本(如 V2.19.0)将数据迁移至 PostgreSQL,再升级至 V3.0.2。迁移工具已提供,支持自动化处理。
性能优化
PostgreSQL 的引入提升了高并发场景下的稳定性,适合流量较大的网站或应用。
二、功能增强:新增链接监控与像素追踪
链接监控(Links)
- 功能:生成短链接并统计点击次数,适用于营销活动、文件下载等场景。
- 限制:短链接的 Slug(唯一标识符)为随机生成,不支持自定义。
像素追踪(Pixels)
- 功能:通过嵌入不可见图片(1x1 像素)追踪外部页面浏览量,如论坛评论、新闻稿等。
- 扩展场景:支持邮件打开率统计(如嵌入新闻通讯中)。
独立统计页面
链接和像素功能均拥有专属数据看板,可单独分析点击率、地域分布等指标。
三、用户体验改进:界面与交互升级
全新 UI 设计
采用现代化布局,数据展示更直观,支持多网站快速切换(通过顶部导航栏下拉菜单)。报告页面拆分为独立模块,便于按需访问特定指标(如访客来源、设备类型)。
过滤器增强
- 多条件筛选:支持同时应用多个筛选条件(如“国家 = 中国 + 设备 = 移动端”),结果通过 URL 参数共享,团队协作更高效。
- 保存常用筛选:用户可保存常用筛选组合为“细分(Segments)”,例如“美国 Windows 用户”,后续直接调用。
用户分群(Cohorts)
定义用户群体(如“11 月注册用户”),跟踪其长期行为(如留存率、活跃度),辅助精细化运营。
四、技术架构与部署优化
依赖更新
升级 Prisma 至 V6.18.0,优化数据库交互逻辑,减少潜在错误。前端框架(React + Next.js)性能调优,页面加载速度提升。
部署灵活性
支持 Docker、Vercel、Netlify 等多种部署方式,适配不同规模需求。资源占用:轻量级设计,200MB 内存 VPS 即可稳定运行。
五、隐私与合规性强化
数据匿名化
默认不收集 IP 地址,支持 GDPR、CCPA 等隐私法规,适合对数据合规性要求高的场景。
无 Cookie 追踪
完全基于会话(Session)统计,避免 Cookie 拦截对数据准确性的影响。
六、升级建议与注意事项
升级路径
- PostgreSQL 用户:直接升级至 V3.0.2,数据无缝迁移。
- MySQL 用户:需先迁移至 PostgreSQL(通过 V2.19.0 中间版本),再升级至 V3.0.2。
兼容性检查
升级前备份数据库,验证环境变量(如 DATABASE_URL)配置正确。使用 curl http://localhost:3000/api/heartbeat 检查服务健康状态。
功能验证
升级后重点测试核心指标(如总访问量、独立访客数)是否连续,避免数据丢失。





