用 FastbuildAI 在本地 3 分钟搭好一个 AI 聊天平台

FastbuildAI 是一款面向AI开发者和AI创业者设计的开源AI框架,它可以在数分钟内完成部署并通过可视化配置界面(Do It Yourself),零代码搭建具备完善的营销、计费、支付等商业闭环功能的原生AI应用。面向用户的友好交互设计及文档体验,即使你是非技术人员也能轻松完成前述工作。

FastbuildAI 的愿景是成为新一代AI应用基础设施提供商,为超级个体、一人公司和精益创业者们提供特性丰富、开箱即用的AI技术支持。

用 FastbuildAI 在本地 3 分钟搭好一个 AI 聊天平台

源码地址

Github:https://github.com/FastbuildAI/FastBuildAI

Gitee:https://gitee.com/FastbuildAI/FastBuildAI

功能特性

  • ✅ AI 聊天 – 多模型 AI 对话。
  • ✅ MCP 调用 – 支持模型上下文协议(Model Context Protocol)。
  • ✅ 用户充值 – 用户余额和支付系统。
  • ✅ 模型管理 – 管理和部署 AI 模型。
  • ⬜ 知识库 – 集中式 AI 知识管理。
  • ⬜ 智能代理 – 用于任务的自主代理。
  • ⬜ 工作流 – AI 任务自动化。
  • ⬜ 插件系统 – 通过插件扩展功能。

安装方式

一、Docker方式安装

通过Docker一键部署FastBuildAI

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

  • Docker (版本 20.10.0 或更高)
  • Docker Compose (版本 2.0.0 或更高)

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

# 检查 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

升级指南

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

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

二、手动安装

通过手动安装FastBuildAI

环境准备

安装好之后验证是否安装成功

node -v
npm -v
psql --version
redis-cli --version

拉取代码到本地

git clone https://gitee.com/FastbuildAI/FastbuildAI.git

安装依赖

# 如果没有pnpm,需要先安装pnpm
npm install -g pnpm

# 安装依赖
pnpm install

配置环境变量

cp .env.development.local.example .env.development.local

编辑 .env.development.local 文件,配置数据库连接信息

# 示例
# Base
NODE_ENV=production
APP_NAME=FastbuildAI
APP_VERSION=1.0.0-beta.1

# Server
SERVER_PORT=4090
SERVER_CORS_ENABLED=true
SERVER_CORS_ORIGIN=*
SERVER_SHOW_DETAILED_ERRORS=true

# PM2
PM2_APP_NAME=fastbuildai

# JWT
JWT_SECRET=fastbuildai
JWT_EXPIRES_IN=1d

# Database
DB_TYPE=postgres
DB_HOST=localhost
DB_PORT=5432
DB_USERNAME=postgres
DB_PASSWORD=postgres
DB_DATABASE=fastbuildai
DB_TABLE_PREFIX=fb_
DB_SYNCHRONIZE=true
DB_LOGGING=true

# Redis
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_USERNAME=
REDIS_PASSWORD=
REDIS_DB=0
REDIS_TTL=60*60*24

# Logs
# type LogLevel = "log" | "error" | "warn" | "debug" | "verbose" | "fatal"
LOG_LEVELS=error,warn,debug,fatal,log
LOG_TO_FILE=true
LOG_DATABASE_SCHEMA=true

# Web
VITE_APP_BASE_URL=http://localhost:4090
VITE_APP_WEB_API_PREFIX=/api
VITE_APP_CONSOLE_API_PREFIX=/consoleapi

# Docker
DOCKER_CLEAN_NODE_MODULES=true
DOCKER_CONTAINER_SUFFIX=
DB_EXTERNAL_PORT=5432
REDIS_EXTERNAL_PORT=6379

启动服务

pnpm dev

访问

服务名称地址
Serverhttp://localhost:4090
Webhttp://localhost:4091
Mobilehttp://localhost:4092

在线体验

无需部署,先来在线体验一下FastbuildAI的功能吧!

用户界面体验

站点:https://ai.fastbuildai.com/

说明:自行注册账号登录体验

后台界面演示

站点:https://demo.fastbuildai.com/

超级管理员账号:admin 密码:FastbuildAI&123456

原创文章,作者:howkunet,如若转载,请注明出处:https://www.intoep.com/ai/67188.html

(0)
打赏 微信赞赏 微信赞赏 支付宝赞赏 支付宝赞赏
上一篇 2025-08-15 10:03
下一篇 2025-08-25 09:42

发表回复

登录后才能评论
扫码了解
扫码了解
反馈建议
分享本页
返回顶部