跳到主要内容
隐界

备份、迁移与升级

数据本体就是 ./data 目录里的一个 SQLite 文件加媒体目录:备份 = 复制,迁移 = 拷到新机器,升级 = git pull 后重建容器。严谨备份用 sqlite3 的 .backup 命令,大版本升级前先备一次。

  1. 1.认清数据形态

    一切都在部署目录的 ./data 下:database.sqlite(聊天、记忆、关系、日程、笔记等全部结构化数据)加媒体文件。没有分散在别处的状态,也不依赖外部数据库。

  2. 2.备份

    最稳妥:先停服(docker compose down 或停进程)再复制整个 data 目录。不想停服的严谨做法是用 SQLite 自带的在线备份:sqlite3 database.sqlite ".backup ./backup-日期.sqlite"——比直接热拷 WAL 模式下的文件更可靠。养成大版本升级前先备份一次的习惯。

  3. 3.迁移到新机器

    在目标机器按部署文档装好但先不启动,把备份的 data 目录放回部署目录下原来的位置,再启动服务——世界、居民记忆与全部历史会原样回来。

  4. 4.升级

    git pull 拉新代码后:docker compose down → docker compose build --no-cache → docker compose up -d。数据库在 ./data 不会被清空;若旧环境曾把数据库写在 api/ 目录下,新版本启动时会自动迁移到 ./data/database.sqlite。

  5. 5.升级注意:别清空前端旧资源

    不要额外删除旧的 apps/app/dist/assets:前端懒加载 chunk 带内容哈希,已打开的旧标签页切页面时还会请求历史 chunk,保留旧文件可避免 404。另外服务端启动时会自动执行单用户世界迁移:旧库 0 个用户自动创建占位世界主人、1 个用户直接沿用、多个用户保留注册最早者(其余用户数据会被清理,不做自动合并)。

相关问题

  • 自部署的隐界怎么更新到新版本?
    用 git pull 拉取最新代码,再 docker compose up -d 重启即可滚动到新版本。CHANGELOG 会标注每个版本的破坏性变更,升级前看一眼即可。
  • 我能导出或删除我的全部数据吗?
    自部署模式下,你的全部数据就是你机器上的数据库文件和媒体目录——复制即备份,拷走即迁移,删掉即彻底删除,不存在「删不掉的副本」。云端托管账号目前没有一键导出按钮,但可以随时注销:注销后数据永久归档、不可恢复,手机号和邮箱即时释放。
  • 我的对话数据安全吗?会被用来训练吗?
    自部署模式下,你的对话只存在于你自己的硬盘,不出本机,不会被任何第三方用于训练。模型层可接 OpenAI、Anthropic 等云端 API,也可换成本地 Ollama / vLLM 完全离线运行;用哪类对话走哪个模型由你决定。
  • 隐界用什么数据库?需要我自己搭建吗?
    不需要你额外搭建。隐界自带数据库与向量索引,docker compose 起来时一并跑在你本地。文档、对话、记忆都结构化存储其中;自部署模式下这些数据只在你自己的机器上。

相关内容

返回自部署文档
分享XTelegramLINE微博
备份、迁移与升级 · 隐界 Enclave