Docker 部署

本页用于处理 Docker Compose 部署细节：安装 Docker、手动拉取项目、ARM 服务器、社区版和二开镜像。全新用户建议先走快速部署，本页用于补充特殊场景。

安装 Docker

GeekAI-Plus 推荐使用 Docker Compose 部署。先确认服务器已安装 Docker 和 Docker Compose：

docker --version
docker compose version

Ubuntu 在线安装

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg -y
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

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
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

CentOS / Rocky Linux 安装

sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine -y
sudo yum install -y yum-utils git
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
sudo systemctl enable --now docker

手动部署 Plus 版

使用源码交付时提供的仓库地址拉取部署仓库：

git clone <你的 GeekAI Plus 仓库地址> geekai-plus
cd geekai-plus

启动服务：

docker compose up -d

首次启动会拉取 MySQL、Redis、API、Web 等镜像，完成后访问：

入口	地址
前端	`http://服务器IP:8080/chat`
后台	`http://服务器IP:8080/admin`
移动端	`http://服务器IP:8080/mobile`

使用部署配置中的管理员账号登录，首次进入后立即修改初始密码，并执行安装后必做：数据库维护。

ARM 服务器

GeekAI-Plus 镜像按架构区分。若服务器是 ARM 架构，把 docker-compose.yaml 中的 API 和 Web 镜像后缀从 amd64 改为 arm64：

image: registry.cn-shenzhen.aliyuncs.com/geekmaster/geekai-plus-api:v4.3.5-arm64
image: registry.cn-shenzhen.aliyuncs.com/geekmaster/geekai-plus-web:v4.3.5-arm64

保存后重新启动：

docker compose down
docker compose up -d

部署社区版

社区版是开源版本，适合学习、研究和二次开发：

git clone https://github.com/yangjian102621/geekai.git

进入项目自带部署目录后启动：

cd geekai/deploy
docker compose up -d

社区版和 Plus 版的授权、镜像、功能边界不同。部署前请先确认你要使用的版本，避免把社区版配置误套到 Plus 版。

部署二开镜像

如果你已经基于源码做了二次开发，建议把后端和前端分别打成自己的镜像，再替换 docker-compose.yaml 里的镜像地址：

services:
  geekai-api:
    image: your-registry/geekai-plus-api:v4.3.5-amd64

  geekai-web:
    image: your-registry/geekai-plus-web:v4.3.5-amd64

镜像构建流程见开发和构建。

启动后检查

docker compose ps
docker compose logs -f geekai-api
docker compose logs -f geekai-web

容器显示 Up 不代表业务已经完全可用。首次启动 MySQL、Redis、API 和 Web 会相互等待，建议等待 30 秒到 2 分钟再访问后台。

如果访问失败，先看常见错误，再检查服务器防火墙和云厂商安全组是否放行 8080 端口。