一、系统简介
Umami 是一款开源、轻量、隐私优先的自建网站访问统计工具，核心对标谷歌分析（GA4），专为注重用户隐私、数据自主可控的站长、个人博主、中小企业打造。
Umami 最大核心优势为无 Cookie 追踪、不收集用户个人隐私信息，完全符合 GDPR、CCPA 等全球隐私法规，可规避网站 Cookie 弹窗合规问题。所有统计数据全部自建存储在个人服务器，不上传任何第三方平台，数据安全性和自主权极高。
项目官方地址：https://github.com/umami-software/umami
核心技术栈：Next.js + Prisma + PostgreSQL
二、核心功能介绍
1. 基础流量统计
支持全方位网站基础数据统计，包含总访问量、独立访客数、页面浏览量、实时在线访客、单页访问时长、网站跳出率等核心指标，数据实时更新，可视化展示清晰直观。
2. 访客来源分析
精准识别访客访问渠道，涵盖直接访问、搜索引擎、外部跳转网站、社交媒体等来源，同时支持识别 UTM 推广参数，可精准统计各推广渠道的引流效果，适配网站运营推广需求。
3. 访客设备与地域分析
自动统计访客设备信息，包含设备类型（手机/电脑/平板）、浏览器型号、操作系统版本；同时支持按国家、地区维度展示访客分布，助力精准定位用户群体。
4. 自定义事件追踪
支持自定义网站交互事件统计，可针对按钮点击、表单提交、弹窗触发、下载操作等行为配置追踪代码，无需复杂开发，快速实现网站转化行为数据统计。
5. 多站点统一管理
单套系统支持添加多个网站，各站点数据独立统计、互不干扰，可统一在后台切换查看，适配多站点站长、企业多官网管理场景，同时支持多账号权限分配。
6. 可视化数据仪表盘
内置可视化图表面板，支持自定义时间筛选（今日、昨日、近7天、近30天、自定义时间段），所有统计数据支持导出，方便数据留存、复盘与汇报。
7. 数据分享功能
支持生成只读分享链接，可将网站统计面板分享给客户、团队成员，无需提供后台账号密码，兼顾数据展示与账号安全。
8. 极简追踪脚本
官方追踪脚本体积仅数KB，加载速度极快，几乎不会影响网站打开速度。全程无 Cookie、不采集用户隐私信息，合规性拉满。
三、软件优缺点汇总
（一）核心优点
• 隐私合规友好：全程不设置 Cookie、不收集用户个人隐私数据，无需网站弹窗 Cookie 授权，完美适配国内外隐私合规政策。
• 数据完全自主可控：纯自托管部署，所有流量数据存储在个人服务器，无第三方调取、无数据泄露风险，无平台封号、数据丢失问题。
• 轻量高效无负担：追踪脚本体积极小，对网站加载速度几乎无影响，兼容所有主流网站程序与服务器环境。
• 完全开源免费：核心功能永久开源免费，无访客流量限额、无站点数量限制，区别于 Plausible 等同类工具的付费限流机制。
• 部署简单高效：支持 Docker 一键部署，无需复杂编译配置，新手也可在5分钟内完成搭建上线。
• 界面简洁轻量化：摒弃 GA4 冗余复杂的功能模块，聚焦站长核心统计需求，操作简单、上手零门槛。
（二）现存缺点
• 高级功能缺失：对比 GA4，无用户行为轨迹、复杂漏斗分析、广告深度归因、用户分层等企业级高级分析功能。
• 需自主运维：自托管模式需要用户自行负责服务器维护、数据库备份、版本更新，具备基础运维成本。
• 数据库单一依赖：仅支持 PostgreSQL 数据库，不兼容 MySQL，对习惯使用 MySQL 的用户存在适配门槛。
• 海外部署存在兼容问题：服务器部署在海外时，国内访客可能出现脚本加载延迟、少量数据丢失情况，国内服务器部署可规避该问题。
• 无原生告警功能：不支持异常流量、恶意访问、流量暴跌等场景的邮件/消息告警，需二次开发实现。
• 无法自动过滤爬虫流量：默认不识别机器人、爬虫访问，需手动开启过滤规则或通过 Nginx 辅助屏蔽。
四、保姆级Docker部署教程
1. 部署前置条件
• 一台云服务器（Ubuntu、Debian、CentOS 均可）
• 服务器已开放 3000 端口防火墙/安全组
• 提前安装 Docker、Docker Compose 环境
• 可选：已备案域名（用于配置 HTTPS 正式访问）
2. 安装Docker环境
适配 Ubuntu/Debian 系统，终端执行以下命令：
| bash apt update apt install docker.io docker-compose -y systemctl start docker systemctl enable docker |
3. 创建部署目录与配置文件
新建 Umami 专属目录，编写 docker-compose 部署配置文件：
| bash mkdir umami && cd umami nano docker-compose.yml |
粘贴以下完整配置内容，务必修改自定义密钥：
| yaml version: '3.8' services: umami: image: ghcr.io/umami-software/umami:postgresql-latest ports: - "3000:3000" environment: DATABASE_URL: postgresql://umami:umami@db:5432/umami DATABASE_TYPE: postgresql APP_SECRET: 自定义随机密钥（16位以上随机字符串） depends_on: - db restart: always db: image: postgres:15-alpine environment: POSTGRES_USER: umami POSTGRES_PASSWORD: umami POSTGRES_DB: umami volumes: - ./postgres-data:/var/lib/postgresql/data restart: always |
密钥生成命令：终端执行 openssl rand -hex 16，复制生成的字符串替换配置中的密钥
保存退出：Ctrl+O 回车保存，Ctrl+X 退出编辑
4. 启动服务
执行部署命令，后台启动服务：
| bash docker-compose up -d |
等待镜像拉取、数据库自动初始化完成，访问地址：http://服务器IP:3000
5. 后台登录与安全设置
默认登录账号密码：
用户名：admin
密码：umami
重要提醒：首次登录务必进入「设置-个人资料」修改默认密码，防止账号被盗。
6. 添加站点与配置统计脚本
1. 后台左侧选择「设置-网站」，点击添加网站；
2. 填写网站名称、官网地址，可开启「排除机器人流量」选项；
3. 创建站点后，系统自动生成专属统计脚本；
4. 将脚本粘贴至网站 </head> 标签前，部署生效后即可正常统计数据。
示例统计脚本：
| html <script defer src="https://你的域名/script.js" data-website-id="专属站点ID"></script> |
7. 数据备份（必备操作）
为防止服务器故障丢失数据，建议定期备份数据库，终端执行备份命令：
| bash docker exec umami_db_1 pg_dump -U umami umami > umami-backup-$(date +%Y%m%d).sql |
五、基础使用教程
1. 多站点管理
进入「设置-网站」，可无限新增站点，各站点独立统计、数据隔离，适配多网站运营场景。
2. 数据仪表盘查看
后台首页为核心仪表盘，支持切换时间维度，可查看实时在线访客、页面访问排行、访客来源、设备信息、地域分布等所有核心数据。
3. 自定义事件追踪配置
可自定义网站交互事件统计，示例按钮点击统计代码：
| html <button onclick="umami.track('自定义事件名称')">点击测试</button> |
配置完成后，可在后台「事件」板块查看所有触发记录与统计数据。
4. 只读数据分享
进入对应网站详情页，开启「共享」功能，生成公开只读链接，可对外展示统计数据，无需泄露后台账号。
5. 过滤内部访问数据
编辑网站配置，添加服务器本地IP、运维IP，可过滤自身访问流量，保证统计数据精准度。
六、常见问题排查
1. 脚本不统计数据
• 核查站点 website-id 是否填写正确；
• 查看网站源码是否正常加载脚本，浏览器控制台无报错；
• 排查 CDN 缓存、跨域问题导致脚本加载失败；
• 用户浏览器广告拦截插件会拦截统计脚本，属于正常现象。
2. 系统版本升级
升级前务必备份数据库，执行更新命令即可自动完成版本迭代与数据库迁移：
| bash docker-compose pull && docker-compose up -d |
3. 无法访问后台
检查服务器防火墙、云平台安全组是否放行 3000 端口，端口未开放会导致外部无法访问。
4. 垃圾爬虫流量过多
开启网站自带机器人过滤功能，或通过 Nginx 配置规则屏蔽恶意爬虫 UA，减少无效数据。
七、适用场景总结
✅ 适配场景
个人博客、自媒体站点、企业官网、中小型流量网站，注重隐私合规、想要数据自主、不想使用第三方统计工具的用户。
❌ 不适配场景大型电商平台、百万级高流量站点、需要广告归因、用户漏斗分析、高级数据建模的企业级业务场景。