嘿，小伙伴们！今天给大家带来一个超实用的干货分享——Dify从0.15.3升级到1.1.0版本的详细攻略。这次升级不仅带来了功能上的更新，还特别强化了元数据管理。相信很多小伙伴和我一样，一直在使用Dify来提升工作效率，但每次版本升级都让人有点小头疼。别担心，这次我亲自试水，为大家整理了一份简单易懂的升级指南，保证让你轻松上手，快来看看吧！
一、升级前的准备
在动手升级之前，一定要做好准备工作，这可是避免数据丢失的关键步骤哦！
如果你当初是通过git克隆安装的Dify，那升级过程简直不要太简单。直接按照官网的指引操作就行，简直就是“一键升级”，方便得很，如下图：
说明：当前最新版本是1.1.0，需要将截图中的1.0.0替换成最新版本。
但像我这种当时图省事，直接解压安装的小伙伴，就需要多花点心思了。
首先，一定要备份好关键文件，重点是dify-main/docker目录下：
-
nginx文件夹
-
volumes文件夹
-
.env文件
-
docker-compose.yaml文件
这些文件就像是Dify的“心脏”，备份好它们，即使升级过程中出现意外，也能轻松恢复，不至于手忙脚乱。
二、开始升级
备份工作完成后，就可以正式开始升级啦！下图为升级前的版本：
首先，去Dify的官网下载最新的1.1.0版本源码。
若无法访问Github的小伙伴可通过下方网盘获取：
网盘链接：https://pan.quark.cn/s/fc404ecc70d7下载完成后，直接将旧版本的文件全部替换掉，用新版本的源码覆盖。替换前先退出docker，这个过程有点像给电脑换个新系统，虽然看起来有点“暴力”，但只要前期备份工作到位，就完全不用担心。
文件替换完成后，接下来的操作就更简单了。打开终端，进入Dify安装目录下的docker目录，执行 docker compose down 命令，这个命令的作用是停止并移除当前运行的Dify容器，为新版本的启动做好准备。别担心，这个过程不会对你的数据造成任何影响，只是让系统“休息”一下。
紧接着打开新的终端，进入Dify安装目录下的docker目录，执行 docker compose up -d 命令，这个命令会重新启动Dify服务，并以新版本的方式运行。这时候，你可以去泡杯咖啡，稍等片刻，Dify就会以全新的1.1.0版本和你见面啦！
三、升级后的惊喜
升级完成后，打开浏览器，输入http://localhost，熟悉的Dify界面就会出现在眼前。
1. 增加了插件功能
你会发现，界面变得更加简洁明了，新增了插件部分。这个新功能可厉害了，它把之前的模型和工具完美地整合到了一起，形成了一个强大的插件模块。这样一来，使用起来更加方便，功能也更加强大。
不过，需要注意的是，由于新增的插件模块对之前的工具和模型进行了整合，所以在设置中的模型供应商页面，之前添加的模型可能会丢失。别担心，这并不是什么大问题。官方已经提供了升级方案，虽然我们这次没有进行工具和模型的迁移，但重新添加模型也并不麻烦。
以Ollama官网模型为例，点击右上角的【插件】按钮，选择【探索 Marketplace】，选择【模型】，找到Ollama后点击【安装】
点击后会弹出一个安装插件的弹框。点击“安装”按钮后，Dify就会在后台自动完成安装。
这时候，你可以点击弹窗外的部分，让弹窗消失，安装任务会在后台默默执行。等加载完成后，你会发现，之前的设置都被完美地保留了下来。
进入【设置】-【模型供应商】，重新设置系统模型后就能继续使用了，如下图：
2. 增加了元数据
2.1 元数据的作用
元数据是“关于数据的数据”，它为知识库中的文档提供了额外的描述性信息。在Dify v1.1.0版本中，元数据的作用主要体现在以下几个方面：
-
提升搜索效率：元数据通过为文档添加标签和分类，使用户能够更快速地筛选和查找相关信息。例如，用户可以根据作者、文档类型、上传日期等元数据字段，快速定位到特定文档，从而节省时间并提高工作效率。
-
增强数据安全性：通过元数据设置访问权限，可以确保只有授权用户能够访问敏感信息。例如，利用数值元数据设置隐私级别，用户只能检索到隐私级别高于某一阈值的文档，从而保障数据的安全性。
-
优化数据管理能力：元数据帮助企业或组织有效分类和存储数据，提高数据的管理和检索能力。例如，通过时间元数据，可以区分文档的新旧版本，确保文档处理的一致性。
-
支持自动化流程：元数据在文档管理、数据分析等场景中可以自动触发任务或操作，简化流程并提高整体效率。
2.2 元数据管理
点击顶部菜单【知识库】，选择已有的知识库，如下图：
点击右上方的【元数据】按钮，进入元数据管理界面。在这里，你可以创建、修改和删除元数据字段。
需要注意的是，所有在此界面进行的更新均为全局更新，这意味着对元数据字段列表的任何更改都会影响整个知识库，包括所有文档中标记的元数据。
2.3 元数据字段类型
在知识库中，元数据字段分为两类：内置元数据（Built-in）和自定义元数据。内置元数据由系统预定义，包括文件名、上传者、上传日期等。自定义元数据则需要用户手动添加，可以根据需求设置字段名称和数据类型。
2.4 新建元数据字段
点击【+添加元数据】按钮，弹出新建元数据弹窗。在字段值类型中选择元数据字段的值类型，如字符串、数字或时间。然后在名称框中填写字段的名称，点击【保存】按钮即可。
2.5 编辑文档元数据信息
你可以在知识库管理界面批量编辑文档的元数据信息。勾选你希望批量操作的文档，点击操作选项中的【元数据】，弹出编辑元数据弹窗。在这里，你可以添加、修改或删除元数据字段及其值。
四、配置文件的注意事项
虽然升级过程已经完成，但还有一个小细节需要注意——配置文件。这次升级后，配置文件可能会有一些变更。如果你之前没有对配置文件进行过太多调整，或者只修改了很少一部分，我建议你重新按照新的配置文件进行设置。这样可以避免后期使用过程中出现一些不必要的麻烦，也不会因为新增的配置项没有设置而导致错误问题。
五、总结
从0.15.3升级到1.1.0版本，整个过程其实并不复杂。只要提前做好备份，按照正确的步骤操作，就能轻松完成升级。这次升级不仅让Dify的功能更加强大，还带来了全新的插件模块和元数据管理功能。
希望这篇攻略能帮到大家，如果你在升级过程中遇到任何问题，欢迎在评论区留言，我们一起交流解决。别忘了点赞、转发哦，让更多小伙伴也能轻松升级Dify！
