前言

Dify 是一个开源的 LLM 应用开发平台，支持通过插件（Plugin）扩展其功能。官方插件市场中的插件通常需要联网安装，但在某些企业或政府环境中，服务器无法访问公网，这就导致标准的插件安装流程失效。

为解决这一问题，社区贡献了一个实用工具：dify-plugin-repackaging。它允许你将插件及其所有 Python 依赖打包成一个 .zip 文件，然后在离线环境中一键安装。

一、环境准备

dify版本为：1.4.1
python版本：3.12
获取 dify-plugin-repackaging 工具

https://github.com/junjiem/dify-plugin-repackaging.git
cd dify-plugin-repackaging-main

二、重新构建插件

此次安装的插件为OpenAI-API-compatible。通过导入本地插件的方式，使用docker logs -f plugin_daemon-1这个插件容器日志，会发现报错，安装依赖的报错信息。这时候就需要重新编译打包一个完整的插件。
获取官方提供的下载地址下载：
https://marketplace.dify.ai/plugins/langgenius/openai_api_compatible?language=zh-Hans&theme=system
可选版本，此处选择版本为0.0.27
下载后上传到dify-plugin-repackaging-main目录下。

ll
总计 118084
-rw-r--r--. 1 root root 30926288  9月26日 19:21 dify-plugin-darwin-amd64
-rw-r--r--. 1 root root 29782496  9月26日 19:21 dify-plugin-darwin-arm64
-rw-r--r--. 1 root root 30400502  9月26日 19:21 dify-plugin-linux-amd64
-rwxr-xr-x. 1 root root 29411002  9月26日 19:21 dify-plugin-linux-arm64
-rw-r--r--. 1 root root     1040 12月12日 09:07 Dockerfile
drwxr-xr-x. 2 root root     4096  9月26日 19:21 images
-rw-r--r--. 1 root root   366000 12月11日 18:43 langgenius-openai_api_compatible_0.0.27.difypkg
-rw-r--r--. 1 root root     5348  9月26日 19:21 plugin_repackaging.sh
-rw-r--r--. 1 root root     4096  9月26日 19:21 README.md

执行以下命令开始重新打包插件，本机使用的是python3.12，对应dify使用的python版本。

sh plugin_repackaging.sh local langgenius-openai_api_compatible_0.0.27.difypkg
## 执行完成后会生成一个包含所有依赖的插件包：
langgenius-openai_api_compatible_0.0.27-offline.difypkg

三、安装插件

通过dify的web页面安装，
右上角插件->安装插件->本地安装。选择刚刚构建好的插件即可。

四、常见报错

本地安装插件失败处理：

• 在 .env 配置文件将 FORCE_VERIFYING_SIGNATURE 改为 false ，Dify 平台将允许安装所有未在 Dify Marketplace 上架（审核）的插件。

• 在 .env 配置文件将 PLUGIN_MAX_PACKAGE_SIZE 增大为 524288000，Dify 平台将允许安装 500M 大小以内的插件。

• 在 .env 配置文件将 NGINX_CLIENT_MAX_BODY_SIZE 增大为 500M，Nginx客户端将允许上传 500M 大小以内的内容。