企业官网建设流程全解析

Metapi 数据备份与恢复完全指南：导入导出、数据迁移不丢任何配置

【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点， 汇聚成 一个 API Key、一个入口，自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/gh_mirrors/meta/metapi

Metapi 是一个多站点 API 聚合网关，能把 New API、One API、DoneHub、Veloera、AnyRouter、Sub2API 等站点汇聚成一个 API Key、一个入口，自动发现模型并智能路由。当你注册了十几个站点、配好了令牌、路由和下游 Key 后，最怕的就是丢配置。本文带你用 Metapi 内置的导入/导出功能，三步完成数据备份，换机、迁移、重装时一条配置都不丢 🛡️

一、Metapi 会帮你备份哪些数据？

在开始之前，先了解备份文件里到底有什么。Metapi 的备份分为两大分区：

当前备份格式为Schema v2.1（见 backupService.ts），向后兼容旧版本结构，也兼容 ALL-API-Hub 导出的备份文件。

⚠️ 备份文件包含站点凭证等敏感数据，请离线保管，不要提交到 Git 或上传到公共网盘。

二、一键导出：三种备份方式怎么选？

方式 1：应用内 JSON 导出（最常用 ✅）

进入管理后台 → 左侧菜单「导入/导出」页面（页面源码：ImportExport.tsx），提供三个粒度：

• 导出全部（连接 + 路由 + 策略 + 设置）——迁移、换机首选
• 仅导出连接与路由策略——只备份站点和账号配置
• 仅导出系统设置——只备份偏好配置

点击后自动生成带日期的 JSON 文件（如metapi-backup-2026-02-28.json），直接下载到本地。

方式 2：WebDAV 自动同步（忘记备份也不怕）

同一页面下方有WebDAV 同步卡片，填入 WebDAV 文件的 URL、用户名、密码后，可以：

1. 立即导出到 WebDAV/从 WebDAV 拉取——手动推、拉
2. 开启自动同步并填写 Cron 表达式（默认0 */6 * * *，即每 6 小时自动备份一次）

页面会实时显示「上次同步时间」和「最近错误」，同步是否健康一目了然。适合长期运行的服务器部署。

方式 3：目录级 / 数据库级备份（最彻底）

• SQLite / Desktop：直接复制data/数据目录即可，恢复时换回去再重启
• MySQL / PostgreSQL：用mysqldump/pg_dump做库级备份，或使用云数据库的自动快照

详细命令见官方运维文档 operations.md。升级版本、执行「重新初始化系统」之前，强烈建议先做一次这类全量备份。

三、数据恢复：4 步安全还原全部配置

第 1 步：进入「导入/导出」页面

在管理后台左侧菜单点击导入/导出，进入右侧「导入数据」卡片。

第 2 步：拖入或粘贴备份文件

支持两种方式：

• 把 JSON 备份文件拖拽到虚线上传区
• 点击选择文件，或直接粘贴 JSON 文本到「数据预览」框

第 3 步：确认数据预览

系统会自动校验数据完整性，并显示解析摘要：备份版本、时间、包含的分区，以及站点 / 账号 / 令牌 / 路由 / 下游 Key / 设置的数量统计。只有结构有效时「导入」按钮才会点亮，避免误操作 🚦

第 4 步：确认导入

点击导入，系统提示会明确说明覆盖范围：

导入会覆盖备份中的连接/路由/策略配置或系统设置，但会保留本机日志、公告、缓存和统计。

导入完成后弹出明细，例如「导入完成：连接与路由策略；站点 12 / 账号 20 / API Key 连接 24 / 跳过 0」，让你清楚知道每一条配置都落位了。

四、从 ALL-API-Hub 迁移：无需手动逐项配置

如果你之前用的是 ALL-API-Hub，好消息是：Metapi原生兼容其导出的备份文件，直接把 ALL-API-Hub 的 V2 备份拖进导入区即可。系统会离线迁移可用连接（账号、独立 API 凭据等），并明确告诉你哪些字段不会被原生导入。导入后个别账号令牌可能过期，在账号列表点击「重新绑定」按提示重新获取 Access Token 或 Cookie 即可。

五、恢复安全须知（重要 ⚠️）

1. 管理员令牌不会被导入：为防止覆盖后锁死管理界面，auth_token与运行库连接配置（db_type/db_url/db_ssl）在备份中会被自动排除（逻辑见 backupService.ts）
2. 先备份再导入：任何导入都是覆盖式操作，建议先导出一份当前「全部备份」再执行导入
3. WebDAV 配置未保存时，导入/导出按钮会被禁用，先保存配置再操作
4. 数据库级恢复后记得重启 Metapi，确认它重新连接到了正确的运行库

小结

Metapi 的数据备份体系可以概括为三句话：日常靠 WebDAV 定时自动同步，重要操作前做一次 JSON 全量导出，换库时再做目录级或库级备份。恢复时只需拖入文件、核对预览、点击导入，站点、凭证、路由、下游 Key 与系统设置全部原样还原。

相关文档延伸阅读：

• 运维与备份恢复：docs/operations.md
• 快速上手与迁移提示：docs/getting-started.md

【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点， 汇聚成 一个 API Key、一个入口，自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/gh_mirrors/meta/metapi