将社区版迁移至 v1.0.0
本文主要介绍如何将旧社区版本升级为 v1.0.0。如果你未曾安装过 Dify 社区版，可以直接克隆 Dify 项目，并切换至
1.0.0分支。参考文档执行安装命令。
如需在社区版中体验插件功能，需要将版本号升级为 v1.0.0。本文将为你介绍如何从旧版本升级至 v1.0.0 以体验插件生态功能。
开始升级
升级分为以下步骤：
备份数据
插件迁移
主项目升级
1. 备份数据
1.1 运行 cd 命令至你的 Dify 项目路径，新建备份分支。
1.2 运行以下命令，备份你的 docker-compose YAML 文件（可选）。
cd docker
cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak1.3 运行命令停止服务，在 Docker 目录中执行备份数据命令。
docker compose down
tar -cvf volumes-$(date +%s).tgz volumes2. 升级版本
v1.0.0 支持通过 Docker Compose 部署。运行 cd 命令至你的 Dify 项目路径，运行以下命令升级 Dify 版本：
git fetch origin
git checkout 1.0.0 # 切换至 1.0.0 分支
cd docker
nano .env # 修改环境配置文件同步 .env.example 文件
docker compose -f docker-compose.yaml up -d3. 工具迁移为插件
该步骤的目的：将此前社区版本所使用的工具及模型供应商，自动进行数据迁移并安装至新版本的插件环境中。
运行 docker ps 命令，查看 docker-api 容器 id 号。
示例：
docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
417241cd**** nginx:latest "sh -c 'cp /docker-e…" 3 hours ago Up 3 hours 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp docker-nginx-1
f84aa773**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-worker-1
a3cb19c2**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-api-1运行命令 docker exec -it a3cb19c2**** bash 进入容器终端，在容器内运行：
poetry run flask extract-plugins --workers=20如果提示报错，建议参考前置准备，先在服务器内安装
poetry环境；运行命令后，若终端出现待输入项，点击 “回车” 跳过输入。
此命令将提取当前环境中使用的所有模型和工具。workers 参数将决定提取过程中的所使用的并行进程数，可根据需要进行调整。命令运行完成后将生成 plugins.jsonl 文件保存结果，该文件包含了当前 Dify 实例中所有工作区的插件信息。
确保你的网络正常访问公网，并支持访问：https://marketplace.dify.ai。在 docker-api-1 容器内继续运行以下命令：
poetry run flask install-plugins --workers=2此命令将下载并安装所有必要的插件到最新的社区版本中。
最后迁移插件数据。运行以下命令更新 provider name，并在其后附加 langgenius/{provider_name}/{provider_name}。
poetry run flask migrate-data-for-plugin当终端出现以下标识时，迁移完成。
Migrate [tool_builtin_providers] data for plugin completed, total: 6
Migrate data for plugin completed.验证结果
访问 Dify 平台，轻点右上角 “插件” 查看此前所使用的工具是否被正确安装。随机使用某个插件，验证是否能够正常运行。如果无误，说明你已完成版本升级和数据迁移。
Last updated