Dify 1.1.2悄悄发布！从0.15.3直接跨越，升级体验分享

Dify 1.1.2版本悄无声息地发布了，这次更新带来了一些值得关注的新功能和体验升级。

从去年年底将dify升级到0.15.3版本后，过去一段时间一直没有再更新，但始终留意着各个新版本的发布动态，特别是1.0.0版本暴露出的各种问题。最近几天，Dify 1.0.1正式发布，带来了知识库元数据等让人眼前一亮的特性（具体可以浏览Dify官网了解）。更没想到的是，短短几天内，Dify又先后更新到了1.1.0、1.1.1，刚才去官网一看，竟然已经悄悄发布了v1.1.2。这下是真的坐不住了，索性直接升级到最新版。

这篇文章正是为此而生。话不多说，直接上干货。

如果刚接触Dify的朋友刷到这篇文章，建议先了解Dify是什么，然后跟着下面的教程就能轻松完成Dify私有化部署——相比版本升级，从头部署反而更省事。

Dify官网：https://dify.ai/
GitHub：https://github.com/langgenius/dify

版本备份（首次部署可忽略）

第一步：备份应用

进入Dify工作室页面，将重要的应用导出为DSL文件，确保升级万无一失。这一步很容易被大多数人忽略。其实不只版本升级，平时养成定时备份的习惯也很有必要，尤其在团队协作场景下。

第二步：备份docker-compose.yml

进入Dify项目路径下的docker文件夹，备份docker-compose.yaml文件，这个文件包含了服务编排的配置信息。

cd docker
cp docker-compose.yaml docker-compose.yaml.0.15.3.bak

第三步：备份环境变量文件.env

.env文件包含了中间件、服务的核心配置变量。

cp .env .env_0.15.3.bak

第四步：停服与备份数据卷

使用docker-compose部署的Dify，数据卷默认指向volumes目录。备份数据卷可以避免业务数据丢失或因升级导致的业务数据异常问题。

docker compose down
tar -cvf volumes-0.15.3.tgz volumes

版本升级

完成0.15.3版本的备份后，接下来开始升级新版本。

第一步：拉取最新代码

在Dify项目路径下运行以下命令。如果是第一次部署Dify，需要先通过git clone初始化拉取代码。

git checkout main
git pull

第二步：环境变量配置（重要！）

这一步极其关键。特别是版本跨度较大的情况下，环境变量也会有所调整，这也是为什么上面要备份.env文件。最近在Dify社区微信群里看到不少朋友反馈升级新版本遇到问题，总结下来，绝大多数原因都出在忽略了这一步。

cp .env.example .env

第三步：启动新版本

环境变量更新之后，运行以下命令来启动新版本的服务：

docker compose up -d

Docker Compose会自动下载Dify最新镜像并启动服务。这一步耗时可能较长，请耐心等待。

第四步：检查服务状态

通过以下命令查看服务是否正常启动：

docker compose ps

新版本服务启动成功！

新版本踩坑

前面升级还算顺利，三下五除二就完成了。迫不及待打开浏览器访问Dify控制台，进入工作室，之前编排的应用都还在。

接着准备预览测试一下之前编排的应用，结果页面突然飞来了一个异常弹框！好在升级前已经浏览了最近几个新版本的升级日志，所以心里有底，一点也不慌。

插件安装

从1.0.0版本开始，工具插件以及模型供应商都插件化了，所以需要按需安装相应的插件。安装完成后，之前配置的大模型信息仍然保留。新版本页面增加了插件功能项，点击安装插件，支持三种安装方式。点击Marketplace，可以看到目前插件类型有四种，可以按需一键安装。另外也可以使用离线安装方式（更推荐离线本地插件）。

本地插件安装（离线方式）

离线插件下载：访问Dify市场，下载插件离线文件。本地插件安装：选择本地插件，按照离线方式，把上一版本中用到的模型供应商插件都装好。再打开设置界面查看模型供应商详情，可以看到之前配置的信息全部保留。

应用测试

插件安装完成后，之前的大模型配置信息完好无损。测试一下之前分享过的两个简单应用，结果证明：版本升级成功！

无需一行代码：基于Dify + Mermaid构建「自然语言转图表」智能体的全流程解析

不写一行代码！3分钟轻松编排一个可视化数据分析智能体