Umami Docker 部署及优化

1041 字

5 分钟

Umami Docker 部署及优化

2025-12-17

未分类

Umami

0

Umami 是一个开源的 Self-hosted 的轻量网站统计分析工具。可替代 Google Analytics、百度统计这些工具。适合个人博客、小型网站使用。

优化部分在文末。

安装#

推荐使用 Docker 安装。

在域名目录下新建 docker-compose.yml文件：

1
vim docker-compose.yml

注意：中国大陆的服务器可能打不开官方示例中的 ghcr.io 域名，这里改为了docker.umami.dev

1
---
2
version: '3'
3
services:
4
  umami:
5
    image: docker.umami.dev/umami-software/umami:postgresql-latest
6
    ports:
7
      - "3000:3000"
8
    environment:
9
      DATABASE_URL: postgresql://umami:umami@db:5432/umami
10
      DATABASE_TYPE: postgresql
11
      APP_SECRET: replace-me-with-a-random-string
12
      TRACKER_SCRIPT_NAME: random-string.js
13
    depends_on:
14
      - db
15
    restart: always
16
  db:
17
    image: postgres:15-alpine
18
    environment:
19
      POSTGRES_DB: umami
20
      POSTGRES_USER: umami
21
      POSTGRES_PASSWORD: umami
22
    volumes:
23
      - ./sql/schema.postgresql.sql:/docker-entrypoint-initdb.d/schema.postgresql.sql:ro
24
      - umami-db-data:/var/lib/postgresql/data
25
    restart: always
26
volumes:
27
  umami-db-data:

基本上不用修改什么，只需要注意端口是否占用。如果端口被占用，把ports中冒号前的3000改为其他的。

启用 Docker 容器：

1
docker compose up -d

此时，打开 http://server_ip:3000即可登录 Umami 开始使用了。

默认账号：admin
默认密码：umami

Nginx 反代#

如果不想直接使用服务器的 IP 登录和暴露端口，可以利用 Nginx 反代。假设使用 tongji.notumami.com 这个二级域名来当作 Umami 的域名。

反代配置：

1
server
2
{
3
    listen 80;
4
  listen 443 ssl http2;
5
    server_name umami.xxx.com;
6
    root /www/wwwroot/umami.xxx.com;
7
    if ($server_port !~ 443){
8
        rewrite ^(/.*)$ https://$host$1 permanent;
9
    }
10

11
    ####################
12
    # 其他配置
13
    ####################
14

15
    # 反代配置
16
    location ^~ /   {
17
    proxy_pass http://127.0.0.1:3000;
18
    proxy_set_header Host $host;
19
    proxy_set_header X-Real-IP $remote_addr;
20
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
21
    proxy_set_header X-Forwarded-Proto $scheme;
22
    proxy_set_header REMOTE-HOST $remote_addr;
23
    add_header X-Cache $upstream_cache_status;
24
    # 缓存
25
    add_header Cache-Control no-cache;
26
    expires 12h;
27
  }
28
}

宝塔面板反代设置：

配置 Nginx 反代后，就可以通过域名登录 Umami 了。如：https://umami.xxx.com

添加被统计网站#

通过域名 https://umami.xxx.com 登录 Umami 后台。在设置中添加需要被统计的网站，先点🌐地球图标，切换为中文。再点设置，添加网站`：

获取跟踪代码#

在刚才添加的网站上点击编辑，跟踪代码，就能获取到跟踪代码了：

1
<script
2
    async
3
    src="https://umami.xxx.com/random-string.js"
4
    data-website-id="xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx">
5
</script>

安装跟踪代码#

到需要被统计的网站上，找一个合适的位置，粘贴上面获取到的跟踪代码即可使用。

一些静态博客 Hexo、Hugo 的主题已经支持 Umami 了，只需要在主题的 config 中配置即可。

1
### 优化
2

3
#### 1. 优化一：广告插件反屏蔽
4

5
Umami 的默认跟踪代码是被大多数的广告插件屏蔽的，被屏蔽了你就统计不到访客信息了。如果需要反屏蔽，需要在 `docker-compose.yml` 文件中添加环境变量：`TRACKER_SCRIPT_NAME`，如：
6

7
```yml
8
    environment:
9
      TRACKER_SCRIPT_NAME: random-string.js

然后获取到的跟踪代码的 src 会变成：

~~srcipt.js~~ => random-string.js

1
https://umami.xxx.com/script.js
2
https://umami.xxx.com/random-string.js

官方文档提供了更多的环境变量配置

2. 优化二：跟踪代码部署到自己的 CDN#

如果自己的 VPS 是小水管，会因为跟踪代码的延迟加载影响到网站的加载速度，为了更好的用户体验可以把跟踪代码random-string.js下载下来，放到自己或者朋友的 CDN 上。比如放到腾讯云的 COS 里。
此时 src 就变成了：https://cdn.notumami.com/random-string.js，只放了跟踪代码的链接还没有成功，还需要配置收集数据的服务器。
所以需要添加 data_host_url，它的值为 Umami 实际的网址 https://tongji.notumami.com，完整配置如下：

1
<script
2
    async
3
    defer
4
    data-website-id="cbd4a55a-81e8-42ed-5d04-a0e2315433f0"
5
    src="https://cdn.notumami.com/random-string.js"
6
    data-host-url="https://tongji.notumami.com"
7
    data-domains="eallion.com">
8
</script>

data-domains 的意思是只在特定的网站上运行跟踪代码。比如在本地用 hugo server 测试 Hugo 博客时就不会统计 127.0.0.1:1313 的访问了。
官方文档中有更多的可配置参数： https://umami.is/docs/tracker-configuration

3. 优化三：如何集成到 API#

有人问到如何把 Umami 集成到 API 里。如：

https://api.eallion.com/umami/69d6ffe.js?v=2.0.1

这其实不算优化，只是我个人的洁癖，网络请求里会减少一个 Domain host。也间接达到了隐藏真实 Umami 域名的效果。
简单说下思路。我的 API 暂时用的是腾讯云的全站加速（其他云服务商的都可以）。配置全站加速 CDN 的源站里，用二级目录 /umami 反代 Umami 的 3000 端口。

CDN 源站的 Nginx 反代配置：

1
location ^~ /umami
2
{
3
    # ......
4

5
    proxy_pass http://127.0.0.1:3000/;
6

7
    # ......
8
}

而 69d6ffe.js 是用 API 域名的 /umami/69d6ffe.js 做了 301 重定向转发。

CDN 源站的 Nginx 重定向配置：

1
rewrite ^/umami/69d6ffe.js(.*) https://a.eallion.com/69d6ffe.js permanent;

其他#

如果切换到中文，发现无法删除网站。需要输入 DELETE。

Umami Docker 部署及优化

https://www.lin4.cn/posts/umami-docker-部署及优化/

作者

Jinnnl

发布于

2025-12-17

许可协议

CC BY-NC-SA 4.0

聊天导航

Docker-Compose 安装

2. 优化二：跟踪代码部署到自己的 CDN

3. 优化三：如何集成到 API

6

其他