Dify 1.20.0 升级:OpenTelemetry 追踪、文件扫描与 Langfuse 端点迁移
Dify 1.20.0 发布,新增 OpenTelemetry 追踪导出、知识库上传文件恶意软件扫描与 Chatflow 工具调用展示,并适配 Langfuse v4 与新的云 ingestion 端点。自托管团队升级前需要处理数据库迁移与配置变更。
1.20.0 迁移 Langfuse 端点并新增知识库文件扫描
Dify 1.20.0 优先处理了升级与运维相关的断点:Langfuse 旧端点退役、追踪导出、知识库文件扫描与插件守护进程版本。 自托管部署需要按迁移说明处理数据库变更。
Langfuse 端点迁移
Langfuse Cloud 已在 2026 年 11 月 16 日停用旧 ingestion 端点,自托管 Langfuse v4 也会拒绝发往旧端点的事件。升级到 1.20.0 才能继续把追踪送到这些部署。官方原文称:“Export traces to any OpenTelemetry collector”。
知识库文件扫描
开启 FILE_SCAN_ENABLED=true 后,管理员可以在 Integrations 的文件安全扫描里配置 Cloudmersive、Scanii、OPSWAT MetaDefender Cloud 或自定义端点,并按知识库选择扫描器与失败回退策略。扫描覆盖经典知识库、RAG Pipeline 本地文件与 Agent 知识库上传。
插件与配置变更
内置插件守护进程升级到 0.6.15-local,同时包含数据库迁移与配置变更。升级前要按发布说明逐项核对,避免插件或环境变量不兼容。(来源:Dify 官方发布)
追踪可导出到任意 OpenTelemetry 采集器,HITL 默认开启
追踪可导出到任意 OpenTelemetry 采集器、知识库上传先做恶意扫描、HITL 默认开启,但数据库迁移与配置变更不能跳过。 自托管团队需要安排维护窗口。
可观测性更统一
新的 OpenTelemetry provider 可以把应用与 Agent 追踪导出到任意兼容采集器,工作流步骤、模型调用与工具活动能放在同一个可观测性平台里。
知识库更安全
上传文件在解析与入索引前先做恶意扫描,扫描失败会出现在文档列表里供复核。对开放上传的知识库,这能减少把风险文件带进检索链路。
审批与插件变化
New HITL 默认开启(NEXT_PUBLIC_ENABLE_HITL=true),审批请求可以通过邮件与 Slack、飞书、Teams、钉钉、企业微信发送。使用旧 Human Input 节点的工作流需要按 opt-in 迁移。
依赖 Langfuse 的自托管实例应先做迁移演练
在用 Langfuse、开放知识库上传或需要统一追踪的部署建议升级;升级前先做备份与迁移演练。 只跑本地测试的实例可以稍后跟进。
谁应该先升级
依赖 Langfuse 追踪的团队最急,因为旧端点已经退役。开放知识库上传、需要文件扫描或 HITL 审批的团队也能直接受益。
升级步骤
- 备份数据库与配置,阅读发布说明里的 Database Migrations 与 Configuration Changes。
- 确认 Langfuse 端点、
FILE_SCAN_ENABLED与 HITL 开关的目标值。 - 升级插件守护进程与主程序,启动后检查追踪、文件扫描与审批通知。
出问题怎么排查
先看迁移日志与插件版本,再确认环境变量是否按新默认值生效;追踪不通时优先检查采集器地址与 Langfuse 端点。官方未披露更多回退步骤,保留升级前的备份是最稳的退路。
常见问题
- Dify 1.20.0 解决了哪些部署问题?
- 新版本适配 Langfuse v4 与新 ingestion 端点,并升级内置插件守护进程到 0.6.15-local。
- Dify 1.20.0 的追踪能导出到哪里?
- 可以通过新的 OpenTelemetry provider 导出到任何兼容 OpenTelemetry 的采集器。
- Dify 1.20.0 的文件扫描怎么开启?
- 设置 FILE_SCAN_ENABLED=true,并在 Integrations 的文件安全扫描里配置扫描器。
- 升级 Dify 1.20.0 前要检查什么?
- 先看数据库迁移与配置变更,确认 Langfuse 端点、文件扫描开关和插件守护进程版本。
相关术语
- OpenTelemetry
- OpenTelemetry 是可观测性标准,用于统一采集链路追踪、指标与日志。
- Langfuse
- Langfuse 是 LLM 可观测性与追踪工具,Dify 可以把执行追踪发送给它。
- HITL
- HITL 是 Human-in-the-loop,把人工审批节点接进工作流,Dify 本次默认开启。
- 插件守护进程
- 插件守护进程是 Dify 运行插件代码的后台服务,本次升级到 0.6.15-local。
这篇文章的来源是什么?
文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。
- Dify v1.20.0 · Dify · 2026-11-18
「Dify v1.20.0」 —— Dify
文章目录