Dify 1.20 自托管升级与架构变更指南
文章梳理 Dify 1.20 的 OpenTelemetry 链路追踪、多渠道人工审批及知识库上传恶意文件扫描。自托管升级涉及环境变量拆分、新增两个 Celery 队列和六次顺序数据库迁移。
原文暂未完整获取,基于公开信息的快读
Dify 1.20 的一篇第三方架构指南,将升级重点放在链路追踪、人工审批和知识库文件扫描上。对自托管团队,更需要留意的是部署变更:按现有摘要与节选,升级涉及环境变量拆分、两个新增 Celery 队列,以及六次顺序数据库迁移。原文尚未完整读取,这些说法仍缺少官方材料交叉确认。
目前能确认什么
目前能确认的是文章明确提出了以下变更,不能直接视为官方升级承诺。
可观测性方面,节选称 Dify 1.20 原生接入 OpenTelemetry,导出 Agent 执行链路、延迟和工具调用信息。OpenTelemetry 是通用遥测标准,有助于将不同服务的执行记录串起来;但采用标准,并不自动保证所有采集后端都能完整展示这些字段。
人工介入(HITL)方面,文章描述了向企业聊天工具及邮件发送审批卡片的机制。Celery 是异步任务队列,新增的 human_input_delivery 和 human_input_contact_sync 队列,需要有对应 worker 消费。
部署方面,节选要求将原有 shared.env 配置拆到 api-worker.env 与 urls.env,并顺序执行六次 Alembic 数据库迁移。此外,文章称知识库文件会在切分和向量化前接受恶意文件扫描。
我的判断
自托管升级的首要检查项,是配置、队列和数据库迁移是否一起到位。
只更新镜像,可能遗漏审批任务的消费配置。升级前应核对 worker 订阅哪些队列,并确认拆分后的环境变量由哪些服务加载。
链路追踪还涉及数据边界:节选提到导出工具调用内容,但没有交代脱敏规则和采集范围。接入企业监控前,这两项需要官方文档明确。
文件扫描也不能等同于防住知识库投毒。恶意软件检测与识别文档中的提示注入,是不同问题。扫描失败时是否阻断上传、审批超时如何处理、数据库迁移如何回滚,现有材料都没说清,暂时不足以据此编排生产升级。