Dify 於二零二六年十一月十八日發布 1.20.0,把應用與代理的執行追蹤匯出至任意 OpenTelemetry 收集器,並在知識庫檔案索引前加入惡意程式掃描。此版同時把人工審批接入電子郵件與五種通訊平台,開放個人存取權杖呼叫 OpenAPI,環境檔與公開網址設定需要一併搬移。

上一版 1.19.0 於十一月四日發布,兩次版本相隔十四日。專案目前累積十六萬顆星標、二萬五千個分支與一千六百三十五位貢獻者,最近七日提交三百零七次,未結議題一千四百三十五個,屬於長週期專案中節奏偏快的一段。專案的基本架構與適用場景,可先參考早前的 Dify 平台介紹。

Dify 儲存庫 README 開頭畫面,顯示專案標誌、Docker 下載量與貢獻者健康度徽章,以及指向雲端版本與自架安裝文件的多語言入口

Dify 1.20.0 帶來哪些改動?

主軸為追蹤匯出任意後端、知識庫檔案掃毒、人工審批接入通訊平台與個人存取權杖,另附 GitHub 知識源樹狀選取與介面搜尋改動,屬需要協調升級的版本。

官方發布說明把改動分成新功能與修正兩層。新功能集中在四處:追蹤匯出改走標準協定、知識庫上傳加入掃描、人工審批改為共用頻道派送、OpenAPI 開放個人權杖。修正層面則涵蓋檔案預覽沙箱、OAuth 回呼重用、成員角色權限與向量刪除範圍。

版本節奏值得留意。1.18.0 於十月二十三日發布,1.19.0 於十一月四日發布,1.20.0 於十一月十八日發布,三次相隔分別為十二日與十四日。這種密度對自架團隊意味著每兩週就要評估一次升級窗口,而本次涉及環境檔改名與六個資料庫遷移,窗口內必須一次完成。

執行追蹤為何要改走 OpenTelemetry?

過去每個觀測平台需獨立整合,換工具等於改設定。新版以 OTLP/HTTP 輸出,任何相容收集器都能接收,同時支援 Langfuse 第四版。

追蹤資料的價值取決於能否與其他系統並排查看。過去 Dify 為每個觀測供應商維護一條整合路徑,團隊換平台時要重新設定目的地、憑證與欄位對應。1.20.0 加入 OpenTelemetry 供應商,把應用與代理的執行追蹤以標準格式輸出到任何相容收集器,工作流步驟、模型呼叫與工具活動可以放在同一個檢視內。

此版同時處理一個外部期限。Langfuse 雲端於二零二六年十一月十六日退役舊有寫入端點,自架第四版亦拒絕舊格式事件,既有 Langfuse 設定在升級後才能繼續投遞。官方說明舊設定仍然可用,但需搭配 1.20.0 之後的版本。

限制需要先看清楚。傳輸只支援 OTLP/HTTP 搭配 protobuf,gRPC 不在支援範圍;代理工具的即時活動需要串流輸出,緩衝輸出路徑不提供,而且歷史對話不會重播工具卡片。

人工審批如何接入團隊通訊工具?

新版把審批請求派送到電子郵件與 Slack、飛書、Teams、釘釘、企業微信,收件人共用一份聯絡人清單,審批可在訊息卡片或驗證表單完成,預設啟用。

人工介入節點原本只有站內表單一種形態,實務上等於要求審批人登入系統。新版把請求送到團隊既有的通訊工具,並把收件人抽成獨立聯絡人清單,工作流設定一次即可在不同節點重複使用,亦可指定發起人、臨時電郵或動態收件人。

派送與審批分為兩段。通知以範本加上工作流變數組成主旨與內文,收件人可直接在支援的訊息卡片內回覆,或開啟獨立表單並以 Dify 登入或電郵驗證身分。系統同時提供測試通知與投遞紀錄,方便排查沒有送達的請求。

