New Hot

Dify 1.20.0 升级:OpenTelemetry 追踪、文件扫描与 Langfuse 端点迁移

Dify自托管OpenTelemetry版本升级

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 审批的团队也能直接受益。

升级步骤

  1. 备份数据库与配置,阅读发布说明里的 Database Migrations 与 Configuration Changes。
  2. 确认 Langfuse 端点、FILE_SCAN_ENABLED 与 HITL 开关的目标值。
  3. 升级插件守护进程与主程序,启动后检查追踪、文件扫描与审批通知。

出问题怎么排查

先看迁移日志与插件版本,再确认环境变量是否按新默认值生效;追踪不通时优先检查采集器地址与 Langfuse 端点。官方未披露更多回退步骤,保留升级前的备份是最稳的退路。

相关阅读:DeepSeek Harness 0.2.2 修复插件加载失败导致 Web 页面无法启动与端点冲突问题。

常见问题

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

搜索文章

输入关键词,快速查找标题和正文内容。