Dify升级攻略：元数据管理从0.15.3到1.1.0

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版本的源码。

下载完成后，直接用新版本的源码覆盖旧版本的所有文件。替换前需要先退出docker，这个过程有点像给电脑重装系统——看起来有些“暴力”，但只要前期备份工作扎实，就完全不用担心。

文件替换完成后，操作会更加顺畅。打开终端，进入Dify安装目录下的docker目录，执行docker compose down命令。这个命令会停止并移除当前运行的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的功能更加强大，还带来了全新的插件模块和元数据管理功能。希望这篇攻略能帮到大家，如果有问题欢迎一起交流。

来源：互联网