使用 Docker 部署 Umami 网站访问统计系统

关于 Umami

Umami 是一个简单、快速、注重隐私且开源网站访问统计系统，可以作为 Google Analytics 的替代品，Umami 不使用 Cookie，不跟踪用户。

Umami 支持自己部署，功能不受限制，如果自己没有服务器，也可以直接在官网注册使用。

Umami 的界面非常简洁、直观，功能一目了然，这也是我使用 Umami 的原因，Google Analytics 太强大，界面也很复杂，有时找个功能要找半天。

Umami 支持下面的功能

• 统计浏览量、访问次数、访客数量、跳出率、平均访问时长
• 按时间段生成柱状图
• 查看每个 URL 对应的浏览量
• 查看来源域名
• 查看访客的浏览器、操作系统、设备类型、分辨率、地理位置
• 支持生成各种报告

在开始使用之前，可以查看官方提供的 DEMO 体验后台与统计效果

使用 Docker Compose 部署

使用 docker compose 可以直接一键部署，首先创建 docker-compose.yml，填入下面的内容

使用的是官方提供的自带 postgresql 数据库版本的镜像

然后运行下面的命令即可自动拉取镜像启动

docker compose up -d

启动后，访问 http://<你的服务器 IP>:3000 进入后台，默认用户名是 admin 密码 umami ，可以在右上角 切换界面语言。

设置 Nginx 反代

Nginx 配置文件中的反代部分如下

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    proxy_http_version 1.1;
    proxy_read_timeout 60s;
}

然后为了安全，我们可以将 docker-compose.yaml 文件中的端口设置仅限本地 Nginx 访问，将下面部分

ports:
  - "3000:3000"

修改为

ports:
  - "127.0.0.1:3000:3000"

添加站点

点击 设置 > 添加网站 进行添加：

• 名字：显示在 Umami 后台，用于辨识
• 域名：填入实际访问域名，例如 example.com，不需要加 https://

然后点击对应网站的 编辑，在 跟踪代码 部分即可查看需要使用的代码，将对应的代码附加到需要追踪的网页中即可。

<script defer src="https://example.com/script.js" data-website-id="xxxx-xxxx-xxxx-xxxx"></script>

我使用的 Hexo Theme NEXT 主题，可以直接在主题设置中填写 域名 与 data-website-id 让追踪生效。

资源占用

使用 docker stats 查看资源占用情况如下

CONTAINER ID   NAME               CPU %     MEM USAGE / LIMIT     MEM %     NET I/O           BLOCK I/O         PIDS 
df307a49da94   umami-umami-1      0.01%     238.8MiB / 1.933GiB   12.06%    16.8MB / 655kB    48MB / 73.8MB     48 
e7c0ca63f761   umami-db-1         0.02%     38.71MiB / 1.933GiB   1.96%     189kB / 162kB     8.56MB / 1.26MB   10 

更新

docker compose pull