dify案例分享-0.15.X版本升级1.0.0

发布日期：2025-03-03 06:44:03 浏览次数： 3667

作者：wwzhouhui

微信搜一搜，关注“wwzhouhui”

2025年2月28日日dify官方推出了V1.0.0Release版本。新版本的核心亮点、AI 应用开发新范式、插件机制、工作流增强、开放生态等内容。

AI 应用开发新范式：生成式 AI 发展促使 AI 应用走向独立执行复杂任务，Dify 致力于构建下一代 AI 应用开发平台，实现推理、行动、动态记忆、多模态 I/O 四大核心能力，通过灵活编排框架提升能力以满足复杂需求。
解耦重构：插件化架构：重构底层架构，引入插件机制。插件与主平台解耦，具有组件插件化、开发者友好、热插拔设计、多种分发机制的优势。Dify Marketplace 是插件聚合平台，已有 120 + 个插件，插件还可通过社区共享和本地私域分发。
灵活编排：智能化工作流：新增工作流中的 Agent 节点，能根据 Agent 策略进行智能调度。Agent 策略插件预设经典策略并支持多种推理策略，同时公布开发标准鼓励创新共享。
开放生态：多元化应用形态：扩展类型插件可作为生态连接器，实现 AI 应用与外部平台对接；平台支持多模态交互插件；Marketplace 是价值共享平台，促进创意交流、资源共享与共赢。
今天就带大家体验下从0.15.3 版本升级到1.0.0 这个版本操作步骤。

考虑到大部分小伙伴使用windows电脑，本次使用Docker Desktop 方式。话不多说下面介绍一下如何升级。

1.升级准备工作

首选我们需要把1.0.0 版本源码下载下来。

解压源码1.0.0

这里我们需要和0.15.3 版本（上一个版本对一下对比看看改了哪些东西），这里我们主要对比一下docker文件夹内容。

我们使用一个叫做BCompare工具对2个版本docker文件夹里面内容对比一下。

这里我们就不详细展开比较工作，我们把差异的部分找出来。

差异文件

proxy.conf.template

default.conf.template

docker-compose.middleware.yaml

docker-compose.yaml

.env

docker-compose-template.yaml

middleware.env.example

我们使用BCompare工具比较后的效果图如下：

从上面的图我们可以看出标红的部分是有差异的，黑色的就一样的。

其实我们从dify上来看上面变化的文件有的是其实不需要我们管的，我们排查一下不需要管的middleware.env.example、docker-compose-template.yaml、docker-compose.middleware.yaml，剩下的就是我们需要管的部分。

重点的几个文件我们需要注意.env docker-compose.yaml 、default.conf.template、proxy.conf.template

2.备份

在升级之前我们需要备份一下volumes 这个是docker 数据库依赖的文件，这个是核心。

备份volumes、.env docker-compose.yaml 、default.conf.template、proxy.conf.template

3.升级替换文件

如果你之前配置文件.env没有修改端口或者其他参数的话，包括docker-compose.yaml 、default.conf.template、proxy.conf.template都没修改的话。可以将1.0.0对应的文件覆盖0.15.3 版本这些文件。

在升级文件前我们先把docker 服务停掉。

4.下载最新的dify镜像

我们从上面升级准备工作中看到langgenius/dify-web:1.0.0 镜像是升级的了，我们整理一下需要升级到几个镜像路径，执行镜像下载

docker pull langgenius/dify-web:1.0.0
docker pull langgenius/dify-api:1.0.0
docker pull langgenius/dify-plugin-daemon:0.0.3-local

这里我们注意到升级的2个包dify-web、dify-api 本次还新增加一个容器镜像dify-plugin-daemon 我理解应该是插件使用的。

把上面3个镜像下载完成。

5.启动镜像

接下来我们启动镜像，进入D:\temp\dify-0.15.3\docker 目录下。

 cd D:\temp\dify-0.15.3\docker
docker compose -f docker-compose.yaml up -d

我们在Docker Desktop 看到容器已经启动了

我们浏览器打开http://localhost/apps

系统可以登录访问，工作流还在。我们在检查一下模型配置

模型设置这块初始化的模型应该丢了，需要重新配置。

6.模型设置

这里我们需要对每个模型厂商重新安装，现在这个配置变成插件安装形式了。

安装完成后，我们才能设置模型，这里注意的地方就是如果之前安装过该厂商模型的，安装后自动会把上次配置的模型带出来。

上面的硅基我是之前安装设置过的，系统会默认带出模型。

不过具体测试下来发现模型配置有的也是会丢失。所以建议大家重新配置一下模型KEY

7.总结

今天主要带大家了解了从 Dify 0.15.3 版本升级到 1.0.0 版本的详细操作步骤。详细阐述了升级的具体操作，包括升级准备工作，如下载 1.0.0 版本源码并解压，使用 BCompare 工具对比两个版本 docker 文件夹内容，找出差异文件，明确重点需要关注的文件；进行备份操作，备份 volumes 以及几个关键文件；升级替换文件时，若之前配置文件未修改可直接覆盖，并在升级前停止 docker 服务；下载最新的 Dify 镜像，包括三个特定的镜像；启动镜像，在指定目录下执行相关命令，看到容器启动后在浏览器打开相应地址进行访问，检查发现模型配置可能丢失；最后进行模型设置，需对每个模型厂商重新安装，且建议重新配置模型 KEY。

因为这版本升级有点大，很多细节的地方没有经过详细测试。目前测试下来模型设置这块升级后需要重新设置这个地方设计的不太好。