umami升级3.0.0以及后续需要做的事

前言

今天群里他们讨论了一下说是umamiV3.0.0已经可以开始升级了，如果使用mysql的话需要数据迁移到postgresql，因为不支持mysql了。

以下是我整理的一些自己操作的记录。

教程

1.之前通过我的教程使用docker-compose.yml部署的，可以直接按照我如下教程进行升级。

Docker 搭建自用网站数据统计工具Umami

2.如果是根据以上教程升级的，可以直接将如下代码替换之前的：

services:
  umami:
    image: ghcr.milu.moe/umami-software/umami:latest  # 新版镜像源
    ports:
      - "3100:3000"  # 保持端口映射（若旧版用3100，可改为"3100:3000"）
    environment:
      DATABASE_URL: postgresql://umami:umami@db:5432/umami  # 与旧版数据库连接信息一致
      DATABASE_TYPE: postgresql
      APP_SECRET: replace-me-with-a-random-string  # 关键！必须替换为旧版的 HASH_SALT 值，否则登录失败
    depends_on:
      db:
        condition: service_healthy
    init: true
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "curl http://localhost:3000/api/heartbeat"]
      interval: 5s
      timeout: 5s
      retries: 5

  db:
    image: postgres:12-alpine 
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: umami
    volumes:
      - ./umami-db-data:/var/lib/postgresql/data
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5

3.终端使用命令docker compose up -d 拉取并创建容器就行了。

4.接下来通过http://ip:3100/ 来访问umami。

5.如果使用了umami的api，因为升级了，所以我们需要重新获取token，具体的方法可以看如下文章。

网站使用umami api制作数据挂件