无网 Dify 服务器离线安装插件
无网 Dify 服务器离线安装插件:OpenAI-API-compatible 0.0.27(langgenius/openai_api_compatible)
零、准备离线打包工具(先拉代码并本地解压部署)
本方案依赖工具仓库:dify-plugin-repackaging(用于从 Marketplace/GitHub 下载插件并重新打包为离线包)。
0.1 方式 A:git 拉取(网络正常时推荐)
git clone https://github.com/junjiem/dify-plugin-repackaging.git
cd dify-plugin-repackaging
如果遇到报错(示例:curl 16 / HTTP2 framing layer),可先禁用 HTTP2 再重试:
git config --global http.version HTTP/1.1
git clone https://github.com/junjiem/dify-plugin-repackaging.git
0.2 方式 B:下载 ZIP 并解压(克隆不稳定时推荐)
1)在浏览器打开仓库页面,下载 ZIP(例如 dify-plugin-repackaging-main.zip)
2)在本地解压并进入目录:
mkdir -p ~/dify-plugin && cd ~/dify-plugin
unzip dify-plugin-repackaging-main.zip
cd dify-plugin-repackaging-main
进入目录后,确保存在这些文件:
- Dockerfile
- plugin_repackaging.sh
- dify-plugin-linux-amd64(或你系统对应的平台二进制)
并给脚本加执行权限:
chmod +x plugin_repackaging.sh
一、在有网机器生成离线包(推荐)
1)准备工具目录
进入你已经下载/解压的 dify-plugin-repackaging-main(包含 Dockerfile / plugin_repackaging.sh 的目录):
cd dify-plugin-repackaging-main
chmod +x plugin_repackaging.sh
2)构建打包镜像(只需一次)
docker build -t dify-plugin-repackaging .
3)打包 OpenAI-API-compatible 0.0.27 为离线包
无网服务器若是 linux/amd64(大多数情况),用这个平台参数:
docker run --rm -v $(pwd):/app dify-plugin-repackaging
./plugin_repackaging.sh -p manylinux_2_17_x86_64 market langgenius openai_api_compatible 0.0.27
执行完成后检查产物:
ls -lh *openai* *.difypkg
你要找并使用带 -offline 的那个,例如:
- langgenius-openai_api_compatible_0.0.27-offline.difypkg ← 用这个
- langgenius-openai_api_compatible_0.0.27.difypkg ← 通常不适合无网
二、把离线包拷贝到无网 Dify 服务器
scp langgenius-openai_api_compatible_0.0.27-offline.difypkg dp@<server_ip>:/tmp/
SFTP上传(或用 U 盘 / 内网共享介质拷贝)
三、无网 Dify 服务器安装前检查(避免上传失败)
1)确认 .env 放开限制(重要)
在 Dify 的 docker compose 目录(有 .env 和 docker-compose.yml)确认如下配置:
FORCE_VERIFYING_SIGNATURE=false
PLUGIN_MAX_PACKAGE_SIZE=524288000
NGINX_CLIENT_MAX_BODY_SIZE=500M
重点:PLUGIN_MAX_PACKAGE_SIZE 不要是 52428800(50MB),否则大包会上传失败。
2)重启 plugin-daemon
docker compose restart plugin_daemon
3)验证环境变量是否生效(以你的容器名为准)
docker exec -it dify_docker_new-plugin_daemon-1 /bin/sh -lc
'env | grep -E "FORCE_VERIFYING_SIGNATURE|PLUGIN_MAX_PACKAGE_SIZE|NGINX_CLIENT_MAX_BODY_SIZE"'
四、Dify 控制台本地安装插件
- 进入 Dify:Plugins / 插件管理
- 如果已经装过但失败,建议先卸载旧的 OpenAI-API-compatible(确认版本 0.0.27)
- 点击 Local Package File / 本地插件包
- 上传:langgenius-openai_api_compatible_0.0.27-offline.difypkg
- 安装完成后启用
五、安装后验证是否真正“跑起来”
1)检查 plugin-daemon 日志是否还在反复 init failed
docker logs --since 30m dify_docker_new-plugin_daemon-1 | egrep -n "openai_api_compatible|init environment failed|has exited|started|Installed tool"
正常情况应当看到类似:
- new plugin logged in: langgenius/openai_api_compatible:0.0.27
- plugin … started
并且不再出现:
- init environment failed: failed to install dependencies …
六、如果仍然失败(无网常见两类原因)
1)装的不是 *-offline.difypkg
解决:重新确认文件名,必须是 -offline 版本。
2)平台参数打错(例如服务器是 arm64,你打成 x86_64)
解决:在有网机重新打包,arm64 使用:
-p manylinux_2_17_aarch64










