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

Metapi 数据备份与恢复完全指南导入导出、数据迁移不丢任何配置【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点 汇聚成 一个 API Key、一个入口自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/gh_mirrors/meta/metapiMetapi 是一个多站点 API 聚合网关能把 New API、One API、DoneHub、Veloera、AnyRouter、Sub2API 等站点汇聚成一个 API Key、一个入口自动发现模型并智能路由。当你注册了十几个站点、配好了令牌、路由和下游 Key 后最怕的就是丢配置。本文带你用 Metapi 内置的导入/导出功能三步完成数据备份换机、迁移、重装时一条配置都不丢 ️一、Metapi 会帮你备份哪些数据在开始之前先了解备份文件里到底有什么。Metapi 的备份分为两大分区分区包含内容连接与路由策略站点、账号凭证、API Key 连接、令牌、路由与通道、站点禁用模型、手工添加的模型、下游 API Key 的限额/权重/排除规则系统设置全局设置、通知配置、代理传输、签到开关等偏好项当前备份格式为Schema v2.1见 backupService.ts向后兼容旧版本结构也兼容 ALL-API-Hub 导出的备份文件。⚠️ 备份文件包含站点凭证等敏感数据请离线保管不要提交到 Git 或上传到公共网盘。二、一键导出三种备份方式怎么选方式 1应用内 JSON 导出最常用 ✅进入管理后台 → 左侧菜单「导入/导出」页面页面源码ImportExport.tsx提供三个粒度导出全部连接 路由 策略 设置——迁移、换机首选仅导出连接与路由策略——只备份站点和账号配置仅导出系统设置——只备份偏好配置点击后自动生成带日期的 JSON 文件如metapi-backup-2026-02-28.json直接下载到本地。方式 2WebDAV 自动同步忘记备份也不怕同一页面下方有WebDAV 同步卡片填入 WebDAV 文件的 URL、用户名、密码后可以立即导出到 WebDAV/从 WebDAV 拉取——手动推、拉开启自动同步并填写 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 即可。五、恢复安全须知重要 ⚠️管理员令牌不会被导入为防止覆盖后锁死管理界面auth_token与运行库连接配置db_type/db_url/db_ssl在备份中会被自动排除逻辑见 backupService.ts先备份再导入任何导入都是覆盖式操作建议先导出一份当前「全部备份」再执行导入WebDAV 配置未保存时导入/导出按钮会被禁用先保存配置再操作数据库级恢复后记得重启 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考