嘿，小伙伴們！今天給大家帶來一個超實用的干貨分享——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！