Dify 从 1.1.3 升级到 1.2.0 的数据迁移指南

前言

Dify 作为一个开源的大模型应用开发平台，在版本迭代过程中可能会涉及数据库结构的变更。本文将详细介绍如何从 1.1.3 版本安全升级到 1.2.0 版本，并完成必要的数据迁移工作。

准备工作

在进行升级前，请确保已完成以下准备工作：

1. 备份数据库：这是最重要的步骤，避免升级失败导致数据丢失
2. 检查系统资源：确保服务器有足够的资源完成升级过程
3. 规划停机时间：升级过程中服务将不可用，建议选择业务低峰期进行

升级步骤

1. 获取容器信息

首先需要确定当前运行的 Dify 容器 ID：

docker ps

记录下 docker-api 容器的 ID，后续操作将在这个容器内执行。

2. 进入容器终端

使用以下命令进入容器终端：

docker exec -it <container_id> bash

3. 插件数据提取

在容器内执行插件数据提取命令：

poetry run flask extract-plugins --workers=20

此命令会提取当前系统中所有正在使用的模型和工具数据，--workers=20 参数表示使用 20 个 worker 并行处理，可根据服务器配置调整。

4. 插件安装

确保服务器可以访问公网后，执行插件安装命令：

poetry run flask install-plugins --workers=2

此步骤会从官方源下载并安装最新版本的插件。

5. 插件数据迁移

执行数据迁移命令，更新 provider 名称：

poetry run flask migrate-data-for-plugin

成功执行后会显示类似以下信息：

Migrate [tool_builtin_providers] data for plugin completed, total: 6
Migrate data for plugin completed.

6. 数据库结构升级

最后执行数据库结构升级命令：

poetry run flask db upgrade

此命令会根据新版 Dify 的要求更新数据库表结构。

验证升级

升级完成后，建议进行以下验证：

1. 访问 Dify 平台，检查基本功能是否正常
2. 点击"Plugins"按钮，验证所有插件是否正常工作
3. 检查关键业务流程，确保数据完整性和功能可用性

注意事项

1. 整个升级过程可能需要较长时间，取决于数据量和服务器性能
2. 如果遇到网络问题导致插件安装失败，可重试 install-plugins 命令
3. 升级后如发现异常，可考虑回滚到备份版本
4. 建议在测试环境先验证升级流程，确认无误后再在生产环境执行

总结

通过以上步骤，可以安全地将 Dify 从 1.1.3 版本升级到 1.2.0 版本。升级过程中最关键的是做好数据备份和验证工作，确保业务数据不会丢失，升级后系统功能正常。如果在升级过程中遇到问题，可以参考 Dify 官方文档或社区寻求帮助。