导出与导入数据库

注意

本教程由社区贡献，不受 Open WebUI 团队官方维护或审核。它仅作为演示，说明如何根据你的具体场景自定义 Open WebUI。想参与贡献？请查看贡献教程。

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

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

导出数据库

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

使用 docker cp 复制数据库文件： webui.db 文件位于容器内的 /app/backend/data 目录中。运行以下命令将其复制到本地机器：
```
docker cp open-webui:/app/backend/data/webui.db ./webui.db
```
将导出的文件传输到新服务器：您可以使用 FileZilla 或任何其他文件传输工具将 webui.db 文件移动到新服务器。

信息
推荐使用 FileZilla，它在将文件传输到新服务器时操作简便。

导入数据库

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

在新服务器上安装并运行 Open WebUI：使用 Docker 容器安装并运行 Open WebUI。请按照🚀 入门指南中的说明安装并启动 Open WebUI 容器。容器启动后，在执行导入步骤之前先停止它。
```
docker stop open-webui
```
使用 docker cp 将数据库文件复制到容器中：假设导出的 webui.db 文件在当前工作目录中，将其复制到容器：
```
docker cp ./webui.db open-webui:/app/backend/data/webui.db
```
启动 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 的迁移或备份流程。请注意您使用的数据库格式，以确保兼容性。

导出数据库​

导入数据库​

注意事项​

为什么这很重要​

相关指南​

导出数据库

导入数据库

注意事项

为什么这很重要

相关指南