Umami 是 GitHub 高星开源网站统计工具，支持自托管、Docker 一键部署，适合个人建站、免备案服务器使用，本文含部署教程、问题排查与踩坑记录。
通过网盘分享的文件：编号226umami-master.zip 内含视频部署教程
链接: https://pan.baidu.com/s/1ED5ChsPFvS2rAZsh-pGQdw?pwd=chgx 提取码: chgx
–来自百度网盘超级会员v4的分享
| 项目 | 内容 |
|——|——|
| **仓库地址** | https://github.com/umami-software/umami |
| **Star 数量** | 35.8K（随时会变动） |
| **协议** | MIT |
| **官方文档** | https://umami.is/docs/ |
适合场景
不想把访问数据交给第三方 SaaS，希望 **数据在自己服务器** 上。
需要 基础统计（浏览量、访客、来源、实时在线等），不要求复杂广告归因。
有 Docker 或能跑 Node + PostgreSQL，愿意自己维护一套小服务。
不适合：强依赖 Google 广告生态深度报表、或需要热力图级行为分析时，需另配工具。
深受第三方统计工具深夜劫持的个人站点。
使用体验
上手：官方 Compose 流程短，拉镜像起容器后浏览器访问端口即可进后台；对熟悉 Docker 的人几乎零文档也能跑起来。
日常维护：升级主要是 `pull` + 重建容器；数据在 Postgres 卷里，注意备份 volume。后台 UI 清晰，添加网站、看报表、分享链接路径直观。
踩坑记录
有界面但没数据（视频教程内已补充）
现象：后台全是 0。
原因：Umami 不会自动统计未配置站点，需在「网站 → 设置」复制跟踪代码并放到目标页 `<head>`。
解决办法：按后台生成的 `script` 标签部署到实际站点后再访问页面产生数据。
国内访问统计域名
现象：若统计脚本部署在海外、站点用户在国内，偶发加载慢或被拦截（视网络环境）。
解决办法：统计服务与主站尽量同区域或做好 CDN/反代；具体问题需按实际线路排查。
部署命令（Docker）
docker启动指令
docker compose up -d
升级：
docker compose pull
docker compose up --force-recreate -d需要修改的配置
编辑仓库根目录 docker-compose.yml，至少改APP_SECRET 和数据库密码；DATABASE_URL 与 POSTGRES_保持一致。
DATABASE_URL: postgresql://umami:强密码@db:5432/umami
POSTGRES_PASSWORD: 强密码默认账号 / 密钥
后台用户名：admin
后台密码：umami（首次登录后请在设置中修改）
项目截图
