Docker方式安装

通过Docker一键部署FastBuildAI

环境准备

服务器/本地配置要求：

  • 2核CPU
  • 4GB内存
  • ≥5GB 磁盘空间

在使用Docker部署FastBuildAI之前，请确保您的系统已经安装了以下软件：

您可以通过以下命令检查它们是否已正确安装：

# 检查 Docker 版本
docker --version

# 检查 Docker Compose 版本
docker compose version

部署步骤

1. 获取代码

# Github
git clone https://github.com/FastbuildAI/FastbuildAI.git

# Gitee
git clone https://gitee.com/FastbuildAI/FastBuildAI.git

2. 配置环境变量

在运行 Docker 命令前，首先需要配置环境变量。请确保项目根目录下存在 .env.production.local 文件。您可以从示例文件复制并修改：

# 进入项目根目录
cd FastBuildAI

# 复制环境变量配置文件
cp .env.production.local.example .env.production.local

然后根据您的需求编辑 .env.production.local 文件。如果本地部署且无特殊需求，则无需修改，如果需要部署到线上环境，则需要配置前端接口域名 VITE_APP_BASE_URL。

主要配置项包括：

  • 数据库连接信息
  • API密钥和安全设置
  • 网络和端口配置

3. 启动服务

完成环境变量配置后，在项目根目录执行以下命令启动所有服务：

docker compose -p fastbuildai --env-file ./.env.production.local -f ./docker/docker-compose.yml up -d

这个命令会：

  • 使用 -p fastbuildai 参数指定项目名称
  • 通过 --env-file ./.env.production.local 加载环境变量配置
  • 使用 -f ./docker/docker-compose.yml 指定 Docker Compose 配置文件
  • 通过 up -d 在后台启动所有服务

配置说明

Docker Compose 配置

./docker/docker-compose.yml 文件定义了 FastBuildAI 所需的所有服务容器。默认配置已经能满足大多数使用场景，但您也可以根据需要进行自定义。

服务管理

查看运行状态

docker compose -p fastbuildai -f ./docker/docker-compose.yml ps

查看服务日志

# 查看所有服务的日志
docker compose -p fastbuildai -f ./docker/docker-compose.yml logs

# 查看特定服务的日志（例如 api 服务）
docker compose -p fastbuildai -f ./docker/docker-compose.yml logs api

# 实时查看日志
docker compose -p fastbuildai -f ./docker/docker-compose.yml logs -f

停止服务

docker compose -p fastbuildai -f ./docker/docker-compose.yml down

重启服务

docker compose -p fastbuildai -f ./docker/docker-compose.yml restart

数据持久化

FastBuildAI 的数据默认存储在 Docker 卷中，确保数据在容器重启后不会丢失。主要的数据卷包括：

  • 数据库数据
  • 上传的文件和资源
  • 配置文件

常见问题

端口冲突

如果遇到端口冲突问题，可以修改 .env.production.local 文件中的端口配置，然后重新启动服务。

容器无法启动

请检查：

  1. Docker 服务是否正常运行
  2. 环境变量文件是否正确配置
  3. 查看容器日志获取详细错误信息： 
    docker compose -p fastbuildai -f ./docker/docker-compose.yml logs

性能优化

对于生产环境，建议根据服务器配置调整容器资源限制，可以在 docker-compose.yml 文件中设置 CPU 和内存限制。

升级指南

当有新版本发布时，可以按照以下步骤进行升级：

  1. 拉取最新代码
  2. 停止当前运行的容器
  3. 使用新的 Docker Compose 文件启动服务
# 停止当前服务
docker compose -p fastbuildai -f ./docker/docker-compose.yml down

# 拉取最新镜像
docker compose -p fastbuildai -f ./docker/docker-compose.yml pull

# 启动新版本服务
docker compose -p fastbuildai --env-file ./.env.production.local -f ./docker/docker-compose.yml up -d