如何把 Agent Zero 从 v1.20 升级到 v2.0并把旧数据恢复到新实例【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero如果你的 Agent Zero 实例还运行在 v1.20想升级到 v2.0 并保留聊天记录、项目、记忆、设置和自定义插件需要走 Docker 镜像更新路径从旧实例导出一份备份 zip拉取 v2.0 镜像启动一个新容器再把备份恢复进新实例。本文适用于通过 Docker Desktop、Docker CLI 或 Agent Zero Launcher 管理容器的场景。为什么不能直接用内置 Self Update 完成这次升级Agent Zero 的内置 Self Update 只允许在同一主版本线内更新。v2.0 开启了一个新的主版本线所以在 v1.20 实例里打开Settings UI → Update → Self Update时更新检查器可以看到 v2.x 这条新线但不会在现有的 v1 Docker 镜像内应用这次跨主版本跳转。UI 会显示一个提示横幅把用户引导到 Docker 更新指南。主版本线升级要求下载新的 Docker 镜像因为 v2.0 可能包含仓库 checkout 之外的操作系统级变更或其他破坏性变更。这也是为什么文档把 v1.20 → v2.0 的安全路径定义为四步从旧 v1.20 实例创建备份 zip拉取agent0ai/agent-zero:latest镜像在 v2.0 发布时latest就是 v2.0 镜像用该镜像启动一个新容器把备份 zip 恢复进新的 v2.0 实例。使用 Docker CLI 或 Docker Desktop 完成升级这是文档给出的主路径适合直接用 Docker 管理 Agent Zero 的用户。第一步在旧实例创建备份打开旧 v1.20 实例的 Web UI进入Settings - Check for Updates - Backup Restore - Create Backup创建备份并保留下载到的.zip文件。这个 zip 包含/a0/usr下的用户数据是后面恢复的唯一数据来源升级过程中不要删除它。第二步拉取 v2.0 镜像在 Docker CLI 中执行docker pull agent0ai/agent-zero:latest如果习惯图形界面也可以在 Docker Desktop 中搜索agent0ai/agent-zero:latest并拉取该镜像。第三步在独立端口启动新的 v2.0 容器docker run -d -p 50081:80 --name agent-zero-v2 -v a0_v2_usr:/a0/usr agent0ai/agent-zero:latest把新容器映射到 50081 这个不同的宿主机端口是为了让旧 v1.20 实例在对比验证期间继续可用。a0_v2_usr是新容器专属的命名卷只映射/a0/usr这个用户数据目录。第四步在新实例中恢复备份打开新的 v2.0 实例完成首次启动提示后进入Settings - Check for Updates - Backup Restore - Restore Backup把第一步下载的.zip恢复进去。第五步验证后再清理旧容器在新 v2.0 实例中逐项检查聊天记录、项目、记忆、设置和自定义插件是否都在。确认无误后再删除旧的 v1.20 容器。文档特别提醒不要在新容器拥有你的数据之前删除旧容器。升级完成后的 Self Update 面板会显示当前的 v2.0 状态如文档中的示例截图所示可选路径使用 Agent Zero Launcher 完成同样的升级如果你平时用 Agent Zero Launcher 管理实例同一条备份/恢复思路在Instances页面完成不必敲 Docker 命令打开Instances选中旧的 v1.20 实例使用Backup/a0/usr下载备份打开Installs使用latest卡片点击Install或Run启动镜像v2.0 发布时 latest 即 v2.0 镜像回到Instances选中新的 v2.0 实例使用Restore/a0/usr恢复刚才的备份 zip打开新实例并验证数据再删除或停止旧的 v1.20 容器。Launcher 会把新旧实例分开显示便于在清理前对比两者。限制与常见问题不要把整个旧/a0目录 bind-mount 进新容器来解决 v1.20 → v2.0 跳转。/a0里包含应用代码混合旧根目录和新镜像会破坏系统文件。正确做法是用户数据只保留在/a0/usr走备份/恢复流程让新镜像提供 v2.0 的系统文件。安装指南中也有同样的警示不要映射整个/a0目录它包含应用代码并可能破坏升级。新实例无法加载设置时文档在手动更新一节给出的处理方式是移除/a0/usr/settings.json并重启容器让系统重新生成默认设置。同一主版本线内的日常更新仍然走 Web UI 的 Self Update更新器会自动管理a0/usr备份更新失败健康检查不通过时自动回滚到之前的 checkout。跨主版本的 v1.20 → v2.0 不在它的适用范围内。完成标志升级完成的判断标准来自文档本身新 v2.0 实例里的 chats、projects、memory、settings 和 custom plugins 都已恢复可用。此后旧 v1.20 容器可以删除日常更新回到 Web UI 的Settings UI → Update → Self Update路径。更多更新机制细节见 Self Update 文档完整命令上下文见 安装指南 的 Updating from v1.20 to v2.0 小节和 Launcher 指南。【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考