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

# 导出和导入应用

> 导出应用以备份、分享或迁移，导入应用包以创建新应用或更新已有应用

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/self-host/use-dify/workspace/export-import-apps.md)。

导出应用可留存一份副本、交给他人，或迁移到另一个 Dify 实例或工作空间。导出后会得到一个 **应用包**，也就是 `.ifpkg` 文件。

导入应用包可创建新应用，也可更新已有应用，例如换上已测试完毕、准备上线的版本。

若只是在同一工作空间内复制应用，在应用菜单中选择 **复制** 即可。

> [!NOTE]
>
> 导出和导入应用需要「编辑」及以上角色。

## 导出应用

在应用或 Agent 的卡片菜单里，或者打开后左上角的菜单里，点击 **导出应用** 或 **导出 Agent**。

对于 Workflow、Chatflow 和新 Agent，导出的是当前草稿，包括尚未发布的改动。若要导出某个已发布版本，打开 [版本历史](/zh/self-host/use-dify/build/version-control.md)，在该版本的菜单中选择 **导出应用** 或 **导出 Agent**。

其他类型的应用导出的是最近一次发布的配置。

### 导出不包含的内容

除以下内容外，构成应用的一切都会随之导出：

* 用到的集成（导入时可一键安装全部缺少的集成）
* 关联的知识库
* 工作流、Swagger API 和 MCP 工具
* Agent [文件系统](/zh/self-host/use-dify/build/new-agent/build.md#文件系统) 中的长期文件，比如它在构建模式下安装的程序
* 服务 API 密钥
* 模型和工具凭据
* 日志和标注
* 历史版本
* 集成触发器的订阅

### 选择是否导出 Secret 值

导出含有 Secret 类型环境变量的 Workflow 或 Chatflow 时，可选择是否包含这些变量的值。

> [!NOTE]
>
> 从版本历史导出时，始终不包含 Secret 值。

如需包含这些值，勾选 **导出 secret 值**。这些值会以明文写入应用包，拿到应用包的人都能看到。只有当你会像保管密钥本身一样妥善保管这个应用包时，才这样做。

如果不包含这些值，导入后这些变量为空，由导入应用的人自行填写。

## 通过导入创建新应用

在 **工作室** 或 **Agents** 中，点击 **创建** > **导入应用**。

这种方式总会创建一个新应用，它有自己的 Web 应用 URL，已有的应用不受影响。若想导入到已有的 Workflow 或 Chatflow 中，并保留其 Web 应用 URL 和 API 密钥，改为 [更新该应用](#update-an-existing-app)。

导入后，对照导出时 [未包含的内容](#what-the-export-leaves-behind)，把新应用需要的部分补上。

## 通过导入更新已有应用

在 Workflow 或 Chatflow 中，从应用左上角的菜单或画布的右键菜单中点击 **导入应用**。应用包必须导出自 Workflow 或 Chatflow，且其中的节点都能在当前应用中使用：Workflow 不能包含直接回复节点，Chatflow 不能包含输出节点或触发器节点。

导入会替换你的草稿，应用的名称、描述和图标也会一并替换。应用本身不变，日志、标注、API 密钥，以及 Web 应用和 MCP 服务的 URL 都保持原样。在你发布更新后的草稿之前，用户使用的仍是已发布的版本。

如果应用包不含 Secret 值，发布前需重新填写。

> [!WARNING]
>
> 导入的应用所带的 Web 应用设置（如标题、图标、主题色）会在导入后立即应用到线上 Web 应用，**即使你尚未发布**。
>
> 导入前，确认待导入应用的 Web 应用设置已经是用户应当看到的样子。

> [!TIP]
>
> 在 Dify Enterprise 中，你可以让应用运行在 `staging`、`production` 等彼此独立的环境中：在一个环境里测试新版本，用户则在另一个环境里继续使用稳定版本。如需了解更多，请 [联系销售](https://share-na2.hsforms.com/1O3Rajx4URXm88UzneXYpCw40s9fk)。

## 导入到早期 Dify 版本

应用包（`.ifpkg`）只能导入 Dify 1.18.0 及以上版本。若要将应用导入更早的 Dify 版本，先解压应用包（它是一个 ZIP 文件），再单独导入其中的 `app.yaml` DSL 文件。

部分配置不会随之迁移，例如 Web 应用设置和上传的图标，导入后需检查并重新设置。

> [!NOTE]
>
> 使用了 [新 Agent 节点](/zh/self-host/use-dify/nodes/agent.md#new-agent) 的工作流只能导入 Dify 1.18.0 及以上版本。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.