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
  • 开发

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

版本更新

当前 GeekAI-Plus 最新版本是 v4.3.3,更新内容如下:

  • 功能新增:视频生成新增 Vidu、Happyhorse 等多厂商适配器,并统一 Relay、DashScope 公共客户端,视频创作可接入更多模型服务
  • 功能新增:生图管理后台新增图片配置与任务管理页面,支持后台查看、配置和删除生图任务,降低运营排查成本
  • 功能优化:即梦 AI支持多维度 price_key 算力定价,前后端按模型、能力和参数精确计算积分,避免复杂任务计费不一致
  • 功能优化:视频与生图创作统一参数配置、算力计算和移动端体验,任务创建、扣费和展示逻辑更一致
  • 功能优化:任务管理支持失败视频任务重新入队,已完成或失败任务可删除,用户和管理员处理异常任务更方便
  • 功能优化:PPT 生成补强幻灯片蒙版编辑、参考图和配图流程,提升演示文稿生成后的可编辑性
  • 功能重构:清理历史归档 SQL 文件,保留当前 geekai_plus.sql 作为数据库基线,减少部署和维护时的版本干扰
  • Bug修复:移除提示词生成接口的 30 秒限流,避免连续生成提示词时被误拦截
  • 功能新增:用户资源库支持统一上传、AI 任务产出自动归档、资源弹窗选择与批量删除,用户可集中管理生成和上传的文件
  • 功能新增:PPT 生成支持分镜草稿 SSE 流式生成、文件提炼实况面板与失败降级,生成过程更可见,长任务等待体验更稳定
  • 功能优化:PPT 图片生成链路对齐统一图片 API,补充草稿创建、算力检查、确认生成与管理端配置,降低不同生成入口的配置割裂
  • 功能优化:Sora 计费方式调整,视频生成算力扣费规则与新任务流程保持一致
  • 功能优化:管理后台支持对话、图像、Suno、视频、PPT 等任务记录批量删除,并优化任务页、审核、订单、兑换和侧栏等管理体验
  • 功能重构:统一 异步任务状态 常量与迁移逻辑,图像、视频、音乐、PPT 等生成任务在前后端使用一致的状态枚举
  • 功能重构:下线 智能体 App 类型 相关接口、页面与路由,收敛 Chat Apps 与移动端入口,减少运维和管理端配置负担
  • 功能优化:重构 管理后台外壳与主题变量,统一侧栏、标签、主题 SCSS 与常用管理视图样式,提升后台视觉一致性

国际服务器

国内服务器部署的话,域名需要备案才能解析访问。域名的备案程序有点复杂,你懂的。如果你不想备案的话,可以把系统部署在境外服务器。 不过很多境外服务器国内访问超级慢,我测试了比较多的服务器厂商 CloudDone 这家延时比较低,1GiB 的大带宽,国内访问还是比较流畅的。

一键自动部署

我们提供了 geekai-plus 的一键部署脚本,你只需要在服务器上运行以下命令即可完成部署。

curl -fsSL https://img.r9it.com/geekai/geekai-install.sh -o geekai-install.sh && chmod +x geekai-install.sh && sudo ./geekai-install.sh

安装 Docker

我们推荐统一使用容器搭建运行环境,所以你得先安装好 docker 和 docker-compose,如果你本机已经安装好 docker 和 docker-compose 了请跳过此步骤。

Ubuntu 在线安装

  1. 添加 docker 的软件源,复制下面脚本在终端运行。

    # Add Docker's official GPG key:
    sudo apt-get update
    sudo apt-get install ca-certificates curl gnupg
    sudo install -m 0755 -d /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
    sudo chmod a+r /etc/apt/keyrings/docker.gpg
    
    # Add the repository to Apt sources:
    echo \
    "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
    "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
    sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    sudo apt-get update
  2. 安装 docker 和 docker-compose

    sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-compose -y

Ubuntu 离线安装

