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 在后台启动所有服务

拉取完所有镜像之后，需要2-5分钟等待项目构建完成（个别情况可能因网络原因导致时间较长），具体进度可以查看nodejs服务日志。

当日志出现 ➜ Local: http://localhost:4090⁠ 等字样，则表示项目构建完成。

本地部署访问地址：http://localhost:4090，初始默认管理账号：admin/FastbuildAI&123456

⚠️ 如果线上生产环境部署，请及时修改账号密码

常见问题

端口冲突

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

容器无法启动

请检查：

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

nodejs内存不足

  1. 前端构建报错尝试修改 apps/web 下 package.json 文件中的 generate 脚本，将 NODE_OPTIONS=--max-old-space-size=8192 中的 --max-old-space-size 修改为更大的值，如 --max-old-space-size=16384；
  2. 后端构建报错尝试修改 apps/server 下 package.json 文件中的 build 脚本，将 NODE_OPTIONS=--max-old-space-size=2048 中的 --max-old-space-size 修改为更大的值，如 --max-old-space-size=4096；

性能优化

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

配置说明

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

# 实时查看日志
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 卷中，确保数据在容器重启后不会丢失。主要的数据卷包括：

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