更新内容
- 功能新增:管理后台数据迁移支持 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 -d1. 执行数据迁移(必做)
升级镜像并重启后,按以下步骤完成数据库迁移:
- 登录管理后台,进入 系统设置 → 数据迁移(路径:
/admin/config/migration)。 - 点击 备份数据库,等待 SSE 进度完成后自动下载 SQL 文件,妥善保管。
- 点击 开始迁移,按五步向导依次执行:
- 正在迁移数据表
- 正在合并数据
- 正在迁移数据
- 正在对齐字段
- 正在修复数据
- 观察下方 操作日志,全部步骤显示完成后即可正常使用。

提示
迁移步骤设计为幂等,可安全重复执行;已完成的项会自动跳过。若迁移过程中报错,请先查看日志,修复问题后再次点击「开始迁移」即可。
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 | 数据库备份与迁移(新增) |
升级后若找不到原有配置入口,可在 系统设置 子菜单中按上表查找。
