13 - FastGPT 保姆级教程（开源AI知识库）

全栈开发入门 管理员 2026年06月23日 129 次阅读 975 字 约 4 分钟

视频教程：BV1dM4y1K7hK

视频链接：BV1dM4y1K7hK
发布日期：2023-09-15
视频时长：15:30
播放量：5.8万
所属合集：FastGPT 教程系列

视频概要

从零开始搭建 FastGPT 开源AI知识库的保姆级教程。覆盖 Docker 部署、OpenAI API 配置、知识库创建与导入、应用发布等全流程。适合完全没有经验的小白用户。

知识点清单

A. FastGPT 简介

知识点说明重要程度
FastGPT是什么开源的AI知识库平台，基于大语言模型★★★★★
核心能力知识库管理、对话机器人、API接口★★★★★
开源优势数据私有、可定制、无限制使用★★★★★
技术栈Next.js + MongoDB + PostgreSQL（向量库）★★★★
许可证Apache 2.0，可商用★★★★

B. Docker 部署

# 1. 安装Docker（如果没装）
curl -fsSL https://get.docker.com | sh

# 2. 克隆FastGPT项目
git clone https://github.com/labring/FastGPT.git
cd FastGPT

# 3. 复制环境变量文件
cp .env.template .env

# 4. 修改配置文件（填入OpenAI API Key等）
vim .env

# docker-compose.yml 关键配置
version: '3.3'
services:
  fastgpt:
    image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:latest
    ports:
      - 3000:3000
    environment:
      - DEFAULT_ROOT_PSW=1234    # 默认密码
      - OPENAI_BASE_URL=https://api.openai.com/v1
      - CHAT_API_KEY=sk-xxx      # 你的API Key
    volumes:
      - ./app/data:/app/data

  mongo:
    image: mongo:5.0.18
    volumes:
      - ./data/mongo:/data/db

# 5. 启动所有服务
docker-compose up -d

# 6. 查看日志
docker-compose logs -f

# 7. 访问 http://localhost:3000

C. 知识库创建与导入

操作说明注意事项
创建知识库在后台新建知识库，设置名称和描述名称建议有辨识度
导入数据支持手动输入、文件上传、网页抓取文件支持txt/pdf/word/csv
数据预处理自动分段、向量化、索引分段长度影响检索精度
检索模式向量检索、文本检索、混合检索混合检索效果最好
测试导入后可直接问答测试确保回答准确再发布
知识库创建流程：
1. 登录FastGPT后台
2. 左侧菜单 → 知识库 → 新建
3. 设置知识库名称和描述
4. 点击「导入」→ 选择数据来源
5. 等待向量化完成
6. 测试问答效果

D. 应用创建与发布

步骤操作说明
1新建应用选择「高级编排」或「简单模式」
2关联知识库将创建的知识库绑定到应用
3设置提示词定义AI的角色和回答风格
4调整参数温度、最大Token、检索数量等
5测试对话在线测试确认效果
6发布获取分享链接或API接入
应用提示词示例：
你是一个专业的客服助手，基于知识库内容回答用户问题。
如果知识库中没有相关信息，请明确告知用户。
回答要简洁、专业、有礼貌。

E. 环境变量详解

变量名说明示例值
DEFAULT_ROOT_PSW管理员密码1234
OPENAI_BASE_URLAPI地址https://api.openai.com/v1
CHAT_API_KEYAPI密钥sk-xxx
MONGODB_URI数据库地址mongodb://mongo:27017/fastgpt
PG_URL向量库地址postgresql://postgres:password@pg:5432/fastgpt

常见问题

问题解答
Docker装不上？确认系统是Linux，用官方脚本安装；Windows用Docker Desktop
启动后页面空白？等待3-5分钟，首次启动需要拉取镜像和初始化
API Key在哪里获取？在OpenAI官网 platform.openai.com 创建
知识库导入失败？检查文件格式和大小，单文件建议不超过10MB
回答不准确？调整检索参数，增加topK值，优化分段策略
部署需要什么配置？最低2核4G内存，推荐4核8G

学习建议

  • 这是FastGPT系列的核心入门视频，务必跟着一步步操作
  • 如果没有OpenAI Key，也可以用国内的模型API替代
  • 建议先用小数据集测试，确认流程后再导入大量数据
  • 后续视频会讲解高级编排和运维，按顺序学习效果最好
返回首页