最新 Dify 1.14.0+ 内网离线插件打包、部署完整踩坑方案(解决 uv.lock 依赖校验失败)

文章目录

一、背景说明

我真的服了,搞了好几天,差点崩溃。终于解决了较新版本Dify的离线插件打包和安装的问题。

早期打包脚本(即网上90%的资料都说的打包插件Dify-plugin-repacking)产出的离线插件包,在旧版 Dify 上可以正常安装使用。

但 Dify 新版本(应该是1.10.0之后),不知道为什么,官方引入了uv包管理器,新增了uv.lock锁严格冻结依赖校验机制,老方式打包出来的离线包直接安装会报错,无法正常使用。具体表现就是,依旧会联网搜索依赖,尽管该依赖早已经离线下载好。

经过多方面的搜索以及调研,终于在Github找到了解决办法,生成真正适配内网、不联网的离线插件包。

⚠️ 适用版本:Dify 1.10.0之后,私有化内网离线场景,无外网,无法在线拉取 Python 依赖

二、Dify 环境变量配置

打开 Dify 根目录下的 .env 文件,追加下面配置:

bash 复制代码
# ===== 离线插件专项配置 =====
# 跳过 uv.lock --frozen 严格校验,优先使用插件包内预先打包好的本地wheels离线解析依赖
PLUGIN_IGNORE_UV_LOCK=true
# 关闭插件签名校验,允许安装未上架官方市场、自己打包的私有插件包
FORCE_VERIFYING_SIGNATURE=false
# 插件包最大限制:500MB,适配MinerU、文档解析等依赖较多的重型插件
PLUGIN_MAX_PACKAGE_SIZE=524288000
# 配套Nginx上传限制,和上面插件大小保持一致,避免上传413 Request Entity Too Large
NGINX_CLIENT_MAX_BODY_SIZE=500M

重点坑点:docker compose restart 不会重新加载 .env 环境变量!

restart 只是重启容器,不会重新读取 env 文件,必须使用 --force-recreate 重建容器才能加载新变量

执行重建 plugin-daemon 命令:

bash 复制代码
docker compose up -d --force-recreate plugin_daemon

三、下载插件

提前去dify官方提供的插件市场下载所需插件:点击前往插件市场

下载好的插件后缀为 difypkg

四、离线重打包工具

该工具专门用来重新处理 difypkg 插件包,自动预下载所有依赖 whl,打包进插件内部,同时处理uv.lock锁,实现纯离线安装,部署时不再访问外网 pip 源

bash 复制代码
git clone https://github.com/kurokobo/dify-plugin-offline-packager.git

切换目录

bash 复制代码
cd dify-plugin-repackaging-python

同时给打包工具赋权

bash 复制代码
chmod 755 ./bin/dify-plugin-cli-0.6.1-linux-amd64

将需要打包的插件放入到difypkg目录下,执行命令打包。其中langgenius-agent_0.0.51.difypkg替换为需要打包的插件名称

bash 复制代码
docker compose run --rm packager --local "difypkg/langgenius-agent_0.0.51.difypkg"

等待打包,出现成功字样即可。生成的文件在difypkg目录下,以offline.difypkg结尾

在Dify页面上选择本地插件安装即可

相关推荐
飞奔的瓜牛4 小时前
CentOS 7 系统优化实战指南:从内核参数到服务精简
linux·运维·centos
无足鸟ICT19 小时前
【RHCA+】sosreport(收集诊断文档)
linux·运维·服务器
IT大白鼠19 小时前
当 AI 开始自动化渗透:FBI ARTEX 警报的防守对策
运维·人工智能·自动化
wflynn19 小时前
Google 观察到首个全自动化网络攻击,AI 框架已能独立完成漏洞利用
ai·技术
Decay__20 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构
A-刘晨阳20 小时前
K8S 二进制集群搭建(一主两从)v1.37.2 版本
运维·云原生·容器·kubernetes·calico·nerdctl
tonydf20 小时前
没完了,Nginx又报新漏洞!
运维·nginx
zdr尽职尽责20 小时前
终端工具凭空消失:Codex + GPT-6 的一次完整排障复盘
数据库·gpt·学习·ai
瑞雪兆丰年兮1 天前
Linux零基础快速入门-第二章 Linux基础命令
linux·运维·服务器
lambo mercy1 天前
01初识docker
运维·docker·容器