Umami从2.x升级到3.0教程：基于1Panel面板的数据库迁移与数据备份

Umami 3.0版本已发布许久，最新版本为v3.0.3。此次升级改动较大，无法直接从2.x版本平滑升级，且v3.0版本已不再支持MySQL数据库，仅支持PostgreSQL。

一、更新准备

1. 环境

• 1Panel面板版本：v2.0.15
• Umami版本：从 mysql-v2.20.2 升级至 v3.0.3

2. 安装PostgreSQL

由于Umami v3.0仅支持PostgreSQL，因此需要先部署该数据库。在1Panel面板的应用商店中，直接搜索并安装PostgreSQL即可，云原生与Docker相关的部署和配置可以参考这里的专题内容。

3. 备份数据

在升级前，务必对原Umami v2.x的MySQL数据进行完整备份。

• 导出数据：将原MySQL中的所有表数据，导出为CSV格式进行备份。只要单个文件不超过1GB，使用CSV格式作为从MySQL迁移到PostgreSQL的中间格式是一种简单快捷的方法。
  
• 重要提示：即使你原先使用的是PostgreSQL数据库，在重大版本更新前也建议备份数据，以防更新失败时能够快速回滚。

二、安装Umami v3.0.3

在1Panel面板中，直接卸载旧的 umami: mysql-v2.20.2 应用。随后，在应用商店中重新搜索Umami，选择最新的 v3.0.3 版本进行安装。在配置过程中，数据库类型需选择新安装的PostgreSQL，数据库与中间件的选型和运维知识可以在此板块找到。

三、导入数据

Umami v3.0.3安装并启动后，需要将之前备份的数据导入新的PostgreSQL数据库。

1. 将导出的所有CSV数据文件中，除 _prisma_migrations 表外的所有非空数据表，导入到新的PostgreSQL数据库中。
2. 数据导入完成后，在1Panel中重启Umami应用，使更改生效。

四、验证更新

访问你的Umami网站，使用之前的账号密码登录。如果升级成功，你将看到全新的v3.0界面。请务必检查核心数据（如网站、访问统计等）是否完整迁移，以确保升级无误。

相关阅读：

• 为Halo博客配置Umami统计插件