Dify 插件守护进程

概述

Dify 插件守护进程是一个管理插件生命周期的服务。它负责管理三种类型的运行时：

1. 本地运行时：运行在与 Dify 服务器相同的机器上。
2. 调试运行时：监听一个端口，等待调试插件连接。
3. 无服务器运行时：运行在如 AWS Lambda 这样的无服务器平台上。

Dify API 服务器将与守护进程通信，以获取所有插件的状态，例如哪个插件安装在哪个工作区，并接收来自 Dify API 服务器的请求，以调用插件，如无服务器函数。

所有来自 Dify API 的请求都基于 HTTP 协议，但根据运行时类型，守护进程将以不同的方式将请求转发到相应的运行时。

• 对于本地运行时，守护进程将插件作为子进程启动，并通过 STDIN/STDOUT 与插件通信。
• 对于调试运行时，守护进程等待插件连接并以全双工方式通信，基于 TCP。
• 对于无服务器运行时，插件将被打包到如 AWS Lambda 这样的第三方服务中，然后由守护进程通过 HTTP 协议调用。

有关 Dify 插件的更详细介绍，请参阅我们的文档 https://docs.dify.ai/plugins/introduction。

CLI

提供了一个 CLI 工具，用于在本地环境中进行插件开发。

• 通过 brew 安装

支持 Linux 和 MacOS，无论是 arm64 还是 amd64 架构。

1. 点击 Homebrew tap for Dify CLI
2. 使用 brew 安装 Dify cli

brew tap langgenius/dify
brew install dify

• 使用二进制文件安装

从 发布页面 的资产列表中下载二进制文件。

开发

运行守护进程

首先将 .env.example 文件复制为 .env，并设置正确的环境变量，如 DB_HOST 等。

cp .env.example .env

注意 PYTHON_INTERPRETER_PATH 是 Python 解释器的路径，请根据您的 Python 安装指定正确的路径，并确保 Python 版本为 3.11 或更高，因为 dify-plugin-sdk 有此要求。

我们建议您使用 vscode 来调试守护进程，.vscode 目录中提供了一个 launch.json 文件。

Python 环境

UV

守护进程使用 uv 来管理插件的依赖关系，在启动守护进程之前，您需要自行安装 uv。

解释器

您的机器上可能安装了多个 Python 版本，提供了一个变量 PYTHON_INTERPRETER_PATH 来为您指定 Python 解释器路径。

部署

目前，守护进程仅支持 Linux 和 MacOS，Windows 需要大量适配，如果您需要，欢迎贡献代码。

Docker

注意： 由于守护进程依赖于共享的 cwd 目录来运行插件，因此不建议使用基于网络的卷或从主机外部绑定的挂载。这可能会导致性能不佳，例如插件无法及时启动。

使用 docker 卷与主机共享目录，以获得更好的性能。

Kubernetes

目前，Daemon 社区版不支持平滑扩展副本数量，如果您对此功能感兴趣，请联系我们。我们为企业用户提供了更生产就绪的版本。

基准测试

请参阅 基准测试

许可证

Dify 插件守护进程根据 Apache-2.0 许可证 发布。