---

1.Dfiy官方说明

不同版本的升级步骤可能有所不同。请参阅 Releases （https://github.com/langgenius/dify/releases）页面中提供的目标版本升级指南。升级后，请检查 .env.example 文件是否有变更，并相应更新你的本地 .env 文件。

2.Dfiy升级操作

注意，本升级操作适用于使用 Docker Compose 部署 Dify 平台。

2.1 备份旧版本Dify数据

1）备份.env环境变量文件

进入dify的docker目录下，执行以下命令：

$ cd /home/zonesion/dify-1.13.0/docker/
$ cp .env .env.$(date +%s).bak

2）备份数据卷

进入dify的docker目录下，执行以下命令：

$ cd /home/zonesion/dify-1.13.0/docker/
$ tar -cvf volumes-$(date +%s).tgz volumes

如果出现权限问题，请在命令前加sudo。

2.2 下载新版本Dify软件包

以下载Dify版本v1.13.3软件包为例，提供手动下载和命令下载两种方式。

1）Releases页面手动下载

Releases页面地址：https://github.com/langgenius/dify/releases，在对应发布版本的Assets板块下，点击软件包链接，浏览器将自动下载：

以下载zip压缩格式为例：

2）wget命令下载

进入系统home目录下，执行以下命令：

$ cd ~
$ wget https://github.com/langgenius/dify/archive/refs/tags/1.13.3.zip

将下载对应的软件压缩包。

2.3 升级服务

上传新版本的dify软件包到系统home目录下，并解压缩：

$ cd ~
$ unzip dify-1.13.3.zip && rm dify-1.13.3.zip

升级前，先停止旧版本dify服务，在 Docker 目录中执行操作。例如：

$ cd /home/zonesion/dify-1.13.0/docker/
$ docker compose down

然后在新版本dify的Docker 目录中执行操作，升级服务：

$ cd /home/zonesion/dify-1.13.3/docker/
$ docker compose up -d

2.4 迁移数据

1）.env环境变量迁移

新版本Dify的docker文件目录如下：

执行以下命令，复制一份示例环境变量文件：

$ cd /home/zonesion/dify-1.13.3/docker/
$ cp .env.example .env

由于Dify不同版本可能会新增重要的环境变量参数，所以迁移时，最好对比修改新版本环境变量文件的参数值，而不是直接覆盖使用。

例如使用Notepad++对比文件功能，对比新旧Dify版本.env文件，找出自定义的环境变量值，修改到新版本Dify环境变量文件.env中：

环境变量.env文件修改保存后，需要重启服务才能生效：

$ cd /home/zonesion/dify-1.13.3/docker/
$ docker compose down
$ docker compose up -d

2）数据卷迁移

直接将旧版本Dify数据卷复制过来即可，需要注意用户权限问题。将旧版本的volumes目录复制到新版本的docker目录下，解压缩，然后注意将目录权限修改为用户权限，root权限将会导致数据读取失败。

具体执行命令如下，前面备份了旧版本的数据卷，例如volumes-1776235650.tgz，复制到新版Dify的docker目录下，解压缩：

$ cd /home/zonesion/dify-1.13.3/docker/
$ cp ~/home/zonesion/dify-1.13.0/docker/volumes-1776235650.tgz ./
$ tar -xvzf volumes-1776235650.tgz

刷新Dify前端页面，查看迁移过来的数据能否显示，若正常显示，则迁移成功，否则可能是数据卷权限问题导致。

修改volumes权限命令如下：

$ cd /home/zonesion/dify-1.13.3/docker/
$ sudo chown -R $USER:$USER ./volumes