GeekAI 用户手册GeekAI 用户手册
  • 指南

    • 产品介绍
    • 快速部署
    • 进阶部署
  • 配置

    • API令牌配置
    • 用户管理
    • AI 模型配置
    • AI 应用管理
    • 函数插件配置
    • MidJourney 绘图配置
    • 支付配置
    • Gitee模力方舟接入
    • 其他服务配置
    • 文件存储配置
    • 内容审查配置
    • 即梦AI配置
    • 短信邮件配置
    • 运营策略
  • 升级

    • 平滑升级
  • 开发

    • 开发和构建
    • 如何跳过 License 验证
  • 指南

    • 产品介绍
    • 部署
  • 配置

    • Coze 智能体
    • Dify 智能体
    • 阿里云百炼智能体
  • 升级

    • Geek-Agent v1.0.2
    • Geek-Agent v1.0.3
    • Geek-Agent v1.0.4
    • Geek-Agent v1.0.5
  • GeekAI-PLUS(不带管理后台)
  • GeekAI-PLUS(带管理后台)
  • GeekAI-Agent(不带管理后台)
  • GeekAI-Agent(带管理后台)
  • AI 学习笔记

    • 01-Stable-Diffusion基本知识概论
    • 02-DeepSeek R1 的核心技术解密
    • 03-DeepSeek R1 使用指南(持续更新)
    • 03-关于 AI Agent 的一些个人思考
    • 04-搞懂 MCP 和 A2A 协议
  • 极客学长博客
  • 需求/Bug 反馈
  • 技术交流群
  • GitHub
  • Gitee
  • GitCode
  • 简体中文
  • en-US
GitHub
  • 指南

    • 产品介绍
    • 快速部署
    • 进阶部署
  • 配置

    • API令牌配置
    • 用户管理
    • AI 模型配置
    • AI 应用管理
    • 函数插件配置
    • MidJourney 绘图配置
    • 支付配置
    • Gitee模力方舟接入
    • 其他服务配置
    • 文件存储配置
    • 内容审查配置
    • 即梦AI配置
    • 短信邮件配置
    • 运营策略
  • 升级

    • 平滑升级
  • 开发

    • 开发和构建
    • 如何跳过 License 验证
  • 指南

    • 产品介绍
    • 部署
  • 配置

    • Coze 智能体
    • Dify 智能体
    • 阿里云百炼智能体
  • 升级

    • Geek-Agent v1.0.2
    • Geek-Agent v1.0.3
    • Geek-Agent v1.0.4
    • Geek-Agent v1.0.5
  • GeekAI-PLUS(不带管理后台)
  • GeekAI-PLUS(带管理后台)
  • GeekAI-Agent(不带管理后台)
  • GeekAI-Agent(带管理后台)
  • AI 学习笔记

    • 01-Stable-Diffusion基本知识概论
    • 02-DeepSeek R1 的核心技术解密
    • 03-DeepSeek R1 使用指南(持续更新)
    • 03-关于 AI Agent 的一些个人思考
    • 04-搞懂 MCP 和 A2A 协议
  • 极客学长博客
  • 需求/Bug 反馈
  • 技术交流群
  • GitHub
  • Gitee
  • GitCode
  • 简体中文
  • en-US
GitHub
  • GeekAI-Plus

    • 产品介绍
    • 快速部署
    • 进阶部署
    • Window 系统部署
    • 使用宝塔部署
    • 常见错误
  • 配置

    • API令牌配置
    • Gitee模力方舟接入
    • 用户管理
    • AI 模型配置
    • AI 应用管理
    • 函数插件配置
    • MidJourney 绘图配置
    • AI 绘图配置
    • AI 视频配置
    • Suno 生成音乐
    • PPT 生成配置
    • 文件存储配置
    • 支付配置
    • 插件配置
    • 短信邮件配置
    • 内容审查配置
    • 即梦AI配置
    • 其他服务配置
    • 运营策略
  • 升级

    • 平滑升级
    • GeekAI-PLUS-v4.1.6
    • GeekAI-PLUS-v4.1.8
    • GeekAI-PLUS-v4.1.9
    • GeekAI-PLUS-v4.2.1
    • GeekAI-PLUS-v4.2.2
    • GeekAI-PLUS-v4.2.3
    • GeekAI-PLUS-v4.2.4
    • GeekAI-PLUS-v4.2.5
    • GeekAI-PLUS-v4.2.6
    • GeekAI-PLUS-v4.2.7
    • GeekAI-PLUS-v4.2.8
    • GeekAI-PLUS-v4.2.9
    • GeekAI-PLUS-v4.3.0
    • GeekAI-PLUS-v4.3.3
    • GeekAI-PLUS-v4.3.4
  • 开发

    • 开发和构建
    • 如何跳过 License 验证

