Dify升级指南：1.1.13->1.3.1

前不久dify升级到了1.3.1的版本，等待了几天看样子这个版本还是比较稳定的，于是着手将我们的版本升级到1.3.1。由于在1.3.0版本中，Dify的包管理工具Poetry 迁移到 了uv，因此和以往的升级略有不同。本文将详细介绍将Dify的版本从1.1.13升级到1.3.1。

?️ Enhancements

• Python Package Manager Upgrade: We made a significant switch from poetry to uv as our Python package manager. This speeds up operations, minimizes merge conflicts, and streamlines our development process. Huge thanks to@bowenliang123for leading this transition in#16317.

源码拉取

cd /your_dify_project/
## 拉取最新的源码
git pull
## 暂存当前分支
git stash 
## 切换到1.3.1版本
git checkout tags/1.3.1 

修改API服务的源码及配置文件

在《在Dify中使用MinerU提取PDF》中，我们为了能够在沙箱节点中读取到本地文件，修改了api/services/file_service.py中的源码，因此需要自己源码构建api服务镜像。本次升级的基本步骤与之前文章一致，但是新版本的包管理工具由Poetry 改成了uv，需要在api/pyproject.toml中添加uv的镜像地址，来替代之前的Poetry的镜像地址。

[[tool.uv.index]]
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true

在宿主机中执行以下命令：

cd /api
uv lock

同时为了提升nltk数据的下载速度，也可以配置阿里源：修改api/Dockerfile

# Download nltk data
RUN python -c "import nltk; nltk.set_proxy('http://mirrors.aliyun.com/nltk_data/'); nltk.download('punkt'); nltk.download('averaged_perceptron_tagger')"

Docker启动服务

修改 docker/docker-compose.ymal文件：

• 修改api服务的配置，注释掉image新增build

api:
    build: ../api
    restart: always

• 修改sandbox服务的volumes参数

volumes:
      - ./volumes/sandbox/dependencies:/dependencies
      - ./volumes/sandbox/conf:/conf
      - ./volumes/app/storage:/var/sandbox/sandbox-python/usr/local/storage  # 此行为新增

删除1.1.13版本的自建api镜像

## 查看镜像的ID
docker images

## 备份以下
docker tag 镜像ID docker-api-1.1.13

## 删除镜像
docker rmi 镜像ID

重新启动服务

cd docker/
docker compose -f docker-compose.yaml up -d

工作流测试

再次登录Dify，看下我们的工作流和知识库内的文件是否都在，选择一个RAG的工作流，进行测试。以公司制度助手为例，看样子工作流能够正常运行。