【无标题】

原创于 2025-11-04 12:36:09 发布 · 970 阅读

11 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#dify

Dify 插件离线部署指南

本文档介绍如何在离线环境中部署 Dify 插件，包括插件下载、打包、配置和安装的完整流程。

参考文档：https://blog.csdn.net/qq_28086791/article/details/149284213

1. 下载 Dify 插件

访问 Dify 官方插件市场
找到需要的插件，进入详情页
点击右上角的"下载"按钮，将 .difypkg 文件保存到本地（例如保存在"下载"文件夹）

2. 准备打包工具

2.1 下载打包工具

# 克隆社区提供的打包工具
git clone https://github.com/junjiem/dify-plugin-repackaging.git

# 进入工具目录
cd dify-plugin-repackaging

2.2 设置执行权限

# 修改脚本为可执行文件
chmod 755 plugin_repackaging.sh
chmod 755 dify-plugin-linux-amd64-5g

2.3 准备插件文件

将第一步下载的插件文件（例如 your-plugin-name.difypkg）复制到 dify-plugin-repackaging 目录中，方便后续 Docker 操作。

3. 打包插件

3.1 执行打包命令

# 确保本地插件在 dify-plugin-repackaging/ 目录里
./plugin_repackaging.sh local ./待打包插件名.difypkg

3.2 获取离线包

命令执行成功后，会在 dify-plugin-repackaging 文件夹中生成一个新文件，文件名格式为 your-plugin-name_offline.difypkg。

这个带有 _offline 后缀的文件就是我们最终需要的离线插件包。

4. 配置内网 Dify 服务器

在上传和安装离线插件前，需要调整内网 Dify 服务器的配置，以允许上传大文件和安装非官方审核的插件。

4.1 修改配置文件

在 Dify 项目目录（与 docker-compose.yml 同级）中，找到并编辑 .env 文件，添加或修改以下配置：

# 允许安装所有未在 Dify Marketplace 上架（审核）的插件
FORCE_VERIFYING_SIGNATURE=false

# Dify 平台允许安装 500M 大小以内的插件
PLUGIN_MAX_PACKAGE_SIZE=524288000

# Nginx 客户端将允许上传 500M 大小以内的内容
NGINX_CLIENT_MAX_BODY_SIZE=500M

4.2 重启 Dify 服务

保存 .env 文件后，在 Dify 项目目录下执行以下命令，让配置生效：

sudo docker compose down
sudo docker compose up -d

5. 离线安装插件

将打包好的 _offline.difypkg 文件传输到任何一台可以访问内网 Dify 界面的电脑上
登录 Dify 系统，进入 “工具” -> “插件” 页面
点击右上角的 “+ 安装插件” 按钮
在下拉菜单中选择 “本地上传”
选择 your-plugin-name_offline.difypkg 文件并上传

安装过程会非常迅速，因为所有依赖都已包含在包内。安装成功后即可在应用中使用。

6. 常见问题

离线打包失败

如果遇到离线打包失败的问题，可以尝试以下解决方案：

升级 Python 到 3.12

如果出现类似错误；

ERROR: Could not find a version that satisfies the requirement dify_plugin==0.2.1 (from versions: 0.0.1b14, 0.0.1b15, 0.0.1b16, 0.0.1b17, 0.0.1b18, 0.0.1b19, 0.0.1b20, 0.0.1b21, 0.0.1b22)
ERROR: No matching distribution found for dify_plugin==0.2.1

解决方案：使用 python3.12 的虚拟环境

python3.12 -m venv pyenv
source ./pyenv/bin/activate

确保所有依赖项都已正确安装
检查网络连接是否正常（如果需要下载依赖）
查看错误日志，根据具体错误信息进行排查