部署層面有三個連帶要求。反向代理需要把 /callbacks/human-input/v2/im/ 轉發到 API 服務並保留原始主體與簽章標頭,內建 nginx 範本已包含此規則;Celery 需要新增 human_input_delivery 與 human_input_contact_sync 兩條佇列;對外可達的 TRIGGER_URL 必須設定為公開 HTTPS 來源,否則回呼無法生成。全域等待上限預設七天,逾時後工作流不會無限期暫停。

知識庫檔案為何要先掃毒?

上傳檔案在抽取與索引前先經掃描,支援 Cloudmersive、Scanii、OPSWAT 與自訂端點。掃描器不可用或檔案無法檢視時預設攔截,並在文件清單顯示原因。

知識庫是外部檔案的入口,一旦索引完成,惡意內容就進入檢索範圍。1.20.0 在抽取與索引之前插入掃描步驟,部署層由 FILE_SCAN_ENABLED 全域開啟,每個知識庫再自行選擇掃描器與後備行為,涵蓋傳統知識庫、RAG 管線的本機檔案來源與代理知識庫上傳三條路徑。

預設值偏向保守。掃描器暫時不可達與檔案無法掃描兩種情況都預設攔截,避免在服務異常時放行未檢查內容。逾時為三百秒、最多重試三次,同一份內容與同一掃描器的乾淨判定可重用二十四小時,降低重複上傳的成本。

這項功能預設關閉,理由是掃描需要外送檔案內容到第三方服務。對處理客戶資料的團隊而言,啟用前應先確認掃描商的資料保留政策與地區,必要時改用自訂端點接入內部掃描服務。

個人存取權杖改變哪些自動化流程?

腳本與 CI 可在帳號頁建立權杖,限定工作區與資源範圍並設定到期日,毋須共用主控台工作階段。同版把 OpenAPI 端點預設開啟。

過去若要讓腳本呼叫 Dify 的 OpenAPI,常見做法是借用主控台工作階段或建立額外帳號,權限界線模糊。1.20.0 在帳號頁加入個人存取權杖,可限定適用的工作區與資源範圍、設定到期日、隨需求調整範圍或即時撤銷。

配套改動是 OPENAPI_ENABLED 的預設值由關閉改為開啟。這讓權杖與 difyctl 開箱可用,同時意味著升級後對外介面預設多了一組端點,管理員應在升級前確認反向代理層的存取控制。權杖依賴 SECRET_KEY,多個 API 副本必須使用同一個值,否則簽發與驗證會不一致。

Dify 的數據表現如何?

星標 161,433、分支 25,524、貢獻者 1,635 位,最近七日提交 307 次,未結議題 1,435 個,主要語言 Python。

161,433Stars
25,524Forks
1,635貢獻者
307近七日提交
1,435未結議題
14版本間隔日數

Dify 儲存庫首頁頂部,顯示 langgenius/dify 專案名稱、公開狀態、Star 十六萬與 Fork 二萬五千的統計,以及 Python 語言與授權標示

專案自二零二三年四月建立,兩年半累積十六萬顆星標。分支數維持在二萬五千以上,說明大量團隊把 Dify 當作出發點,分支之後的修改集中在自家模型供應商、自家工具與合規要求。未結議題一千四百三十五個,對照一週三百零七次提交,議題處理壓力仍然存在。

Dify 儲存庫貢獻者與提交活躍度頁面,顯示每週提交曲線與主要貢獻者排名,反映專案近期的開發節奏

比較三次發布的間隔可以看到節奏變化。1.17.1 於九月十日發布,之後進入約六週的穩定期;由 1.18.0 開始改為兩週一次,且每次均帶資料庫遷移。對自架團隊而言,這種節奏已接近「必須設專人跟進」的門檻。

從 1.19 升級需要處理哪些設定改動?

共通環境檔 shared.env 不再載入,內容須移至 api-worker.env;公開網址改由 urls.env 管理;另加兩條佇列與一條回呼路由,六個遷移一次套用。

環境檔的搬移是本次升級最容易出錯的一步。docker/envs/core-services/shared.env 不再被載入,共通設定必須在重建容器之前移到 api-worker.env;若兩個檔案同時存在,只補充缺少的項目並保留既有值,包括刻意留空的指派。

