MengBotDocs
自托管

数据与备份

了解 MengBot 在本地存储哪些内容,以及需要保留哪些内容。

MengBot 将应用状态保存在 ~/.mengbot 下,包括配置、对话记录、消息附件、设备配对状态以及 SQLite 消息存储。

从桌面应用复制

要将你电脑上的机器人和聊天带到你运行的服务器上,请使用桌面应用:在 设置 → 服务器 中连接该服务器,然后在其所在行选择 将此计算机复制到这里(空服务器也会在其独立页面上提供该选项,其 设置 → 备份 中也有 从此计算机导入;两者都会带你到该按钮)。无需处理文件,也无需处理密码:应用会直接上传加密的工作区备份,在连接中断后从断点继续,备份服务器原有的内容(以便 换回 可以将其恢复),服务器会自行重启以安装该备份。API 密钥和登录状态保持原样;例程到达时处于暂停状态。此功能需要桌面应用通过所有者代码完成配对,而如果服务器的电子邮件登录允许你以外的人进入,则该服务器永远不会收到此备份。再次复制会替换 换回 将要恢复的备份;应用会先说明这一点。

mengbot serve、mengbot service install 以及 Docker 和 Podman 镜像会在复制后自行重新启动服务器;以其他方式启动的服务器会在下次启动时完成安装。

下方的导出和导入功能仍保留用于恢复,以及用于附近没有桌面应用的服务器。

在设置中导出和导入

打开 设置 → 备份 → 导出完整备份。选择一个至少 12 个字符的密码,并保存加密的 .ombbackup 文件。请单独保管密码:没有密码恢复功能。

备份包含此服务器工作区的机器人、线程和完整消息记录、附件、自定义头像、指令、记忆、技能及支持文件、例程和运行日志,以及非机密设置。执行导出的浏览器中的草稿和偏好设置也会包含在内。它不会收集其他浏览器未发送的草稿。

已保存的账户凭据和连接不包含在内。 请在新机器上重新连接你的账户。恢复不会覆盖目标上已存在的凭据或连接。

加密仍然很重要:对话、草稿、指令和用户文件属于私密内容,可能包含你粘贴到其中的机密信息。这些内容不会自动脱敏,因此不要将归档视为可以安全分享的内容。

如果你明确将某提供商的登录主目录放在了普通工作区文件内,请在导出或恢复前将其移入被排除的 providers/ 目录或工作区之外。应用会拒绝这种布局,而不是复制或替换其凭据。

请等待机器人、审批、提供商登录和计算机操作完成。停止会写入工作区文件的外部编辑器和托管桌面。应用会临时暂停自身的写入操作,并获取一致的 SQLite 快照。当前限制为 10 GB 工作区文件和 100,000 个条目;超出限制会明确失败,绝不会静默生成部分备份。

远程代理和隧道可能会施加更小的上传或超时限制。对于大型导入,请使用与服务器的直接连接或其本地桌面 UI,或适当配置你自己的反向代理限制。

要恢复,请选择 导入备份,选择文件,然后输入其密码。验证会在替换任何内容之前显示其日期、版本、内容和排除项。输入 REPLACE 以确认,然后完全退出并重新打开桌面应用,或重启托管服务器进程。仅关闭桌面窗口是不够的。

恢复会替换而非合并工作区数据。之前的数据保留在 .mengbot/.backups/safety-<restore-id>/ 下。失败或中断的替换会在服务器加载之前恢复之前的文件。在你检查恢复后的工作区之前,请保留该安全目录。它包含私密数据;请勿分享。

下载的文件是加密的。导入验证和恢复还会在 .backups 下创建私密的、未加密的暂存文件和安全文件。它们包含私密工作区数据,可能包含对话或文件中已存在的机密信息。请相应地保护服务器的磁盘和账户;这些恢复文件不受导出密码保护。请为暂存和之前的工作区预留额外的可用磁盘空间。

只恢复你信任的备份:指令、技能和机器人权限都包含在内。计划例程和 webhook 处于暂停状态,日历调用不会自动重新启动,未完成的委派工作不会重放。恢复后请有意审查并重新启用自动化。

旧的局部导出已不再在侧边栏中提供。现有的 .mengbackup.json 文件仍可通过 团队 作为独立副本导入。可分享的团队模板仍与完整备份分开。

工作区备份之外保留的内容

  • 外部项目目录和默认 CLI 登录主目录,例如 .claude 和 .codex。如有需要在另一台主机上重新安装提供商并重新登录。
  • 已保存的账户凭据、API 密钥、连接设置、操作系统钥匙串、浏览器登录/会话主目录以及手机配对密钥。请在新机器上登录或重新连接;目标凭据保持不变。
  • VM/容器磁盘层和远程 Boat/VPS 文件。工作区数据目录内持久挂载的文件会包含在内,但 VM 本身不会。
  • 其他集群工作区、下载的工具、缓存、运行中的进程以及活动设备会话。目标上现有的配对和服务器身份保持不变;迁移到新服务器需要与该服务器配对。

数据目录内应用拥有的路径会在导入时调整。外部路径不会被复制或重写;在计算机之间迁移时请检查它们。

文件系统级备份

在进行文件系统级备份之前,请关闭 MengBot,以便一致地捕获 SQLite 和配置文件。请保留整个 .mengbot 目录,而不是选择单个数据库文件。

原始文件系统快照与设置导出不同:它们可能包含已保存的凭据、CLI 主目录和浏览器会话。整个 /data 卷的 Docker 快照包含容器的 CLI 主目录。请将这些快照作为敏感数据保护。若要在不包含已保存凭据的情况下迁移,请改用设置导出并在新机器上重新连接账户。

在服务器停止的情况下恢复,保留原始路径和所有权,然后再次启动它。VPS 备份说明 展示了应用数据归档以及停止/启动命令。

不要随意复制机密信息

打包的桌面构建使用操作系统安全存储来保护凭据。仅复制 JSON 目录不一定能使这些凭据在其他地方可用。设置导出会有意留下已保存的凭据和连接;请在新机器上重新登录。原始文件系统快照和自动恢复安全副本必须单独保护。

一次性计算机文件系统

本地 VM 工作区是持久挂载的,但自托管 VPS 容器文件系统是有意设计为一次性的。在移除或升级容器之前,请将重要产物移动到持久工作区、仓库或已连接的应用中。

On this page