理解容器挂载的必要性

在成功于本地部署Dify并连接大模型后，应用本身已可运行。

然而，默认情况下，Docker容器内的数据是临时的。 这意味着一旦容器停止或重建，您在Dify平台上创建的所有工作流、知识库文档、对话应用配置等数据都将丢失。

设置容器挂载的核心目的，正是为了解决数据持久化问题。通过将容器内的特定目录映射到宿主机的物理路径，可以确保应用数据独立于容器的生命周期而存在。

这样一来，在升级、重启或迁移服务时，关键数据也能得以完好保存。

配置Docker Compose挂载卷

对于通过Docker Compose方式部署的Dify，数据持久化主要通过修改项目根目录下的 `docker-compose.yaml` 文件实现。

您需要找到定义 `api` 和 `worker` 服务的部分，在其中添加或修改 `volumes` 字段。

一个典型的配置方式，是将容器内的 `/app/api/storage` 和 `/app/worker/storage` 目录，分别挂载到宿主机上的自定义路径。

例如，可以添加类似 `- ./storage:/app/api/storage` 的条目。这里的 `./storage` 是相对于Compose文件所在目录的宿主机路径，冒号后则是容器内的目标路径。

修改后保存文件，此配置将在下次启动时生效。

选择与准备宿主机挂载路径

在编辑Compose文件前，需要先规划好宿主机上的存储位置。

建议选择一个有足够磁盘空间且权限合适的目录。例如，可以在Dify项目同级目录下创建 `data` 文件夹，并在其下建立 `api_storage` 和 `worker_storage` 子目录，以对应不同服务。

需要确保Docker守护进程（通常以`root`或`docker`用户组运行）对该路径拥有读写权限。

在Linux系统上，可能需要使用 `chmod` 或 `chown` 命令调整目录权限，以避免容器启动时因权限不足而报错。

清晰的目录结构有助于后续的备份和维护工作。

准备路径时重点关注

• 磁盘空间是否充足
• 目录权限是否正确
• 目录结构是否清晰，便于备份与维护

执行挂载与验证数据持久性

完成Docker Compose文件的编辑和宿主机目录准备后，需要在项目目录下执行 `docker-compose down` 命令停止现有服务。

随后，使用 `docker-compose up -d` 重新启动。

启动后，可以进入容器内部，或直接在宿主机挂载点查看文件是否生成。

例如，在Dify网页界面创建一个新的应用程序或上传一个知识库文件，随后检查宿主机对应的挂载目录中是否出现了相关数据文件。

最后，可以通过执行 `docker-compose restart` 来重启服务，验证重启后刚才创建的应用和数据是否依然存在。

这是确认挂载设置成功、数据持久化生效的关键步骤。

验证流程可按以下顺序进行

• 执行 `docker-compose down` 停止现有服务
• 执行 `docker-compose up -d` 重新启动
• 在Dify中创建应用或上传知识库文件
• 检查宿主机挂载目录是否生成对应数据文件
• 执行 `docker-compose restart` 后再次确认数据是否仍然存在

挂载配置的进阶考量与排错

基本的挂载配置能满足多数需求，但在复杂场景下可能需要更多考量。

例如，如果宿主机使用NFS或SSD云盘等网络或块存储，需确保其可用性和性能。

另外，应注意避免挂载路径冲突，不要将多个容器或同一容器的不同服务指向宿主机同一子目录。

若启动后应用报错或数据未成功写入，应首先检查Docker Compose文件的语法是否正确，尤其是缩进和冒号的使用。

其次，通过 `docker logs <容器名>` 查看服务日志，排查权限或路径错误。

最后，确认宿主机磁盘空间是否充足。

妥善的挂载设置是保障Dify长期稳定运行的基础。

常见排查方向

• 检查Docker Compose文件语法是否正确
• 重点确认缩进和冒号使用是否规范
• 使用 `docker logs <容器名>` 查看服务日志
• 检查宿主机目录权限和路径是否配置正确
• 确认宿主机磁盘空间是否充足

《夸克》非常好用的免费AI浏览器

下载APP查看