1.认清数据形态
一切都在部署目录的 ./data 下:database.sqlite(聊天、记忆、关系、日程、笔记等全部结构化数据)加媒体文件。没有分散在别处的状态,也不依赖外部数据库。
2.备份
最稳妥:先停服(docker compose down 或停进程)再复制整个 data 目录。不想停服的严谨做法是用 SQLite 自带的在线备份:sqlite3 database.sqlite ".backup ./backup-日期.sqlite"——比直接热拷 WAL 模式下的文件更可靠。养成大版本升级前先备份一次的习惯。
3.迁移到新机器
在目标机器按部署文档装好但先不启动,把备份的 data 目录放回部署目录下原来的位置,再启动服务——世界、居民记忆与全部历史会原样回来。
4.升级
git pull 拉新代码后:docker compose down → docker compose build --no-cache → docker compose up -d。数据库在 ./data 不会被清空;若旧环境曾把数据库写在 api/ 目录下,新版本启动时会自动迁移到 ./data/database.sqlite。
5.升级注意:别清空前端旧资源
不要额外删除旧的 apps/app/dist/assets:前端懒加载 chunk 带内容哈希,已打开的旧标签页切页面时还会请求历史 chunk,保留旧文件可避免 404。另外服务端启动时会自动执行单用户世界迁移:旧库 0 个用户自动创建占位世界主人、1 个用户直接沿用、多个用户保留注册最早者(其余用户数据会被清理,不做自动合并)。
相关问题
自部署的隐界怎么更新到新版本?
用 git pull 拉取最新代码,再 docker compose up -d 重启即可滚动到新版本。CHANGELOG 会标注每个版本的破坏性变更,升级前看一眼即可。我能导出或删除我的全部数据吗?
自部署模式下,你的全部数据就是你机器上的数据库文件和媒体目录——复制即备份,拷走即迁移,删掉即彻底删除,不存在「删不掉的副本」。云端托管账号目前没有一键导出按钮,但可以随时注销:注销后数据永久归档、不可恢复,手机号和邮箱即时释放。我的对话数据安全吗?会被用来训练吗?
自部署模式下,你的对话只存在于你自己的硬盘,不出本机,不会被任何第三方用于训练。模型层可接 OpenAI、Anthropic 等云端 API,也可换成本地 Ollama / vLLM 完全离线运行;用哪类对话走哪个模型由你决定。隐界用什么数据库?需要我自己搭建吗?
不需要你额外搭建。隐界自带数据库与向量索引,docker compose 起来时一并跑在你本地。文档、对话、记忆都结构化存储其中;自部署模式下这些数据只在你自己的机器上。