1
version: "3.9"
2

3
services:
4
  db:
5
    image: m.daocloud.io/docker.io/library/postgres:15
6
    container_name: umami-db
7
    restart: unless-stopped
8
    environment:
9
      # 数据库名/用户/密码：你可以改，但要和下面 Umami 的 DATABASE_URL 对应
10
      POSTGRES_DB: umami
11
      POSTGRES_USER: umami
12
      POSTGRES_PASSWORD: "CHANGE_ME_STRONG_PASSWORD"
13
    volumes:
14
      # 关键：持久化数据库数据，否则容器删除/重建会丢数据
15
      - ./postgres:/var/lib/postgresql/data
16
    healthcheck:
17
      # 让 Umami 等数据库健康后再启动（减少首次启动时的报错概率）
18
      test: ["CMD-SHELL", "pg_isready -U umami -d umami"]
19
      interval: 10s
20
      timeout: 5s
21
      retries: 5
22

23
  umami:
24
    # 官方文档示例给出了预构建镜像拉取方式（含 postgresql 支持）:contentReference[oaicite:1]{index=1}
25
    # 你可以用官方推荐的 registry 域名：
26
    image: docker.umami.is/umami-software/umami:postgresql-latest
27
    # 也可以用 Docker Hub 的镜像标签（如果你拉取更顺手）:contentReference[oaicite:2]{index=2}
28
    # image: umamisoftware/umami:postgresql-latest
29

30
    container_name: umami
31
    restart: unless-stopped
32
    depends_on:
33
      db:
34
        condition: service_healthy
35

36
    environment:
37
      # 关键：连接的是 compose 网络内的 db 服务（host 写 db，不是 127.0.0.1）
38
      DATABASE_URL: "postgresql://umami:CHANGE_ME_STRONG_PASSWORD@db:5432/umami"
39

40
      # 关键：用于加密会话/令牌。必须随机且足够长。:contentReference[oaicite:3]{index=3}
41
      APP_SECRET: "CHANGE_ME_RANDOM_SECRET"
42

43
      # 建议填写你对外访问的完整 URL（含 https）
44
      APP_URL: "https://analytics.example.com"
45

46
    ports:
47
      # 关键：只绑定到 127.0.0.1，避免 Umami 端口直接暴露公网
48
      # 外部访问统一走 Nginx 反向代理 + HTTPS
49
      - "127.0.0.1:3000:3000"

1
server {
2
    # 80 强制跳转到 443
3
    listen 80;
4
    server_name analytics.example.com;
5
    return 301 https://$host$request_uri;
6
}
7
server {
8
    listen 443 ssl http2;
9
    server_name analytics.example.com;
10

11
    # ssl证书
12
    ssl_certificate     /etc/nginx/ssl/analytics.example.com/fullchain.pem;
13
    ssl_certificate_key /etc/nginx/ssl/analytics.example.com/privkey.pem;
14

15
    # 反代到本机 Umami（只在 127.0.0.1:3000 监听）
16
    location / {
17
        proxy_pass http://127.0.0.1:3000;
18

19
        # 这些 header 很关键：让 Umami 识别真实域名、访客 IP、协议
20
        proxy_set_header Host $host;
21
        proxy_set_header X-Real-IP $remote_addr;
22
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
23
        proxy_set_header X-Forwarded-Proto $scheme;
24

25
        # 可选：减少一些代理相关的小问题
26
        proxy_http_version 1.1;
27
        proxy_buffering off;
28
    }
29
}