Dify升级不成功？你只要做对这一步，升级真的太简单了！

升级Dify应用，其实没有想象中那么折腾。这几天不少朋友反映升级总是卡壳，反复折腾之后干脆备份数据重新部署——从Dify的部署复杂度来看，这确实是一条捷径，但每次都这么搞，总觉得差点意思。这篇文章就用完整而详细的实操，带你走一遍升级流程，紧跟官方步伐。

Dify的docker部署

这一步相信大家都已经完成了，本来不需要啰嗦，但为了文章的完整性，还是把基础步骤列出来。已经熟练的朋友可以直接跳到下一节。

首先从官方获取安装文件，需要安装git。建议先将Dify fork到自己的仓库，免得引起不必要的麻烦，这一点评论区再细聊。

git clone https://gitee.com/xxx/dify.git

1. 安装docker容器，正常下载安装即可。
2. 进入Dify源代码的Docker目录：

cd D:difydify-composedifydocker

3. 复制环境配置文件，将.env.example文件复制一份并重命名为.env：

cp .env.example .env

4. 启动docker容器。此时需要等待下载资源，如果多次失败，请检查docker compose的配置（设置 → Docker Engine）中是否配置了合适的镜像源。然后静待资源加载完毕，网络正常的话大概4分钟即可完成——实测用了199秒。

docker compose up -d

启动完成后，在浏览器输入http://127.0.0.1/即可访问。初次登录需要设置邮箱和用户名密码，随便填写符合格式的信息即可，后续使用需要记住。剩余的登录步骤一步步来就行，这里不再展开。

Dify升级

注意：数据无价，无论什么升级，都要记得备份重要数据。怎么重视都不过分。

Dify是个非常活跃的应用，迭代更新很快，所以及时升级很有必要。具体操作如下：

• 进入Dify源代码的docker目录，按顺序执行以下命令：

cd dify/docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d

逐条执行：

docker compose down

如果是通过下载zip部署的，这里会报错，原因是未安装git。先安装git即可。

git pull origin main

等待拉取完成。之后需要配置git仓库，这一步一定要配置成自己的仓库——重要的事情说三遍。这样后续可以实时拉取官方镜像来更新自己的仓库。如果这些操作不熟悉，可以在评论区留言，我们可以再出一篇详细的安装过程。

然后再次执行后面的命令：

docker compose pull

接着启动容器。注意：如果.env文件有更新，必须先重新配置.env文件（如果没有个性化的配置，建议直接用.env.example文件复制并改名替换，避免漏掉重要更新），具体步骤见下文。

最后访问页面，可以看到成功升级到了1.4版本，之前的应用数据也完好保留。

到此，Dify的整个升级就完成了。