文档日期:2026-06-04 适用版本:Dify 1.13.3 + plugin_daemon 0.5.3-local 目标环境:离线/内网 Windows + Docker
一、概述
Dify 插件以.difypkg格式分发,本质是一个带数字签名的 ZIP 包。离线部署时需要:
下载插件源码或官方
.difypkg包收集所有 Python 依赖的 wheel 文件
使用官方
dify-pluginCLI 工具重新打包上传到内网 Dify 安装
二、准备工作
2.1 需要的工具
| 工具 | 用途 | 获取方式 |
|---|---|---|
dify-pluginCLI | 官方打包工具,生成签名 | Docker 容器内或 GitHub Release |
| Python 3.10+ | 解压/处理插件包 | 本机已安装 |
| Docker Desktop | 运行打包容器 | 本机已安装 |
2.2 需要的文件
| 文件 | 来源 | 说明 |
|---|---|---|
插件源包.difypkg | Dify 插件市场下载 | 或从 GitHub 克隆源码 |
| 依赖 wheel 文件 | PyPI 或国内镜像下载 | 所有 requirements.txt 中的依赖 |
三、离线打包完整流程
步骤 1:获取插件源包
方式 A:从 Dify 市场下载
登录 Dify → 插件市场 → 找到目标插件
点击插件详情页,下载
.difypkg文件
方式 B:从 GitHub 克隆源码
# 例如 ollama 插件 git clone https://github.com/langgenius/ollama-plugin.git
步骤 2:解压插件包(如果是 .difypkg)
# 创建解压目录 mkdir D:\plugin-work\ollama_unpack # 解压(.difypkg 本质是 ZIP) Expand-Archive -Path "D:\downloads\ollama.difypkg" -DestinationPath "D:\plugin-work\ollama_unpack"
解压后目录结构:
ollama_unpack/ ├── manifest.json ← 插件元信息(不要修改) ├── pyproject.toml ← ★ 需要修改的关键文件 ├── requirements.txt ← 依赖列表(可选) ├── _endpoint/ ← 插件代码 │ └── *.py └── wheels/ ← ★ 需要创建的目录,存放离线依赖 └── *.whl
步骤 3:收集离线依赖 wheel 文件
3.3.1 查看依赖列表
# 从 pyproject.toml 或 requirements.txt 获取 Get-Content D:\plugin-work\ollama_unpack\pyproject.toml | Select-String "dependencies"
3.3.2 下载所有 wheel 文件
方式 A:联网机器批量下载
# 创建 wheels 目录 mkdir D:\plugin-work\ollama_unpack\wheels # 使用 pip download