Upgrade Guide

升级指南

可执行升级步骤以 后端升级手册 和当前版本 CHANGELOG.md 为准。

升级前

• 确认目标版本、破坏性变更和客户端兼容性；
• 完成 PostgreSQL 与对象存储备份，并验证备份可恢复；
• 记录当前镜像、配置、迁移版本和运行状态；
• 在测试环境先完成迁移和回滚演练。

Docker Compose 基本流程

cd imboy/deploy
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d
docker compose -f docker-compose.prod.yml ps
docker compose -f docker-compose.prod.yml logs -f imboy_backend

实际服务名、镜像名和升级顺序以当前 Compose 文件为准。不要直接执行旧版本 Wiki 中的固定镜像 tag 或数据库 SQL。

升级后验证

• 健康检查通过；
• 数据库迁移完成且无失败记录；
• REST、WebSocket、管理后台和移动端登录可用；
• 关键指标、日志和告警正常；
• 保留升级日志和回滚点。

相关入口

• 备份恢复
• 发布流程
• CHANGELOG