官方发布核对

Dify 1.17.1:2026 年已确认的新功能与升级风险

Dify 1.17.1 于 2026 年 9 月 10 日发布。对自托管用户来说,最重要的不是未经证实的性能数字,而是现有内置 Weaviate 数据卷必须先完成分阶段升级。

升级前先确认向量数据库

1.17.1 将内置 Weaviate 从 1.27.0 升级到 1.39.2。Dify 官方说明不支持让现有数据卷跳过中间小版本。直接拉取新镜像并重启可能破坏向量检索。新安装、外部 Weaviate 和其他向量数据库不受这项迁移要求影响。

查看官方 Weaviate 迁移步骤

1.17.1 中已确认的变化

  • 知识库 API 密钥可以限定范围:新密钥可以只访问指定知识库。现有密钥在升级后继续保持原有工作区范围。
  • 旧模型类型迁移进入数据库升级:从 1.15 以前版本升级的安装,不再需要 1.16.1 和 1.17.0 发布说明中的独立手动迁移命令。
  • 数据库包含三项迁移:其中一项模型类型迁移不可逆,升级前应备份数据库。
  • 知识库解析修复:发布说明列出了 CSV、Notion 表格、PDF URL 和旧版 XLS 内容提取问题的修复。受影响的文档需要在升级后重新导入,已建立的索引不会自动修复。
  • 工作流与智能体修复:发布说明记录了 Human Input、工作流工具输出、Agent 会话记忆和大工作流协作连接等问题的修复。

阅读 Dify 1.17.1 官方发布说明

升级前的判断顺序

  1. 检查 Docker 环境中的 VECTOR_STORE。
  2. 如果使用带现有数据的内置 Weaviate,先完成官方分阶段迁移。
  3. 备份数据库、Docker 数据卷和本地修改过的配置。
  4. 阅读 1.17.1 发布说明中的环境变量和数据库迁移部分。
  5. 使用明确的 1.17.1 标签,不要把当前主分支自动当作目标版本。

升级后的基本检查

  • 确认所有预期容器处于健康状态。
  • 运行一次已知模型请求。
  • 用固定问题检查知识库是否仍能返回预期文档。
  • 完整运行一个已发布的代表性工作流。
  • 验证新建的限定范围知识库密钥不能访问未选择的知识库。

如果需要单独的测试服务器,可先查看在 Hetzner VPS 上部署 Dify。有关 MCP 的当前配置路径,请查看Dify MCP 指南。