安装后必做：数据库维护

适用场景

GeekAI Plus v4.3.4 起不再在服务启动时自动迁移数据库。新安装、升级镜像或拉取新版源码后，都必须手动执行一次版本迁移。

前置条件

  • API、Web、MySQL 和 Redis 均已启动。
  • 管理后台可以访问。
  • 升级现有站点时，先完成 MySQL 备份。

后台入口

进入 系统设置 → 数据库维护（/admin/config/migration）。

数据库维护页面

操作步骤

  1. 登录管理后台。
  2. 打开 系统设置 → 数据库维护。
  3. 现有生产站先点击 备份数据库，下载并离线保存 SQL。备份包含用户与配置等敏感数据。
  4. 点击 开始版本迁移。
  5. 等待五个阶段执行完毕，不要关闭页面或重启容器。
  6. 查看操作日志，确认没有失败项。
  7. 刷新仪表盘，再继续配置 API-KEY 和模型。

页面还提供数据库恢复。恢复会覆盖当前库全部数据，只能在明确需要回滚且已确认备份文件时使用。

验证方法

  • 仪表盘不再提示需要迁移。
  • 后台各配置页能正常打开。
  • 日志中没有 Unknown column、Table doesn't exist 或迁移失败。

常见错误

  • 迁移按钮无响应：检查 API 容器日志和反向代理是否支持 SSE。
  • 执行中断：先修复数据库连接或权限，再重复执行；迁移设计为可安全重试。
  • 升级后页面空白：确认 Web 与 API 使用同一版本，并重新执行版本迁移。