> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 插件

> 通过模块化组件扩展 Dify，包括自定义模型、工具和集成

插件是 Dify 连接一切的方式：模型供应商、外部 API、自定义工具。它们是扩展工作空间能力的模块化组件，只需安装一次即可在所有地方使用。

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/plugins-tab.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=68a787aac89fab8a9be8f6cd7e05ea46" alt="插件标签页" width="1051" height="478" data-path="images/use-dify/workspace/plugins-tab.png" />
</Frame>

通过工作空间中的插件选项卡访问插件管理。

## 插件工作原理

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/plugin-management.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=9f5e718986a6259c6ed1b792891d0f1d" alt="插件管理" width="3024" height="1902" data-path="images/use-dify/workspace/plugin-management.png" />
</Frame>

插件的作用域是工作空间级别的。当你安装一个插件时，工作空间中的每个应用都可以使用它。团队成员根据其角色访问插件：

<Tabs>
  <Tab title="所有者和管理员">
    为整个工作空间安装、配置和移除插件
  </Tab>

  <Tab title="编辑者和成员">
    在他们创建或编辑的应用中使用已安装的插件
  </Tab>
</Tabs>

## 安装插件

<CardGroup cols={3}>
  <Card title="市场" icon="store">
    官方和合作伙伴插件，经过测试和维护
  </Card>

  <Card title="GitHub" icon="github">
    使用 URL + 版本从任何公共仓库安装
  </Card>

  <Card title="本地上传" icon="upload">
    用于私有或内部插件的自定义 .zip 包
  </Card>
</CardGroup>

<Info>
  管理员可以限制插件安装：收窄可用的安装来源（例如仅限市场），以及允许安装的插件范围（例如仅限官方插件）。如果某个安装选项不可见，或某个插件被拦截，说明它已被策略限制。详见 [插件安装策略](/zh/3.10.x/administer/plugins-management)。
</Info>

## 插件的真正含义

将插件视为 Dify 与外部世界之间的桥梁：

<CardGroup cols={2}>
  <Card title="模型供应商" icon="microchip">
    Dify 中的每个 LLM（OpenAI、Anthropic 等）实际上都是一个插件
  </Card>

  <Card title="工具和函数" icon="wrench">
    API 调用、数据处理、计算，全部基于插件
  </Card>

  <Card title="自定义端点" icon="plug">
    将你的 Dify 应用公开为外部系统可以调用的 API
  </Card>

  <Card title="反向调用" icon="arrows-rotate">
    插件可以回调 Dify 来使用模型、工具或工作流
  </Card>
</CardGroup>

## 工作空间插件设置

在工作空间设置中控制插件权限：

<AccordionGroup>
  <Accordion title="安装权限">
    **所有人** - 任何成员都可以安装插件
    **仅管理员** - 只有工作空间管理员可以安装（推荐）
  </Accordion>

  <Accordion title="调试访问">
    **所有人** - 所有成员都可以调试插件问题
    **仅管理员** - 将调试限制为管理员
  </Accordion>

  <Accordion title="自动更新">
    选择更新策略（仅安全更新与所有更新）并指定要包含或排除的插件
  </Accordion>
</AccordionGroup>

安装后，大多数插件需要配置：API 密钥、端点或服务设置。这些设置适用于整个工作空间。

除了这些针对单个工作空间的控制项外，管理员还可设置一项安装策略，统一规定所有工作空间的成员可以安装哪些类型和来源的插件。详见 [插件安装策略](/zh/3.10.x/administer/plugins-management)。

## 构建自定义插件

当你需要自定义功能时，使用 Dify 的 SDK 开发插件：

1. 从设置 → 插件 → 调试获取调试密钥
2. 在本地构建和测试你的插件
3. 打包为包含清单和依赖项的 .zip 文件
4. 私下分发或发布到市场