更新内容

  • 功能新增:管理后台数据迁移支持 SSE 五步迁移向导,自动对齐 Schema、清理废弃表与多余列,并移除服务启动时的自动迁移,运维升级更可控
  • 功能新增:管理后台数据库备份支持异步全库导出与 SSE 逐表进度展示,迁移页一键备份并自动下载 SQL 文件
  • 功能新增:任务失败重试与退款追踪,生图、视频、Suno、MJ、即梦等任务支持失败后重新入队,并记录退款时间便于核对算力退还
  • 功能新增:算力不足通知通过 WebSocket 实时推送,避免用户在长时间任务中才发现余额不足
  • 功能优化:即梦任务提交对齐 price_key 计价键,提示词输入组件重构,复杂任务扣费更准确
  • 功能重构:人机验证改为 go-captcha 本地生成与 Redis 校验,不再依赖外部验证码 API Key
  • 功能重构:聊天模型权限移除开放标记、标签字段与用户级模型白名单,启用模型对所有用户可见,简化配置与迁移逻辑
  • 功能优化:管理后台配置页重构基础、插件、算力等设置布局;示例数据库配置密钥统一脱敏,降低开源仓库泄露风险

升级前注意(必读)

重要变更

从 v4.3.4 起,服务启动时不再自动执行数据库迁移。升级镜像后,你必须登录管理后台,在 系统设置 → 数据迁移 页面手动执行迁移,否则新增表、字段对齐、历史数据修复等都不会生效。

建议在升级前完成 MySQL 全量备份;v4.3.4 起也可在管理后台 数据迁移 页一键导出全库 SQL 作为备份。

更新镜像版本

你直接编辑 docker-compose.yaml,修改 geekai-api 和 geekai-web 镜像版本为 v4.3.4 即可。

# 后端 API 程序
geekai-api:
  image: registry.cn-shenzhen.aliyuncs.com/geekmaster/geekai-plus-api:v4.3.4-amd64
  container_name: geekai-api
  restart: always
  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
    - ./res/sd:/var/www/app/res/sd
    - ./certs:/var/www/app/certs
    - ./data:/var/www/app/data
  environment:
    - APP_DEBUG=false
    - LOG_LEVEL=info
    - CONFIG_FILE=config.toml

# 前端应用
geekai-web:
  image: registry.cn-shenzhen.aliyuncs.com/geekmaster/geekai-plus-web:v4.3.4-amd64
  container_name: geekai-web
  restart: always
  ports:
    - '9004: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

1. 执行数据迁移(必做)

升级镜像并重启后,按以下步骤完成数据库迁移:

  1. 登录管理后台,进入 系统设置 → 数据迁移(路径:/admin/config/migration)。
  2. 点击 备份数据库,等待 SSE 进度完成后自动下载 SQL 文件,妥善保管。
  3. 点击 开始迁移,按五步向导依次执行:
    • 正在迁移数据表
    • 正在合并数据
    • 正在迁移数据
    • 正在对齐字段
    • 正在修复数据
  4. 观察下方 操作日志,全部步骤显示完成后即可正常使用。

数据迁移页面

提示

迁移步骤设计为幂等,可安全重复执行;已完成的项会自动跳过。若迁移过程中报错,请先查看日志,修复问题后再次点击「开始迁移」即可。

2. 人机验证变更

人机验证已切换为 go-captcha 本地生成,验证码图片与校验结果存储在 Redis 中,不再需要配置外部验证码服务的 API Key。

人机验证页面

在 系统设置 → 基础配置 中可开启「启用行为验证码」,并选择 点选验证码 或 滑动验证码 两种类型。

3. 聊天模型权限简化

管理后台 聊天模型 配置已简化:

  • 移除模型的 开放标记、标签 等字段
  • 移除用户级 模型白名单 限制
  • 所有 已启用 的聊天模型对所有用户可见

若你此前依赖「开放模型 / 白名单」做差异化权限,升级后需改用其他运营手段(如会员等级、算力门槛等)。

4. 任务失败重试

生图、视频、Suno、MidJourney、即梦等异步任务在 失败 后支持 重试:

  • 失败任务若已自动退还算力,重试时会 补扣积分 后重新入队
  • 若尚未退款,重试 不会重复扣费
  • 管理端与用户端均可查看 refunded_at 退款时间,便于核对算力流水

5. 算力不足实时通知

用户在提交生图、视频、音乐等长时间任务时,若算力不足,系统会通过 WebSocket 实时推送通知,无需等到任务轮询失败才发现余额问题。

6. 管理后台配置页调整

系统设置 菜单结构有所调整,主要变化:

菜单项路径说明
基础配置/admin/config/basic站点信息、验证码、AI 辅助模型等
算力配置/admin/config/power各模块算力消耗
插件配置/admin/config/plugin第三方插件
数据迁移/admin/config/migration数据库备份与迁移(新增)

升级后若找不到原有配置入口,可在 系统设置 子菜单中按上表查找。

在 GitHub 上编辑此页
上次更新: 2026/6/28 11:23
贡献者: RockYang
Prev
GeekAI-PLUS-v4.3.3
极客学长 © 2022-2026 版权所有 粤ICP备19122051号-1