本文主要介绍如何将旧社区版本升级为 v1.0.0。如果你未曾安装过 Dify 社区版,可以直接克隆 Dify 项目,并切换至 1.0.0
分支。参考文档执行安装命令。
如需在社区版中体验插件功能,需要将版本号升级为 v1.0.0
。本文将为你介绍如何从旧版本升级至 v1.0.0
以体验插件生态功能。
cd
命令至你的 Dify 项目路径,新建备份分支。
1.2 运行以下命令,备份你的 docker-compose YAML 文件(可选)。
v1.0.0
支持通过 Docker Compose 部署。运行 cd
命令至你的 Dify 项目路径,运行以下命令升级 Dify 版本:
重要提示:关于命令执行和包管理
- 默认容器名称:
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
容器内继续运行以下命令:
provider name
,并在其后附加 langgenius/{provider_name}/{provider_name}
。