Dify 部署与升级指南：从 1.3 到 1.4

❀͜͡傀儡师2026-05-06 16:41

以下是根据您提供的步骤整理成的技术文章，适合用于文档、博客或内部分享。

Dify 部署与升级指南：从 1.3 到 1.4

一、Dify 1.3 安装

克隆 Dify 1.3.0 代码：

bash 复制代码

git clone https://gitee.com/dify_ai/dify.git --branch 1.3.0

bash 复制代码

cd dify/docker/

复制环境变量示例文件：

bash 复制代码

cp .env.example .env

启动 Docker 容器：

bash 复制代码

docker compose up -d

查看镜像状态：

bash 复制代码

docker images

二、创建工作流

点击 "创建空白应用" ，选择 "工作流"。
进入工作流主界面，依次添加以下节点：
- 知识检索
- LLM
- 结束

三、在线升级到 Dify 1.4

3.1 备份 Dify 1.3

bash 复制代码

cp -rf dify dify.bak
cd dify/docker/
cp docker-compose.yaml docker-compose.yaml.$(date +%Y%m%d).bak
tar -cvf volumes-$(date +%Y%m%d).tgz volumes

3.2 获取 1.4.0 版本

bash 复制代码

git checkout -b 1.4.0
git pull origin 1.4.0
docker-compose down

3.3 启动新版本

bash 复制代码

docker-compose up -d

四、离线升级到 Dify 1.4

适用于无网络或内网环境。

4.1 制作离线镜像包

bash 复制代码

docker save -o dify-web.tar langgenius/dify-web:1.4.0
docker save -o dify-api.tar langgenius/dify-api:1.4.0
docker save -o dify-plugin-daemon.tar langgenius/dify-plugin-daemon:0.0.10-local
docker save -o dify-sandbox.tar langgenius/dify-sandbox:0.2.12

4.2 制作离线安装包

bash 复制代码

git clone https://gitee.com/dify_ai/dify.git --branch 1.4.0
tar -czf dify1.4.tar.gz dify

4.3 备份 Dify 1.3 配置与数据

bash 复制代码

cd dify/docker
cp docker-compose.yaml docker-compose.yaml.$(date +%Y%m%d).bak
tar -cvf volumes-$(date +%Y%m%d).tgz volumes
cp .env .env.bak_1.3

4.4 覆盖为 1.4 版本代码

bash 复制代码

/bin/cp -rf dify1.4/dify/* dify/

4.5 导入离线镜像

bash 复制代码

docker load -i dify-api.tar
docker load -i dify-plugin-daemon.tar
docker load -i dify-sandbox.tar
docker load -i dify-web.tar

五、启动新版本

完成上述步骤后，启动服务：

bash 复制代码

cd dify/docker
docker-compose up -d

六、注意事项

升级前务必完整备份配置、卷数据和 docker-compose 文件。
离线升级需提前在所有目标节点导入镜像。
建议在测试环境中验证升级流程后再操作生产环境。