FastGPT 开源实践：基于 LLM 的知识库与 AI Agent 构建平台，Docker 快速部署指南
FastGPT 开源实践基于 LLM 的知识库与 AI Agent 构建平台Docker 快速部署指南【免费下载链接】FastGPTFastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, and visual AI workflow orchestration, letting you easily develop and deploy complex question-answering systems without the need for extensive setup or configuration.项目地址: https://gitcode.com/GitHub_Trending/fa/FastGPTFastGPT 是一个基于大语言模型LLM的 AI Agent 构建平台提供开箱即用的数据处理与模型调用能力并通过 Flow 可视化编排工作流从而支撑复杂的问答与自动化应用场景。本文以仓库官方 README 为骨架结合部署脚本、docker-compose 模板与源码结构系统讲解 FastGPT 的定位、Docker 快速部署流程、容器化架构、五大核心能力及安装后的初始化要点帮助读者在十几分钟内从零跑通一个可用的 FastGPT 实例并理解其底层工程实现。一、FastGPT 是什么一个开箱即用的 AI Agent 构建平台根据 README_vi.md越南语版 README与 README.md 内容一致的项目定位FastGPT 是一个 AI Agent 构建平台提供开箱即用的数据处理、模型调用等能力同时可以通过 Flow 可视化进行工作流编排从而实现复杂的应用场景。围绕这一核心定位项目提供三种使用形态云服务版本无需私有化部署直接使用官方托管的在线服务社区自托管版本通过 Docker 快速部署或使用 Sealos Cloud 一键部署商业版本提供更完整的功能与深度服务支持并附带场景落地辅导。从仓库工程结构看这是一个典型的 monorepo参见根目录 package.json、pnpm-workspace.yaml核心代码按职责划分为packages/service后端业务逻辑common/core/support/workerpackages/web前端 UI 组件、hooks 与国际化packages/global跨端共享的类型、工具与 OpenAPI 定义packages/dalRedis 等数据访问层projects/appFastGPT 主站应用projects/code-sandbox、projects/agent-sandbox 等代码沙箱与 Agent 沙箱运行时document官方文档站MDX 内容与部署资源。二、快速开始两条命令完成 Docker 部署README 提供了一条极简的快速启动路径在终端执行脚本拉取配置再用docker compose启动即可。# 输入命令拉取配置文件 bash (curl -fsSL https://doc.fastgpt.io/deploy/install.sh) # 启动 docker compose up -d完全启动后通过http://localhost:3000访问 FastGPT默认账号为root密码为1234。这条命令所对应的安装脚本实体就保存在仓库中document/public/deploy/install.sh。它是纯 bash 实现行为完全可审计提供方向键↑↓交互式单选菜单radio_select用于选择部署版本、镜像源、向量数据库等支持通过环境变量实现非交互式安装FASTGPT_NON_INTERACTIVEtrue时所有选择均可通过FASTGPT_DEPLOY_VERSION、FASTGPT_REGION、FASTGPT_VECTOR、FASTGPT_AUTO_GENERATE_CREDENTIALS、FASTGPT_FE_DOMAIN等变量预先指定会下载官方生成的docker-compose.yml必要时同时下载旧版所需的config.json并对文件做合法性校验校验services:关键字、拒绝 HTML 页面与空文件自动探测宿主机 IP 与 Docker socket 路径并改写 compose 中的端口映射与挂载路径。安装完成后脚本会提示后续操作预拉取镜像docker compose --profile prepull pull若 compose 中存在沙箱镜像定义启动服务docker compose up -d按映射配置防火墙或反向代理访问http://localhost:3000以实际 FE 地址为准使用默认账号root及脚本回显的密码登录在「账号-模型提供商」页面配置模型。提示README 中默认密码1234仅在未启用自动密钥生成时有效。安装脚本支持选择「自动生成推荐」此时会通过random_hex()随机化 root 登录密码、系统密钥x-system-key、FILE_TOKEN_KEY、AES256_SECRET_KEY、INVOKE_TOKEN_SECRET、MongoDB/Redis/MinIO 等组件密码并在结尾回显 root 密码务必妥善保存生成的docker-compose.yml。三、容器化架构一张 docker-compose 看懂整个系统官方部署模板位于 deploy/version/main/docker-compose.template.yml本地开发版见 deploy/dev/docker-compose.yml公开下载产物按版本/区域/向量库组合生成在 document/public/deploy/docker/main含pg、milvus、zilliz、oceanbase、seekdb、opengauss六种向量库组合。以 main 稳定版为例完整的服务组成如下服务端口映射职责fastgpt-app3000:3000FastGPT 主应用前端 APIfastgpt-mongo内网MongoDB 5.0主业务数据库以副本集模式启动fastgpt-redis内网Redis 7.2缓存与队列fastgpt-minio9000/9001对象存储用于文件资源fastgpt-vectorPG 等内网向量数据库随所选向量库方案变化fastgpt-code-sandbox3002代码沙箱JS/Pythonfastgpt-plugin3004插件服务系统工具fastgpt-opensandbox-server8090Agent 沙盒控制器管理容器生命周期fastgpt-volume-manager3005卷管理微服务幂等创建/删除命名卷或 PVCfastgpt-agent-sandbox-proxy3006:1006浏览器与 OpenSandbox 之间的 WebSocket 鉴权代理fastgpt-aiproxy/fastgpt-aiproxy-pg3010AI Proxy 模型聚合网关及其数据库模板中大量使用 YAML anchor 复用配置块理解这些 anchor 是自定义部署的关键x-share-db-config数据库与对象存储连接配置包括MONGODB_URI、REDIS_URL以及对象存储系列变量STORAGE_VENDOR: minio、STORAGE_REGION、STORAGE_ACCESS_KEY_ID、STORAGE_SECRET_ACCESS_KEY、STORAGE_PUBLIC_BUCKET、STORAGE_PRIVATE_BUCKET、STORAGE_S3_ENDPOINT、STORAGE_S3_FORCE_PATH_STYLE等STORAGE_VENDOR支持minio | aws-s3 | cos | ossx-log-config日志配置可开关控制台输出与 OpenTelemetryOTEL上报x-no-proxy-config显式绕过 compose 内部服务的代理避免内部请求被HTTP_PROXY/HTTPS_PROXY劫持x-agent-sandbox-configAgent 沙盒相关配置如AGENT_SANDBOX_PROXY_URL、AGENT_SANDBOX_PROXY_SECRET、AGENT_SANDBOX_CPU_COUNT、AGENT_SANDBOX_MEMORY_MIB、AGENT_SANDBOX_SUSPEND_MINUTES等基础安全变量FE_DOMAIN客户端访问地址用于补全文件资源路径、ROOT_KEY最高权限密钥、DEFAULT_ROOT_PSWroot 密码重启后强制重置为环境变量值、AES256_SECRET_KEY、INVOKE_TOKEN_SECRET至少 32 位。向量库的选择逻辑由 deploy/templates/vector/config.json 定义deploy/init.mjs 会在构建阶段把各向量库的db/config/extra片段注入到${{vec.*}}占位符中生成按版本/区域/向量库排列的成品 compose 文件镜像 tag 则来自 deploy/version/main/args.json如fastgpt: v4.16.2、mongo: 5.0.32、redis: 7.2-alpine并区分阿里云cn与global两套镜像仓库。四、五大核心能力详解README 以功能清单形式列出了 FastGPT 的核心能力可分为五大板块1. 应用编排能力Agent Skill 编排将能力封装为可复用的 Skill支持组合调用对话工作流、插件工作流可视化 Flow 编排包含基础的RPA 节点用户交互工作流中支持与用户进行多轮交互双向 MCP支持 MCPModel Context Protocol的双向集成规划中辅助生成工作流未勾选表示尚未完成。2. 应用调试能力知识库单点搜索测试对单个知识库进行检索效果验证对话时反馈引用并可修改与删除回答附带的引用来源支持编辑与删除完整调用链路日志可追踪一次对话的完整调用链应用评测对应用整体效果进行评测规划中高级编排 DeBug 调试模式、应用节点日志。3. 知识库能力多库复用、混用单个应用可同时关联多个知识库chunk 记录修改和删除对切片记录进行细粒度维护多种导入方式手动输入、直接分段、QA 拆分导入多格式文件支持TXT、MD、HTML、PDF、Docx、PPTX、CSV、XLSX更多 File Loader 可通过 PR 补充并支持URL 读取与CSV 批量导入混合检索 重排组合多种检索方式并做 rerankAPI 知识库以 API 方式对接外部知识库。4. 插件能力系统工具热更新工具类插件支持不重启服务的热更新规划中RAG 模块热更新、Agent-loop 热更新、AI 实时生成插件。5. 运营能力免登录分享窗口无需登录即可分享对话应用iframe 一键嵌入将应用嵌入自有网站统一查阅对话记录并对数据进行标注集中管理对话日志与标注应用运营日志记录应用的运行与使用情况。五、从 README 到源码能力背后的工程支撑FastGPT 的功能声明并非空谈仓库源码为其提供了可验证的实现支撑主业务逻辑集中在 packages/service/core441 个.ts文件覆盖知识库、对话、工作流编排等与 projects/app/src主站前后端前端工作流编排交互位于 packages/web/components知识库相关操作可在 packages/service/core/dataset从目录结构推断中定位到导入、切片、检索等模块插件系统由独立的fastgpt-plugin服务承载与主站通过PLUGIN_BASE_URL/PLUGIN_TOKEN对接沙箱与 RPA 能力依赖code-sandbox、opensandbox-server、agent-sandbox-proxy与volume-manager四个独立服务协同这解释了为什么新版 docker-compose 的依赖链如此之长单元测试与集成测试覆盖核心逻辑见 packages/service/test、test 与各包的vitest.config.ts。也就是说README 描述的数据处理、RAG 检索、可视化工作流编排在工程上分别对应着 Mongo/PG 数据层、packages/service的检索链路以及前端 Flow 编辑器 后端工作流执行引擎。六、部署后的初始化与使用要点完成docker compose up -d之后建议按以下顺序初始化确认服务健康docker compose ps观察各服务健康状态compose 中为关键服务定义了 healthcheck登录系统使用root账号与安装脚本回显的密码登录若未启用自动密钥生成则为1234配置模型在「账号-模型提供商」页面配置 LLM、向量化与重排模型这也是 FastGPT 运行对话与知识库检索的前提创建知识库与应用导入文档构建知识库再通过 Flow 编排应用对外发布根据实际网络环境通过防火墙放行端口或将3000主站、3006Sandbox Proxy置于反向代理之后。需要注意的适用前提与限制模板中 MongoDB 使用副本集--replSet rs0模式这是事务能力的前提不要以单机模式启动若宿主机 CPU 不支持 AVX 指令集README 与 compose 注释均提示可切换到旧版镜像如 Mongo 4.4.29、MinIO cpuv1 版本若遇到部署问题可查阅仓库内 document/content/self-host/troubleshooting 下的故障排查文档10 个 MDX 文件以及完整的 Docker 部署教程document/content/self-host/deploy。七、开源协议与合规要点本仓库遵循 FastGPT Open Source LicenseREADME 明确列出的三条核心约定允许作为后台服务直接商用但不允许提供 SaaS 服务未经商业授权任何形式的商用服务均需保留相关版权信息完整条款以 LICENSE 文件为准商业授权可联系官方获取定价说明。结语FastGPT 以开箱即用为设计主线Docker 两条命令即可拉起完整服务栈Flow 可视化让复杂工作流编排变得直观知识库的多样导入与混合检索覆盖了 RAG 的主流落地形态。结合 deploy 目录下的模板生成机制与 packages/service 的模块化实现无论是快速搭建演示环境、深度定制业务逻辑还是研究 AI Agent 平台工程化方案这个仓库都提供了完整且可验证的参考。上手第一步就是执行 README 中的两条 Docker 命令。【免费下载链接】FastGPTFastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, and visual AI workflow orchestration, letting you easily develop and deploy complex question-answering systems without the need for extensive setup or configuration.项目地址: https://gitcode.com/GitHub_Trending/fa/FastGPT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考