
FastGPT 实战指南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/FastGPT本文以开源仓库中的日语版 READMEREADME_ja.md为骨架系统讲解 FastGPT 的项目定位、Docker 快速启动流程、五种核心功能板块应用编排、应用调试、知识库、插件、运营以及自部署时的关键配置与许可证约束并结合仓库源码与部署文件补充可验证的底层实现细节。读完本文你可以独立完成 FastGPT 的本地 Docker 部署、理解其架构组成并掌握五大能力板块的功能边界与对应源码位置。一、项目定位开箱即用的 AI Agent 构建平台FastGPT 是一个基于大语言模型LLM构建的知识型平台定位为AI Agent 构建平台它不仅提供开箱即用的数据处理与模型调用能力还通过Flow 可视化工作流编排フローの可視化によるワークフローオーケストレーション来落地复杂的应用场景。用官方日文描述概括即すぐに使えるデータ処理やモデル呼び出し機能複雑なアプリケーションシナリオを実現。从仓库结构可以印证这一定位平台的能力并非单一体而是一组可独立部署的服务仓库目录职责projects/appNext.js 主应用承载页面、API 路由、工作流、知识库、对象存储、向量库等核心能力projects/code-sandbox代码沙箱为工作流节点提供 JS/Python 执行环境projects/marketplace插件市场提供系统插件的分发与安装projects/mcp_serverMCP Server对外提供 SSE 方式的模型上下文协议服务packages/service/core服务端核心模块含ai、app、chat、dataset、plugin、workflow六大子模块仓库同时提供了简体中文、English、Bahasa Indonesia、ไทย、Tiếng Việt、日本語 共六个语言的 READMEREADME.md、README_en.md、README_id.md、README_th.md、README_vi.md方便不同语言社区查阅。二、Docker 快速部署1. 两条命令完成启动按日文 README 的クイックスタート部署只需两步# 命令を実行して設定ファイルを取得执行命令获取配置文件 bash (curl -fsSL https://doc.fastgpt.io/deploy/install.sh) # サービスを起動启动服务 docker compose up -d第一条命令会拉取官方部署脚本并交互式生成docker-compose.yml第二条命令在配置文件同级目录执行拉起全部容器。该脚本本身也随仓库一起发布可以直接查看或本地运行document/public/deploy/install.sh。部署脚本与 compose 模板的生成逻辑由 deploy/init.mjs 统一维护生成说明见 deploy/README.md。启动完成后通过http://localhost:3000访问 FastGPT。默认账号为root默认密码为1234。需要注意从 docker-compose 模板 可以看到x-default-root-psw: x-default-root-psw 1234其注释明确重启后会强制重置该密码成环境变量值即每次容器重启root 密码都会被重置为DEFAULT_ROOT_PSW的当前取值。2. 交互式脚本做了什么从 install.sh 源码可以确认交互式脚本实际完成四件事选择部署版本默认提供main对应稳定版 v4.16、v4.15、v4.14三个版本也支持读取本地已有的docker-compose.ymlFASTGPT_LOCAL_COMPOSE_PATH指向本地文件时走本地模式选择镜像源阿里云中国大陆cn或 GitHub 全球global镜像地址在 deploy/version/main/args.json 中按cn/global分组声明例如主服务cn源为registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgptglobal源为ghcr.io/labring/fastgpt选择向量数据库支持pgPostgreSQLpgvector、milvus、zilliz、oceanbase、seekdb自动生成密钥脚本默认用openssl rand -hex随机化 root 密码、服务间 Token、应用密钥AES256_SECRET_KEY、INVOKE_TOKEN_SECRET等以及各组件MongoDB/Redis/MinIO/向量库密码并直接改写docker-compose.yml。若选择自动生成登录密码不再是 1234而是脚本执行完成后在终端输出的随机密码请妥善保存生成后的docker-compose.yml。脚本还支持非交互模式便于 CI/CD 或无人值守部署。环境变量包括FASTGPT_NON_INTERACTIVEtrue、FASTGPT_DEPLOY_VERSION、FASTGPT_REGIONcn/global、FASTGPT_VECTOR、FASTGPT_AUTO_GENERATE_CREDENTIALS、FASTGPT_FE_DOMAIN必填例如https://fastgpt.example.com、FASTGPT_SANDBOX_PROXY_URL启用 Agent/Skill 沙盒时必填ws://或wss://、FASTGPT_SANDBOX_PREVIEW_PROXY_URL4.16 新增的 HTTP 预览地址、FASTGPT_PORT宿主机端口默认 3000、FASTGPT_SANDBOX_PROXY_PORT默认 3006。完整的端口、地址校验逻辑均可在脚本中查到。3. 部署架构一套容器多个服务从 docker-compose 模板 可以清晰看到 FastGPT 的容器化组成fastgpt-mongoMongoDB存储除向量外的全部业务数据模板中以副本集--replSet rs0方式启动并内置自动初始化逻辑fastgpt-redisRedis承担缓存与队列fastgpt-minio对象存储S3 兼容用于文件与图片存储fastgpt-vector向量数据库模板通过${{vec.db}}占位符按所选向量库动态注入pg/milvus/oceanbase/seekdb 等连接配置片段见 deploy/templates/vectorfastgpt-app主服务端口映射3000:3000依赖 mongo/redis/minio/vector/code-sandbox/plugin 全部健康后启动fastgpt-code-sandbox代码沙箱预置 JS/Python 模块白名单、超时与内存限制等模板中SANDBOX_JS_ALLOWED_MODULES、SANDBOX_PYTHON_ALLOWED_MODULES可见一斑fastgpt-plugin插件服务与主库共用 MongoDB提供系统工具能力fastgpt-opensandbox-server / fastgpt-volume-manager / fastgpt-agent-sandbox-proxyAgent 沙盒体系支持会话级沙箱、持久卷与 WebSocket 鉴权代理fastgpt-agent-sandbox-proxy映射3006:1006fastgpt-aiproxy / fastgpt-aiproxy-pgAI Proxy 模型聚合网关及其 Postgres 存储实现多模型统一调用。各服务通过data、vector、app、codesandbox、aiproxy五个独立网络隔离敏感凭证统一使用 YAML 锚点x-share-db-config、x-log-config等管理便于一处修改、全局生效。4. 推荐配置与向量库选择官方 Docker 部署文档 document/content/self-host/deploy/docker.mdx 给出了配置建议可作选型参考PgVector 版非常轻量适合知识库索引量在 5000 万以下测试环境最低 2c4g100 万组向量建议 4c8g/50GB500 万组向量建议 8c32g/200GBMilvus 版对亿级以上向量性能更优要求 Milvus ≥ 2.5.16全文检索自动启用 Milvus BM25低于该版本 FastGPT 会直接报错退出SeekDB 版基于 MySQL 协议的高性能向量数据库与 OceanBase 协议完全兼容支持 1536 维向量与内置 HNSW 索引Zilliz Cloud 版全托管 SaaS 向量数据库不占用本地资源需要将MILVUS_ADDRESS、MILVUS_TOKEN配置为云实例的 Public Endpoint 与 API Key并把服务器 IP 加入白名单。三、三种使用方式按日文 README 的 利用方法FastGPT 提供三条使用路径云版クラウド版无需私有化部署直接使用官方托管服务SaaS 形态适合快速验证场景社区自托管版コミュニティセルフホスト版使用 Docker 快速部署即上文流程或通过 Sealos Cloud 一键部署商用版商用版需要更完整功能与更深服务支持时选择除完整软件交付外还提供场景化导入指导可联系官方进行商用咨询。自托管是社区版的核心使用方式涉及完整的镜像、配置与升级链路均由仓库中的 deploy 目录与 document/content/self-host 文档体系支撑。四、核心功能详解日文 README 用コア機能清单勾勒了五大能力板块以下逐一展开并给出仓库证据。1. 应用编排アプリケーションオーケストレーションAgent Skill 编排以技能为单位组织 Agent 行为从 document/public/imgs 中的skill_list_intro.png、agent_skill_vm_not_ready.png等图示可见技能列表与虚拟环境管理是核心交互对话工作流、插件工作流与基础 RPA 节点工作流模块位于 packages/service/core/workflow其中dispatch/目录承载节点调度与分发逻辑支持从对话式到插件式再到 RPA 自动化的多层编排用户交互表单输入、文件上传等交互节点对应 public 图片form_input1.png、fileinpu-1.png双向 MCP一方面 FastGPT 可通过 projects/mcp_server 作为 MCP Server 对外提供 SSE 服务部署文档提到 3003 端口为 FastGPT SSE MCP server另一方面可在工作流中接入外部 MCP 工具工作流自动生成未完成README 中标记为[ ]当前版本尚未开放。2. 应用调试アプリケーションデバッグ知识库单点检索测试可对单个知识库直接验证检索效果对话中的引用反馈可编辑、可删除对话结果中的引用内容支持在线修正对应对话模块 packages/service/core/chat 的运行时交互链路完整调用链日志从用户输入到节点执行的全程链路可追踪fastgpt-loop-run-detail.png、fastgpt-parallel-run-detail.png等图示展示了循环与并行节点的运行细节应用评估アプリケーション評価提供应用级的效果评估能力高级编排 DeBug 模式未完成、应用节点日志未完成均标记为[ ]属于规划中的能力。3. 知识库ナレッジベース知识库是 FastGPT 的 RAG 核心源码集中在 packages/service/core/dataset多数据库复用与混合可同时对接 PostgreSQL/pgvector、Milvus、Zilliz、OceanBase、SeekDB、openGauss 等多种向量库连接配置见 deploy/templates/vector并在应用层做多库混合检索chunk 记录的修正与删除知识库切片chunk数据支持在线编辑与删除对应data/、collection/、delete/等子模块多种导入方式支持手动输入、直接分割、QA 分割三种导入模式importFile.ts为文件导入入口文件格式支持txt、md、html、pdf、docx、pptx、csv、xlsxREADME 注明可通过 PR 扩展并支持 URL 读取与 CSV 批量导入混合检索与重排リランキング检索逻辑位于search/子模块当向量库为 Milvus 时全文检索走 BM25modeldata_v2单表其他向量库走 MongoDB$text语言识别引擎可通过MILVUS_LANGUAGE_IDENTIFIER在lingua/whatlang间切换API 知识库通过接口对接外部数据源对应apiDataset/子模块另有synonym/同义词、tag/标签、training/向量训练等子模块共同构成完整的数据处理管线。4. 插件功能プラグイン機能系统工具热更新[x]系统插件可在运行时更新插件服务独立部署为 fastgpt-plugin并可通过 projects/marketplace 插件市场安装与分发RAG 模块热更新、Agent-loop 热更新、AI 实时生成插件[ ]均处于未完成状态。需要说明的是从 V4.14.0 起 fastgpt-plugin 镜像仅提供运行环境、不再预装系统插件所有 FastGPT 系统需手动通过插件市场或导入.pkg文件安装系统插件。5. 运营功能運用機能免登录共享窗口可生成无需登录即可访问的分享链接share-auth1.png、sharelink_process.png图示可见Iframe 一键嵌入将应用以 iframe 形式嵌入第三方站点统一对话记录查看与数据标注集中查看所有会话记录并支持数据标注便于构建评估数据集应用运营日志提供应用维度的运行日志。五、自部署关键配置项Docker 部署时主要修改fastgpt-app服务下的environment完整变量说明见 环境变量文档。以下为核心配置类别变量说明必填FE_DOMAIN客户端实际访问 FastGPT 的完整地址协议主机可选端口如https://fastgpt.example.com不能留空不能填容器内地址账号DEFAULT_ROOT_PSWroot 用户密码重启后强制重置为该值密钥ROOT_KEY系统最高权限 API 密钥用于/api/admin/**接口密钥FILE_TOKEN_KEY/AES256_SECRET_KEY/INVOKE_TOKEN_SECRET文件鉴权、AES 加解密、反向调用 JWT 密钥均为运行期必填建议随机强密钥install.sh 会自动生成数据库MONGODB_URI/REDIS_URL主业务库与缓存连接串向量库PG_URL/MILVUS_ADDRESS/OCEANBASE_URL/SEEKDB_URL/OPENGAUSS_URL按所选向量库二选一配置存储STORAGE_VENDOR/STORAGE_S3_ENDPOINT等对象存储类型与地址模板默认 MinIO沙盒AGENT_SANDBOX_PROVIDER、AGENT_SANDBOX_PROXY_URL、AGENT_SANDBOX_PREVIEW_PROXY_URL启用 Agent/Skill 沙盒时的 Provider 与浏览器访问地址并发DATASET_PARSE_MAX_PROCESS/VECTOR_MAX_PROCESS/QA_MAX_PROCESS/VLM_MAX_PROCESS开源版四类处理队列的最大并发数模板默认均为 10需要开放的外网端口通常为主服务 3000、S3 服务 9000、Agent Sandbox Proxy 3006以及可选的 SSE MCP server 3003。端口冲突时只需修改 compose 中映射端口:容器端口左侧的映射端口。六、许可证约束本仓库遵循FastGPT Open Source License见 LICENSE日文 README 明确列出三条约束允许作为后端服务的商用使用但不允许提供 SaaS 服务未购买商业许可证的商用服务必须保留相关版权信息详细信息以 LICENSE 为准商用事宜可通过官方渠道联系Dennissealos.io。结语从项目定位、两条命令的快速部署到应用编排、调试、知识库、插件、运营五大能力板块再到容器化架构、关键环境变量与许可证边界FastGPT 呈现出一个数据进、应用出的完整 AI Agent 构建闭环数据通过知识库管线完成清洗与向量化应用通过 Flow 工作流编排完成逻辑串联最终以对话、插件或 API 形态对外服务。自托管用户可以基于 docker-compose 模板 和 环境变量文档 按需裁剪组件也可以深入 packages/service/core 源码研究每一步的底层实现。【免费下载链接】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),仅供参考