公開網址改為集中管理。新增的 urls.defaults 與選用的 urls.env 收攏 CONSOLE_API_URL、CONSOLE_WEB_URL、SERVICE_API_URL、APP_API_URL 與 APP_WEB_URL,設定時不帶 /console/api、/api 或 /v1 後綴。根目錄 .env 仍然優先,這也順帶修好新安裝時圖示連結指向本機位址的問題。

資料層面,從 1.19.0 升級會套用六個遷移版本,終點由 53c10126d551 推進到 f8b6e2c4a901,涵蓋人工審批同步紀錄、個人存取權杖、檔案掃描政策與評估框架。評估功能的遷移同樣會套用到社群版,即使社群版不顯示該功能,遷移鏈必須完整執行。

執行次序建議為:先備份資料庫、向量資料、上傳檔案與環境檔,再遷移環境檔與網址設定,補上佇列與回呼路由,最後以 docker compose up -d 重建服務讓初始化腳本執行。單純重啟不會重新載入環境檔,這一點在過去版本已經造成不少誤判。

安全修補涵蓋哪些範圍?

檔案預覽改為沙箱內嵌 SVG 並驗證簽章,OAuth 回呼禁止重用,成員角色權限收緊,向量刪除限定目標資料集,另升級壓縮庫修補 CVE-2026-116591。

檔案層面的兩項修正直接影響資料外洩風險。內嵌 SVG 預覽改在沙箱執行,避免腳本在主控台來源下運行;過期檔案連結續期前會先驗證原始簽章,防止以舊連結換取新的有效憑證。

權限層面收緊了三處。OAuth 回呼不得重複使用,成員角色權限在關鍵操作上強制檢查,向量刪除限定於目標資料集而不再跨越範圍。公開串流中的節點重試細節亦被遮蔽,避免洩漏內部錯誤訊息與堆疊。

同類供應鏈風險已有前例。Brotli 解壓漏洞 在十月影響 Node.js 與 Python 的預設解壓路徑,處理方式與本次相同:先確認相依版本,再安排重建。

依賴層面,代理執行環境的壓縮庫升級以修補 CVE-2026-116591,執行映像的 Node.js 更新至安全版本 24.22.3。穩定性修正同時處理 Redis BRPOP 空轉、插件升級檢查併發上限與 Chatflow 串流未關閉導致的重連預算耗盡。

出處連結有哪些?

原始碼位於 GitHub 的 langgenius/dify 儲存庫,1.20.0 發布頁含亮點、設定變更、資料庫遷移與升級指南四段,並附拉取請求編號供追溯。

專案位址為 https://github.com/langgenius/dify,1.20.0 的發布頁分為新功能、設定與整合變更、資料庫遷移、升級指南四段,另附環境變數對照表與 OpenShell 部署的獨立章節。官方文件站 docs.dify.ai 提供自架安裝、模型供應商與工作流節點說明,繁簡中文版本均在儲存庫內同步維護。

本文數據取自儲存庫公開統計與 1.20.0 發布說明,時間為二零二六年十一月十八日。版本之間的差異以發布頁所列拉取請求為準,實際行為仍需在測試環境驗證。

總結:Dify 1.20.0 值得升級嗎?

值得升級,前提是安排一次協調窗口。標準追蹤匯出與檔案掃描直接補上觀測與合規缺口,但環境檔改名、公開網址集中與六個遷移要求一次完成。

1.20.0 的四組改動回應四個實際痛點:追蹤綁定單一供應商、知識庫缺少入口檢查、審批要人手登入、腳本沒有獨立憑證。其中 OpenTelemetry 匯出與檔案掃描的完成度較高,可以立即投入使用;人工審批需要外部可達的回呼網址,屬於有條件可用。

升級判斷可以簡化為兩個問題:團隊能否在一個維護窗口內同步更新所有元件與六個資料庫遷移,以及是否已核對反向代理的新路由與 OpenAPI 的預設開啟。兩項都成立時,1.20.0 帶來的觀測標準化與檔案防護值得投入;任何一項不成立,先補齊環境會比急著升級更有效率。