跳到主要内容

Exporting & Importing DB

注意

本教程为社区贡献，Open WebUI 团队不提供官方支持。它仅作为如何针对特定用例自定义 Open WebUI 的演示。想要贡献？请查看贡献教程。

如果您需要将您的 Open WebUI 数据（例如聊天记录、配置等）从一台服务器迁移到另一台服务器，或者备份以备后用，您可以导出和导入数据库。本指南假设您使用的是内部 SQLite 数据库（而不是 PostgreSQL）来运行 Open WebUI。

请按照以下步骤导出和导入包含您数据库的 webui.db 文件。

导出数据库​

要从当前的 Open WebUI 实例中导出数据库：

  1. 使用 docker cp 复制数据库文件： webui.db 文件位于容器内的 /app/backend/data 目录中。运行以下命令将其复制到本地机器：

    docker cp open-webui:/app/backend/data/webui.db ./webui.db

  2. 将导出的文件传输到新服务器： 您可以使用 FileZilla 或您选择的任何其他文件传输工具将 webui.db 文件移动到新服务器。

    信息

    在将文件传输到新服务器时，推荐使用 FileZilla，因为它非常易于使用。

导入数据库​

将 webui.db 文件移动到新服务器后，请按照以下步骤操作：

  1. 在新服务器上安装并运行 Open WebUI： 使用 Docker 容器设置并运行 Open WebUI。按照 🚀 快速入门 中提供的说明安装并启动 Open WebUI 容器。运行起来后，在执行导入步骤之前将其停止。

    docker stop open-webui

  2. 使用 docker cp 将数据库文件复制到容器中： 假设导出的 webui.db 文件位于您当前的工作目录下，将其复制到容器中：

    docker cp ./webui.db open-webui:/app/backend/data/webui.db

  3. 启动 Open WebUI 容器： 再次启动容器以使用导入的数据库。

    docker start open-webui

    现在，新服务器上的 Open WebUI 应该已经在使用您导入的数据库运行了。

注意事项​

  • 此导出/导入过程仅在您使用内部 SQLite 数据库（webui.db）时有效。
  • 如果您使用的是外部 PostgreSQL 数据库，则此方法不适用，因为数据库是在容器外部管理的。对于 PostgreSQL，您需要遵循 PostgreSQL 特定的工具和步骤来备份和恢复您的数据库。

为什么这很重要​

这种方法在以下情况下特别有用：

  • 将您的 Open WebUI 数据迁移到新的服务器或机器。
  • 在更新或修改之前创建您的数据备份。
  • 在相同设置的多台服务器上测试 Open WebUI。

# 用于导出和导入的快速命令摘要

# 导出：
docker cp open-webui:/app/backend/data/webui.db ./webui.db

# 在新服务器上停止容器：
docker stop open-webui

# 导入：
docker cp ./webui.db open-webui:/app/backend/data/webui.db

# 启动容器：
docker start open-webui

通过这些步骤，您可以轻松管理您的 Open WebUI 迁移或备份过程。请牢记您正在使用的数据库格式以确保兼容性。

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.