升级 MOVO
本文适用于已经通过 Docker Compose 部署 MOVO、希望更新到新版本的管理员。首次安装请参阅快速开始。
升级前检查
- 确认当前服务状态：
./movo status。 - 备份数据库、知识文档以及其他持久化数据卷，并确认备份可恢复。
- 查看仓库中的版本说明和
.env配置。若固定了MOVO_VERSION，升级不会自动改用latest；请先确认目标镜像仓库存在所需标签。 - 如果准备切换镜像源，先确认新仓库拥有当前部署所需的全部版本标签。国内镜像源不保证与 GHCR 的标签完全一致。
不要用 up 代替升级
./movo up 只拉取本地缺少的镜像。即使使用 latest，重复运行也不保证检查并下载远端新版本。
使用启动器升级
先更新本地仓库，获取最新启动器和部署文件：
bash
git pull --ff-only使用默认 GHCR 镜像源：
bash
./movo --lang zh-CN update如果当前部署使用国内镜像源，且目标标签在该仓库中可用：
bash
./movo --lang zh-CN --mirror cn updateupdate 会检查远端镜像、拉取更新、执行所需的数据库升级，并重建受影响的容器；未变化的镜像层可以复用。它不会自动更新本地 Git 仓库，因此前面的 git pull --ff-only 不应省略。
使用原生 Compose 升级
如果部署时没有使用 ./movo 启动器，可以在确认备份和目标镜像版本后执行：
bash
docker compose pull
docker compose up -d原生 Compose 不会执行启动器的健康等待等额外步骤。若当前版本的发布说明要求数据库迁移，请先按该版本说明完成迁移，不要只运行上述两个命令。
源码开发环境
只有在开发 MOVO 源码、使用本地构建镜像时，才需要重新构建：
bash
git pull --ff-only
./movo up --build./movo update 用于预构建镜像部署，不适用于本地构建镜像模式。
升级后验证
bash
./movo status
./movo logs chat-api
./movo logs dsh-runtime-host确认服务健康后，分别验证用户端登录、管理后台、普通对话，以及企业实际使用的知识检索或插件能力。
不要删除持久化数据
./movo down -v 会删除 MOVO 的持久化数据卷和初始化状态。升级时不要执行该命令。