将版本升级至 v1.0.0+
本节介绍将旧社区版迁移到 Dify v1.0.0+ 的方法。对于将 Dify Premium 或社区版升级到此特定迁移范围之后的版本,请参考它们各自主要的升级说明。
版本 v1.0.0+ 包含插件功能,详细介绍请参考此处 (v1.0.0 Release) 和 v1.3.0 Release Notes (关于uv切换)。升级分为以下步骤:
cd
命令至你的 Dify 项目路径,新建备份分支。1.2 运行以下命令,备份你的 docker-compose YAML 文件(可选)。v1.0.0
支持通过 Docker Compose 部署。运行 cd
命令至你的 Dify 项目路径,运行以下命令升级 Dify 版本:关于命令执行和包管理的重要提示(针对v1.0.0迁移):
- 默认容器名称:
docker exec
命令示例使用了docker-api-1
。如果您的 API 容器有不同的名称或 ID(您可以使用docker ps
查找),请相应调整命令。- Python 包管理器 (
uv
与poetry
):
poetry
切换到 uv
以提升性能。对于 Dify v1.3.0 或更新版本中的常规操作,标准命令是 uv run flask ...
。poetry
是其包管理器。因此,下方示例中的 flask
命令正确地使用了 poetry run ...
。代码示例首先在注释中强调了当前 uv
的标准用法,然后显示了与本特定 v1.0.0 迁移范围相关的 poetry
命令。docker ps
命令,查看 API 容器的名称或 ID。默认名称通常是 docker-api-1
。docker exec -it docker-api-1 bash
进入容器终端(如果您的容器名称不同,请使用对应的名称),在容器内运行:如果在按照本指南为 v1.0.0 版本迁移执行命令时发生错误(例如,找不到此命令将提取当前环境中使用的所有模型和工具。workers 参数将决定提取过程中的所使用的并行进程数,可根据需要进行调整。命令运行完成后将生成uv
或poetry
),请确保按照该版本最初的先决条件,在服务器上正确设置了poetry
环境。如果在运行poetry
命令后终端提示输入,请按 “回车” 跳过。
plugins.jsonl
文件保存结果,该文件包含了当前 Dify 实例中所有工作区的插件信息。确保你的网络正常访问公网,并支持访问:https://marketplace.dify.ai
。在 docker-api-1
容器内继续运行以下命令:Install plugins completed.
标识时,迁移完成。.env
下的环境变量。然后使用以下命令重新启动 Dify: