---
title: 从 v1.x 本地数据库迁移到 v2.x
description: 从 v1.x 导出数据并导入到 v2.x 云端或自托管。分步指南与故障排查。
tags:
  - LobeHub
  - 迁移
  - v1.x
  - v2.x
  - 本地数据库
  - 云端
---

# 从 v1.x 本地数据库迁移到 v2.x

LobeHub v1.x 桌面端曾提供 **本地数据库** 模式 —— 数据保存在你的设备上。自 v2.x 起，我们转向 **云端优先架构**，移除了本地数据库。带来的变化：客户端更轻量、迭代更快、在浏览器、桌面和手机间体验一致。

<Callout type="info">
  **为什么要改？** v1.x 的本地数据库占用更多系统资源，而实际使用的用户占比较小。简化客户端、聚焦云端优先后，我们可以提升整体性能并更快交付新功能。
</Callout>

本文引导你完成 **从 v1.x 导出** 和 **导入到 v2.x**。你的助理、对话和设置都可以迁移过来 —— 通常只需几分钟。

## 开始前准备

- **先不要卸载 v1.x** —— 确认迁移成功后再卸载。
- **确保网络稳定** —— 对话记录较多时，导入可能需要更长时间。
- **登录 v2.x** —— 云端版（[app.lobehub.com](https://app.lobehub.com)）或你的自托管实例。

希望自托管？先按[自托管指南](/zh/docs/self-hosting/start)部署 v2.x，再将数据导入该实例。

## 如果你已经升级到 v2.x

依然可以完成迁移。升级到 v2.x **不会删除**本地数据库文件 —— 它们会保留在磁盘上，直到你手动删除。

1. 从 [GitHub Releases](https://github.com/lobehub/lobehub/releases) 下载 **v1.x 版本**。
2. 安装并打开 v1.x，导出数据：**设置 → 数据存储 → 导出数据**。
3. 在 v2.x 中进入 **设置 → 数据存储 → 导入数据**，上传导出的文件。

### 本地数据库文件在哪里？

v1.x 本地数据库默认位于：

- **Windows：** `%APPDATA%/lobehub-storage/lobehub-local-db`
- **macOS：** `~/Library/Application Support/lobehub-storage/lobehub-local-db`

如需手动恢复数据，这些路径可能有用。

## 可以迁移的内容

根据你的 v1.x 版本和导出格式，通常可迁移：

| 项目        | 是否迁移                  |
| --------- | --------------------- |
| **助理**    | 是 —— 名称、提示词、模型设置      |
| **对话与话题** | 是 —— 消息和话题结构          |
| **提示词模板** | 是（若 v1.x 版本支持）        |
| **基础偏好**  | 是 —— 语言、主题、快捷键（若版本支持） |

## 不会迁移的内容

| 项目                | 说明                                |
| ----------------- | --------------------------------- |
| **API Key 与密钥**   | 出于安全，请在 v2.x 重新填写。v2.x 使用不同的存储方式。 |
| **仅本地的临时文件 / 缓存** | 不适用于云端的临时数据。                      |
| **设备相关设置**        | 部分设置与旧版本地环境绑定。                    |

<Callout type="warning">
  若导出文件包含敏感内容，请妥善保管，避免在公开渠道分享或提交到版本库。
</Callout>

## 第一步：在 v1.x 导出数据

在 v1.x 桌面端：

1. 进入 **设置 → 数据存储 → 导出数据**。
2. 你会得到一个 JSON 文件（例如：`2026-01-22-10-02_LobeHub-data.json`）。
3. 将文件保存到容易找到的位置 —— 桌面或专用文件夹。

![v1.x 导出数据](/blog/assets13656829368732a95940edeff9ddfca6.webp)

**提示：**

- 历史记录很多时，导出可能需要几分钟。建议在设备空闲时操作。
- 在 v2.x 中确认导入成功前，请保留该文件。

## 第二步：在 v2.x 导入数据

在任意 v2.x 应用中（桌面端、网页端或自托管）：

1. 登录你的 LobeHub 账号。
2. 进入 **设置 → 数据存储 → 导入数据**。
3. 上传第一步导出的 JSON 文件。
4. 等待导入完成。若界面未更新，可刷新页面或重启应用。

![v2.x 导入数据](/blog/assets1e640c898e897bfb4ce4b66d5377010b.webp)

**提示：**

- 导入过程中不要关闭应用或离开页面，等待完成。
- 若 v1.x 中有多个配置或空间，可分别导出并逐个导入（若版本支持）。

## 迁移后如何验收

导入完成后，建议检查：

- **助理** —— 是否齐全？提示词和配置是否正确？
- **对话** —— 近期话题和消息能否正常打开、内容是否完整？
- **设置** —— 语言、主题、快捷键是否符合预期？

如有缺失，请保留 v1.x 导出文件。升级到最新 v2.x 后再试一次导入 —— 新版本的导入逻辑可能已改进。

## 故障排查

### 导入失败或长时间卡住

- **检查网络** —— 需要稳定连接。可尝试更换网络后重试。
- **更新 v2.x** —— 使用最新版本，导入逻辑会持续优化。
- **缩小范围** —— 若有多个导出文件，可先导入较小的一个，排查是否为数据量导致的问题。

### 导入后部分数据缺失

- **不同 v1.x 版本** —— 数据结构可能略有差异。建议从你一直在用的同一 v1.x 版本重新导出。
- **多配置 / 多空间** —— 若 v1.x 中使用过多个配置或空间，可分别导出并逐个导入。

### 导出文件很大

- 对话很多时，导出文件较大是正常的。导入可能需要几分钟，请耐心等待并保持应用或标签页打开。

## 获取帮助

若遇到问题：

- [帮助与支持](/zh/docs/usage/help) —— 通用资源与社区链接
- [GitHub Issues](https://github.com/lobehub/lobehub/issues/new/choose) —— 反馈 Bug 或请求迁移帮助

反馈时请注明 v1.x 版本、v2.x 版本以及具体问题。如有可能，说明导出是否成功完成、导入在哪个环节失败。