近期 docker 相关的官方服务访问都受限,所以在安装的过程中很可能出现某个软件下载时速度非常缓慢,甚至下载失败的情况。 如果遇到这种情况你可以尝试使用我提供的离线安装包来安装。(PS:目前进适合 Ubuntu-22.04 系统)

百度网盘下载链接 提取码: agvf

下载成功之后执行安装脚本:

sudo sh install.sh

Centos 在线安装

  1. 移除本机自带的 docker

    sudo yum remove docker \
                        docker-client \
                        docker-client-latest \
                        docker-common \
                        docker-latest \
                        docker-latest-logrotate \
                        docker-logrotate \
                        docker-engine -y
  2. 添加软件源

    sudo yum install -y yum-utils
    sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
  3. 安装 docker 和 docker-compose shell sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-compose 其他操作系统请参考官方的安装教程:https://docs.docker.com/engine/install/。 下面我们将演示如何运行这些容器。这里我们假设你的所有 docker 容器都运行在 /opt/GeekAI 目录下。

视频部署教程

如果你比较喜欢通过视频来学习部署,请直接观看 GeekAI Plus 最新部署教程。

部署社区版

先克隆项目:

git clone https://github.com/yangjian102621/geekai.git
# 如果无法访问 github 可以使用码云的地址
git clone https://gitee.com/blackfox/geekai.git

启动项目

cd deploy #切换到 `deploy` 目录
docker-compose up -d

部署 Plus 版本

首先,为了能克隆 GeekAI 项目,你需要先安装 git 工具,如果已经安装了请跳过此步骤。

# ubuntu 安装 git
sudo apt-get install git -y
# centos 安装 git
sudo yum install git -y

然后,克隆项目:

git clone https://github.com/yangjian102621/geekai-plus.git
# 如果无法访问 github 可以使用码云的地址
git clone https://gitee.com/blackfox/geekai-plus-open.git

默认是拉取的 X86_AMD64 的 docker 镜像,如果你的是 ARM 架构, 那请修改 docker-compose.yaml 文件,修改 geekai-api 和 geekai-web 的镜像名称。

  • geekai-plus-api:v4.0.8-amd64 修改成 geekai-plus-api:v4.0.8-arm64
  • geekai-plus-web:v4.0.8-amd64 修改成 geekai-plus-web:v4.0.8-arm64

部署二开版本

如果你自己进行了二次开发,想部署自己开发的版本,那么只需要将自己的二开版本打包成镜像,然后把上述的镜像地址改成自己的打包的。详细的构建和打包流程,请参考 GeekAI 开发构建。

启动项目

docker-compose up -d

等所有的镜像都启动完成了,就会输出类似下面的日志:

Status: Downloaded newer image for registry.cn-shenzhen.aliyuncs.com/geekmaster/geekai-plus-web:v4.0.9-amd64
Creating geekai-mysql ... done
Creating geekai-redis ... done
Creating geekai-api   ... done
Creating geekai-web   ... done

提示:

容器启动完成并不代表启动成功了,由于一键部署脚本要启动 6 个容器,容器之间还有依赖关系,所以中途会经过多次重启才会正常运行。 首次启动成功之后请耐心等待 30 秒-2 分钟再访问系统。

然后你就可以访问以下地址

  • 前端访问地址:http://localhost:8080/chat  使用移动设备访问会自动跳转到移动端页面。
  • 后台管理地址:http://localhost:8080/admin
  • 移动端地址:http://localhost:8080/mobile
  • 初始后台管理账号:admin/admin123
  • 初始前端体验账号:18888888888/12345678

注意,服务启动成功之后不能立刻使用,需要先 添加 API KEY。

在 GitHub 上编辑此页
上次更新: 2026/5/24 21:35
贡献者: RockYang, GeekMaster, Cursor
Prev
产品介绍
Next
进阶部署
极客学长 © 2022-2026 版权所有 粤ICP备19122051号-1