Docker教程：使用Docker部署Umami统计程序【源码教程】

Umami 是一个开源的轻量化网站统计程序。

• Umami 等自建统计程序不会像 Google Analytics 一样被很多浏览器插件拦截，数据相对更加准确。
• 在类似的自建统计程序中，Umami 在速度和配置要求上有非常明显的优势，在积累大量数据后依旧能保持快速的响应。

部署程序

安装 Docker

较新版本中 Docker Com­pose 已以插件的形式集成在 Docker 中，无需额外安装

以 Ubuntu 为例，其他操作系统可参考 Docker 官方文档

请注意，第二条命令会将主机上的旧版 Docker 卸载。

sudo apt update
sudo apt remove docker docker-engine docker.io containerd runc
# 国内机器可将 download.docker.com 替换为 mirrors.aliyun.com/docker-ce
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

2022/05/17 更新
据反馈阿里云的机器可能会找不到 add-apt-repository 命令，执行 sudo apt install software-properties-common 安装即可。

使用 Compose 部署程序

2024/​01/​16 更新
Umami 运行最低需要 MySQL v5.7 或 Post­greSQL v12.14
用 MySQL 的话个人建议最好是 8.0，觉得内存占用大可以考虑 Mari­aDB，之前就出现过数据库迁移脚本用了 MySQL8.0 才兼容的语法导致一堆用 5.7 的升级失败了，过了几个月才修复。

创建 docker-compose.yml 文件，以下均以 MySQL 数据库为例

选项一：使用宿主机数据库

version: '3'
services:
  umami:
    image: ghcr.io/umami-software/umami:mysql-latest
    restart: always
    network_mode: "host"
    environment:
      DATABASE_TYPE: mysql
      DATABASE_URL: mysql://username:password@localhost:3306/databasename
      APP_SECRET: replace-me-with-a-random-string
    container_name: umami

选项二：使用 Docker 部署数据库

version: '3'
services:
  umami:
    image: ghcr.io/umami-software/umami:mysql-latest
    restart: always
    depends_on:
      - umami-db
    ports:
      - 3000:3000
    environment:
      DATABASE_TYPE: mysql
      DATABASE_URL: mysql://umami:password@umami-db:3306/umami
      APP_SECRET: replace-me-with-a-random-string
    container_name: umami
  umami-db:
    image: mysql:5.7
    restart: always
    volumes:
      - ./data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: password
      MYSQL_DATABASE: umami
      MYSQL_USER: umami
      MYSQL_PASSWORD: password
    container_name: umami-db

---

如需使用 Post­greSQL ，将 image 替换为 ghcr.io/umami-software/umami:postgresql-latest，将 DATABASE_URL 替换为 postgresql://username:password@db:5432/databasename ，DATABASE_TYPE 替换为 postgresql 即可。

将 DATABASE_URL 内的 username 等替换为对应的数据库配置，将 APP_SECRET 后的内容替换为随机字符串。

因为 Umami 分发镜像使用的是 Github 的 Pack­age 功能，国内机器拉取镜像的速度大概率十分感人，如有需要可尝试我在腾讯云的镜像
ccr.ccs.tencentyun.com/orilight/umami-mysql:latest
可将 lat­est 换为 1.38.0 等版本号 (不需要带 v) 拉取指定版本的镜像
 

配置完成后保存关闭文件在终端执行 docker compose up -d 即可

Umami 默认运行在 主机ip:3000 上，如无法访问建议检查 Umami 的运行状态与主机的防火墙和安全组等设置，默认账号：admin，默认密码：umami

后续更新

当 umami 更新后，运行下列命令即可更新 umami。

注意是在保存 docker-compose.yml 文件的目录下执行命令。

docker compose pull
docker compose up -d --remove-orphans