Dify近期发布很是频繁，基本两三天一个版本。值得肯定的是优化和改进了很多问题，但是官方的升级文档有点分散，也有点乱。我这里整理了一个升级文档供大家参考，如果还没有升级到新版本的小伙伴，可以按照我的文档去操作升级。

Docker Compose 部署的请参考方式一

源代码部署的请参考方式二

一. Docker Compose 部署的

1、 停止Dify服务（在Dify下的docker目录执行，请把目录换成你自己的）

cd E:\workspace\dify\docker
docker compose down

2、备份现有的docker-compose.yaml文件，加上日期好区分是什么时候备份的。

cp docker-compose.yaml docker-compose.yaml.20250326.bak

3、备份环境配置文件。

cp .env .env.20250326.bak

4、备份数据

tar -cvf volumes-20250326.tgz volumes

5、从 main 分支获取最新代码

git pull origin main

ps：有的小伙伴不是用git下载的源码，而是Download ZIP的方式下载的源码，或者从别的地方下载的源码压缩包，这种方式用git pull会报错fatal: not a git repository (or any of the parent directories): .git，因为你的目录并没有让git管理起来。可以从官网Download ZIP方式下载解压后把对应的文件覆盖原来的文件也是一样可以的
https://github.com/langgenius/dify/

6、将原来的工具迁移为插件(低于v1.0.0版本的才需要，>= v1.0.0版本的不用)
参考：https://docs.dify.ai/zh-hans/development/migration/migrate-to-v1

7、重新启动Dify服务（需要在Dify下的docker目录执行）

docker compose up -d

二. 源代码部署的

1、停止 API 服务器、Worker 和 Web 前端服务器

2、从 release 分支获取最新代码，请把x.x.x换成最新的版本号

git checkout x.x.x

3、更新 Python 依赖项（需要在Dify下的api目录执行）

cd api
poetry install

4、运行迁移脚本

poetry run flask db upgrade

5、再次运行 API 服务器、Worker 和 Web 前端服务器

《零基础小白AI实战教程：手把手教你打造专属的智能体》 系列教程更新中！
已更新：AI实践虚拟化平台安装
已更新：Docker Desktop 安装
已更新：Ollama安装教程
已更新：DeepSeek私有化部署
已更新：Dify私有化部署
已更新：Dify + DeepSeek搭建本地私有化知识库
已更新：Dify应用类型的选择
已更新：Dify升级指南

私信"AI"，免费领取全套教程的资料和源码