背景

今日在 Loc 论坛看到一篇关于 Umami 从 V1 迁移至 V2 的帖子,本着不是新版本我不用的理念 🤣,我尝试升级了一下,顺利完成。提前说明一下,我使用的是 Docker Compose 部署,其他部署方式的升级方法,可以查看“参考资料”里面的官方教程。

迁移数据库

根据官方的说法,V2 是一项改变巨大的版本,不仅数据库结构发生了改变,用于统计的 JS 代码路径也改变了,这里先介绍数据库迁移。

首先利用 docker ps 检查正在运行的 Umami 容器名称(我的是 umami-umami-1),随后进入容器:

docker exec -ti -u 0 <你的容器名称> sh

进入之后,你会看到 /app 开头的路径,然后输入下面的命令执行数据库迁移:

npx @umami/migrate-v1-v2@latest

成功后,大致会返回下面的内容:

升级 V2

当你执行完数据库的迁移之后,接下来停止容器:

docker compose down

列出目前使用的镜像文件:

docker image ls

找到你目前使用的 Umami 镜像,并删除:

docker rmi <Umami镜像名字>

最后重新拉取、创建容器:

docker compose pull && docker compose up -d

修改统计代码

上面说到,这一次的版本还改动了统计代码,你可以在管理面板找到,路径是:

设置 -> 网站 -> 编辑 -> 跟踪代码

参考资料