Umami Docker 部署#

项目介绍#

Umami 是一款开源的网站分析工具，以简洁、轻量且注重隐私保护而著称。与 Google Analytics 等传统分析服务不同，Umami 不会追踪用户的个人信息，所有数据均存储在您自己的服务器上，全程可控可管。

主要特点#

📊 界面简洁直观，数据一目了然
🔒 全面保护用户隐私，无追踪
🚀 轻量级架构，加载迅速
📱 响应式设计，移动端友好
🗄️ 数据自主掌控，存储在自己的服务器上
🐳 支持 Docker 一键部署

部署前准备#

环境要求#

Docker 和 Docker Compose
至少 512MB 内存
至少 1GB 存储空间

部署步骤#

方法一：使用 Docker Compose（推荐）#

1
mkdir -p umami && cd umami

创建 docker-compose.yml 文件

1
services:
2
  umami:
3
    image: ghcr.docker.mikus.ink/umami-software/umami:latest  # 使用指定镜像源的Umami最新版
4
    container_name: umami  # 容器名称
5
    ports:
6
      - 3000:3000  # 端口映射：主机3000端口 → 容器3000端口
7
    networks:
8
      - umami-network  # 连接到自定义网络
9
    environment:
10
      FAVICON_URL: https://easyimage.mikus.ink/app/thumb.php?img=/i/u/2025/05/24/w1yxsy.svg  # 网站图标URL
11
      DATABASE_URL: postgresql://umami:umami@umami-db:5432/umami  # 数据库连接字符串（用户名:密码@主机:端口/数据库名）
12
      APP_SECRET: replace-me-with-a-random-string  # 应用密钥
13
    depends_on:
14
      db:
15
        condition: service_healthy  # 等待数据库健康检查通过后再启动
16
    init: true  # 使用init进程处理信号和僵尸进程
17
    restart: always  # 总是重启（除非手动停止）
18
    healthcheck:
19
      test:
20
        - CMD-SHELL
21
        - curl http://localhost:3000/api/heartbeat  # 健康检查：访问心跳接口
22
      interval: 5s  # 每5秒检查一次
23
      timeout: 5s   # 超时时间5秒
24
      retries: 5    # 重试5次后标记为不健康
25

26
  db:
27
    image: postgres:15-alpine  # 使用PostgreSQL 15 Alpine轻量版
28
    container_name: umami-db  # 数据库容器名称
29
    networks:
30
      - umami-network  # 连接到同一网络
31
    environment:
32
      POSTGRES_DB: umami      # 数据库名称
33
      POSTGRES_USER: umami    # 数据库用户
34
      POSTGRES_PASSWORD: umami  # 数据库密码（生产环境建议修改）
35
    volumes:
36
      - ./data:/var/lib/postgresql/data  # 数据持久化：主机./data目录 → 容器数据目录
37
    restart: always  # 总是重启
38
    healthcheck:
39
      test:
40
        - CMD-SHELL
41
        - pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}  # PostgreSQL健康检查
42
      interval: 5s
43
      timeout: 5s
44
      retries: 5
45

46
networks:
47
  umami-network:
48
    driver: bridge  # 使用桥接网络模式，允许容器间通信

启动服务

1
docker-compose up -d

验证部署

打开浏览器访问 http://your-server-ip:3000，使用默认账号登录：

用户名：admin
密码：umami

⚠️ 登录后请务必第一时间修改默认密码。

安全配置#

部署完成后，请务必进行以下安全加固：

修改默认密码 — 登录后立即在设置页面更新密码
启用 HTTPS — 推荐使用 Nginx 或 Caddy 配置反向代理和 SSL 证书，确保数据传输加密

使用方法#

添加网站#

登录 Umami 仪表板
点击左侧菜单的 “Websites”
点击 “Add website” 按钮
填写网站名称和域名
点击 “Save” 保存

安装跟踪代码#

添加网站后，系统会生成一段专属的跟踪代码。将其嵌入到您网站的 <head> 或 <body> 标签中即可开始收集数据：

1
<script async src="https://analytics.yourdomain.com/script.js" data-website-id="your-website-id"></script>

查看统计数据#

部署并接入跟踪代码后，您可以在仪表板中查看以下维度的数据：

实时访问：掌握网站的实时在线人数和访问动态
页面浏览：浏览各页面的访问量与热门排行
来源分析：追溯访客来自哪些渠道（搜索引擎、社交平台、直接访问等）
设备分析：了解访客所使用的设备类型、操作系统和浏览器
地理位置：查看访客所在的国家和地区分布

升级 Umami#

当有新版本发布时，您可以通过以下步骤升级：

1
# 停止并删除旧容器
2
docker-compose down
3

4
# 拉取新版本
5
docker-compose pull
6

7
# 重新启动
8
docker-compose up -d

总结#

Umami 是一款出色的开源网站分析工具，通过 Docker 部署即可快速搭建属于自己的隐私友好型分析平台。它在保护用户隐私的同时提供了丰富且直观的统计功能，是 Google Analytics 的理想替代方案。

Mikus Blog