手动安装
通过手动安装FastBuildAI
环境准备
安装好之后验证是否安装成功
node -v
npm -v
psql --version
redis-cli --version
拉取代码到本地
# Gitee仓库
git clone https://gitee.com/FastbuildAI/FastbuildAI.git
# or Github仓库
git clone https://github.com/FastbuildAI/FastbuildAI.git
安装依赖
如果网络慢,可以先配置淘宝镜像:
npm config set registry https://registry.npmmirror.com
# 如果没有pnpm,需要先安装pnpm
npm install -g pnpm
# 进入项目目录
cd FastbuildAI
# 安装依赖
pnpm install
配置环境变量
cp .env.development.local.example .env.development.local
根据你的实际环境配置,编辑 .env.development.local
文件,配置数据库连接、Redis连接等环境变量配置
# 示例
# Base
# 运行环境
NODE_ENV=production
# 应用名称(用于日志、PM2等标识)
APP_NAME=FastbuildAI
# 应用版本号(用于信息展示或灰度控制)
APP_VERSION=1.0.0-beta.3
# Server
# 后端服务监听端口
SERVER_PORT=4090
# 是否启用 CORS
SERVER_CORS_ENABLED=true
# CORS 允许的来源,* 表示允许任意来源
SERVER_CORS_ORIGIN=*
# 是否显示详细错误(仅建议在开发环境开启)
SERVER_SHOW_DETAILED_ERRORS=true
# 是否演示环境(开启后可能限制写入/危险操作)
SERVER_IS_DEMO_ENV=false
# PM2
# PM2 进程名称(使用 pm2 启动/管理时的标识)
PM2_APP_NAME=fastbuildai
# JWT
# JWT 签名密钥(请在生产环境务必更换为强随机值)
JWT_SECRET=fastbuildai
# JWT 过期时间(如:60s, 10m, 1h, 1d)
JWT_EXPIRES_IN=1d
# Database
# 数据库类型(例如:postgres、mysql)
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
# 是否输出 SQL 日志
DB_LOGGING=true
# Redis
# Redis 主机地址
REDIS_HOST=localhost
# Redis 端口
REDIS_PORT=6379
# Redis 用户名(如未启用 ACL 可留空)
REDIS_USERNAME=
# Redis 密码(如无密码可留空)
REDIS_PASSWORD=
# Redis 数据库索引(0-15)
REDIS_DB=0
# 缓存默认过期时间(秒),支持表达式:60*60*24 表示 1 天
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
# 是否打印数据库 schema 变更信息(用于调试)
LOG_DATABASE_SCHEMA=true
# Web
# 前端接口请求域名,生产环境需填写
VITE_APP_BASE_URL=
# Web 与服务端通讯的 API 前缀
VITE_APP_WEB_API_PREFIX=/api
# 控制台管理端 API 前缀
VITE_APP_CONSOLE_API_PREFIX=/consoleapi
# Docker
# npm镜像源
NPM_REGISTRY_URL=https://registry.npmmirror.com
# 是否使用快速启动模式(可能跳过部分检查/初始化)
QUICK_START_MODE=false
# 容器名称后缀(便于区分不同环境/开发者)
DOCKER_CONTAINER_SUFFIX=
# 容器内存上限(例如:512M, 2G)
DOCKER_MEMORY_LIMIT=2666M
# 容器 CPU 限制(核心数,可小数,如 1.0 表示 1 核)
DOCKER_CPU_LIMIT=1.0
# 容器内存预留(调度期望占用)
DOCKER_MEMORY_RESERVATION=512M
# Redis 宿主机映射端口(用于将容器内 6379 暴露到宿主机)
REDIS_EXTERNAL_PORT=
# Postgres 宿主机映射端口(用于将容器内 5432 暴露到宿主机)
POSTGRES_EXTERNAL_PORT=
启动服务
数据库实体会自动同步,无需单独操作
一键启动所有服务
cd /FastbuildAI
pnpm dev
单独启动服务
# 单独启动server
cd /FastbuildAI/apps/server
pnpm dev
# 单独启动web
cd /FastbuildAI/apps/web
pnpm dev
访问地址
服务名称 | 地址 |
---|---|
Server | http://localhost:4090 |
Web | http://localhost:4091 |
Mobile(开发中) | http://localhost:4092 |