导读

我们提供的GeekAI 快速部署教程只针对全新安装的用户。如果你此前已经安装过 GeekAI，需要平滑升级，请按下面三步操作。从 v4.3.4 起，数据库升级统一在管理后台执行，不再使用 update-x.x.x.sql 文件。

1. 备份数据库

升级前请先备份 MySQL 数据，避免异常时无法回滚。

方式一（推荐）： 登录管理后台 → 系统设置 → 数据库维护 → 点击 备份数据库，等待完成后自动下载 SQL 文件。

方式二： 使用 mysqldump 手动导出：

# 容器部署，默认 MySQL 映射 3307 端口
docker exec geekai-mysql sh -c 'exec mysqldump -uroot -p12345678 geekai_plus' > geekai_backup_$(date +%Y%m%d).sql

2. 升级镜像并重启

修改 docker-compose.yaml 文件，将 geekai-api 和 geekai-web 的镜像版本改为目标版本（例如 v4.3.4）：

version: '3'
services:
  # mysql
  geekai-mysql:
    image: mysql:8.0.33
    container_name: geekai-mysql
    command: --default-authentication-plugin=mysql_native_password
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=12345678
    ports:
      - '3307:3306'
    volumes:
      - ./mysql/conf/my.cnf:/etc/mysql/my.cnf
      - ./mysql/data:/var/lib/mysql
      - ./mysql/logs:/var/log/mysql
      - ./mysql/init.d:/docker-entrypoint-initdb.d/

  # redis
  geekai-redis:
    image: redis:6.0.16
    restart: always
    container_name: geekai-redis
    command: redis-server --requirepass 12345678
    volumes:
      - ./redis/data:/data
    ports:
      - '6380:6379'

  # 后端 API 程序
  geekai-api:
    image: registry.cn-shenzhen.aliyuncs.com/geekmaster/geekai-plus-api:v4.3.4-amd64 # 这里修改版本号
    container_name: geekai-api
    restart: always
    depends_on:
      - geekai-mysql
      - geekai-redis
    environment:
      - APP_DEBUG=false
      - LOG_LEVEL=info
      - CONFIG_FILE=config.toml
    ports:
      - '5678:5678'
      - '6012:6012'
    volumes:
      - /usr/share/zoneinfo/Asia/Shanghai:/etc/localtime
      - ./conf/config.toml:/var/www/app/config.toml
      - ./logs:/var/www/app/logs
      - ./static:/var/www/app/static

  # 前端应用
  geekai-web:
    image: registry.cn-shenzhen.aliyuncs.com/geekmaster/geekai-plus-web:v4.3.4-amd64 # 这里修改版本号
    container_name: geekai-web
    restart: always
    depends_on:
      - geekai-api
    ports:
      - '8080:8080'
    volumes:
      - ./logs/nginx:/var/log/nginx
      - ./conf/nginx/conf.d:/etc/nginx/conf.d
      - ./conf/nginx/nginx.conf:/etc/nginx/nginx.conf
      - ./ssl:/etc/nginx/ssl

重启服务：

docker-compose down
docker-compose up -d

跨版本升级

若一次跨越多个版本（例如 v4.2.x → v4.3.4），建议依次阅读各版本的升级说明（416 → 434），了解特有配置变更。数据库迁移操作统一走管理后台，无需再手动执行历史 update-x.x.x.sql 文件（v4.3.3 起已废弃）。

3. 执行版本迁移（必做）

镜像升级并重启后，必须登录管理后台，在 系统设置 → 数据库维护 执行一次版本迁移，否则新增表、字段对齐、历史数据修复等都不会生效。

详细步骤见 安装后必做：数据库维护。

各版本特有配置变更（如 v4.3.4 人机验证、模型权限简化等），请参阅对应版本的升级页，例如 GeekAI-PLUS-v4.3.4。

4. 添加新增配置（如有）

若本次升级有新增的配置项，你可能还需要修改 conf/config.toml 文件，或在管理后台 系统设置 中补配。可通过对比项目默认配置文件，或查阅对应版本升级说明来确定。