1. 升级前的整体判断:1.8.1 到 1.9.2,到底动了什么
先说结论:Dify 这个项目用 Docker Compose 部署起来确实轻松,一条 docker compose up -d 就能跑,但升级迁移从来不是简单拉个镜像就完事。1.8.1 到 1.9.2 这个跨度,中间隔了多个小版本,虽然官方的 Release Notes 会把每个版本的改动列得清清楚楚,但如果你的环境用了外部 PostgreSQL 和 Weaviate,升级时真正要操心的不是功能差异,而是三块硬骨头:数据库表结构变更、向量库索引兼容性、以及 .env 里那些肉眼看不见但丢了就要命的密钥。
先给正在观望的人一个明确建议:如果在生产环境跑着 Dify,升级前一定要把这一篇读完整再动手。如果是本地测试环境,直接 docker compose pull && docker compose up -d 问题也不大,但依然建议走一遍正规流程,因为只有把 SOP 养成了习惯,生产环境出问题的时候才不会手忙脚乱。
从我实际接触过的升级案例来看,Dify 1.9.x 相对于 1.8.x,改了前端构建方式、知识库分段逻辑、部分 API 响应结构,同时新增了一些配置项。这些东西在界面上看可能差异不大,但底层很可能涉及 PostgreSQL 表结构变动和 Weaviate 索引元数据格式调整。换句话说,只要官方版本号跨了 minor 版本,就不能默认数据完全兼容。
升级前读一遍官方 Release Notes,重点看三个地方:
- Breaking Changes:有没有破坏性变更,比如环境变量改名、某个服务拆分。
- Database Migration:有没有附带的数据库迁移说明。
- Weaviate 版本要求:
docker-compose.yaml里 Weaviate 镜像 tag 是否发生了变化。
这里有个很关键但容易被忽略的点:Dify 官方 compose 文件在 1.9.2 中可能调整了 Weaviate 的镜像版本,如果你的向量库里已经有大量知识库文档,Weaviate 主版本或小版本跨得太大,索引格式不一定兼容。所以升级前一定要把你当前用的 compose 文件和官方最新版做一次 diff,看清楚向量库和数据库镜像 tag 到底变没变。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 升级前的准备动作:把家底摸清楚
2.1 确认当前部署形态
很多人连自己部署的 Dify 是哪种形态都没搞清楚就动手升级,这是大忌。Dify 的部署方式至少有三种:纯 Docker Compose、Docker Compose + 外部 PostgreSQL/Weaviate、Kubernetes Helm。本文的 SOP 针对的是第二种,也就是标题里写的 PostgreSQL + Weaviate + Docker Compose 这种最主流的自建方式。
动手前先确认三件事:
- PostgreSQL 是容器里的还是独立部署的?独立部署的话,版本是多少?Dify 官方默认要求 PostgreSQL 12+。
- Weaviate 是容器里的还是外部服务?当前镜像 tag 是多少?
- 目前 Dify 的版本到底是不是 1.8.1?有时候你以为是 1.8.1,实际容器里跑的镜像 tag 是 latest,已经悄悄变了好几个版本了。
查看当前版本最简单的方式是登录 Dify 界面,看平台设置里的版本号,或者直接看 API 容器的镜像 tag:
bash复制docker ps --filter "name=api" --format "{{.Image}}"
如果输出的是 langgenius/dify-api:1.8.1,那就说明当前确实是 1.8.1。如果输出的是 latest,那就比较麻烦了,因为 latest 会随时漂移,你得先用 docker inspect 看镜像的创建时间或标签历史,确定实际版本。
2.2 梳理自定义配置
这一步是升级翻车的重灾区。Dify 官方提供的 docker-compose.yaml 和 .env.example 只是默认配置,绝大多数人都会做一定程度的自定义。常见的自定义点包括:
- 端口映射:默认 80/443,有人改成 8080 或其他端口。
- 外部数据库连接:把
db服务替换成外部 PostgreSQL,DB_HOST指向局域网或云数据库。 - 对象存储:把默认的本地存储换成 S3、OSS、MinIO。
- 模型供应商凭证:
.env里配置的 OPENAI_API_KEY、自定义模型 endpoint 等。 - Nginx 配置:有人会改 Nginx 的 client_max_body_size、开启 HTTPS。
这些自定义配置在升级时极容易丢。我的习惯是每次升级前,先把自己当前的 docker-compose.yaml 和 .env 都另存一份,再和官方最新版做 diff,把官方新增或修改的配置项合并到自己的文件里。
2.3 建立一个升级窗口
除非是测试环境,否则别在业务高峰期做升级。Dify 升
