故障排查GitHub Issue
FastGPT使用Nginx代理chat/share路径的排错指南
FastGPT使用Nginx代理chat/share路径的排错指南 现象 尝试使用Nginx代理FastGPT的chat/share路径，访问http://ip:80后直接打开Nginx报错界面，无法正常完成代理。 可能原因 1. Nginx的location匹配规则配置不当，例如仅匹配根路径/； 2. 直…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT节点选择数组渲染与标题匹配配置问题
解决FastGPT节点选择数组渲染与标题匹配配置问题 现象 当前FastGPT节点选择功能无法支持传入数组渲染节点选项，无法通过下一个连接节点的标题进行匹配筛选，难以满足动态流程节点展示的需求。 可能原因 当前FastGPT的节点选择组件仅支持固定配置的选项，未开放数组传入渲染及基于连接节点标题匹配的配置能…
故障排查GitHub Issue
解决FastGPT中知识库检索结果无法作为非AI对话工具输出的问题
解决FastGPT中知识库检索结果无法作为非AI对话工具输出的问题 现象 在FastGPT插件构建流程中，存在需要将知识库检索结果作为输入的场景。当前知识库检索功能仅适配AI对话场景，其他组件无法直接获取该检索结果作为输入内容。 可能原因 知识库检索结果的接收逻辑仅支持AI对话场景。部分组件因自身运行逻辑不…
故障排查GitHub Issue
解决FastGPT中非首块表格无法正确映射表头的问题
解决FastGPT中非首块表格无法正确映射表头的问题 现象 使用FastGPT处理表格数据时，首个数据块可正常关联表头，第二个及之后的数据块无法正确匹配对应表头，检索非首块数据时出现映射异常。 可能原因 原有处理逻辑仅针对首个数据块配置表头映射规则，非首块数据未关联表头映射逻辑；同时原有逻辑对csv、exc…
故障排查GitHub Issue
解决FastGPT非Host模式Docker部署数据库连接失败问题
解决FastGPT非Host模式Docker部署数据库连接失败问题 现象 使用非Host模式（不使用本机代理）的Docker部署FastGPT，重新拉取最新docker-compose.yml后出现数据库连接失败问题。使用旧版本docker-compose.yml可正常运行部署，同时需确认FastGPT当前…
故障排查GitHub Issue
FastGPT 4.14.5-fix 偶发对话记录缺失的历史排查
FastGPT 4.14.5-fix 偶发对话记录缺失的历史排查 适用场景与历史记录 原报告称旧版和 4.14.5-fix 曾各发现一次少量对话记录缺失，应用日志中也查不到对应记录。 原始讨论提交于 2026-01-21，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 原线程缺少根因与恢复确认。…
故障排查GitHub Issue
解决FastGPT中OceanBase向量索引重复创建报错的问题
解决FastGPT中OceanBase向量索引重复创建报错的问题 现象 在packages/service/common/vectorDB/oceanbase/index.ts文件中，执行await ObClient.query的如下语句时，每次重启应用都会执行该语句： CREATE VECTOR INDE…
故障排查GitHub Issue
解决FastGPT私有化部署后断网访问界面无响应的问题
解决FastGPT私有化部署后断网访问界面无响应的问题 现象 私有化部署FastGPT V4.8.3时，联网状态下可正常使用所有功能。断网后，访问localhost:3000出现界面无响应的情况。通过浏览器开发者工具查看网络请求，可发现访问首页时会发起指向https://api.github.com/rep…
故障排查GitHub Issue
FastGPT 离线或内网部署页面无响应问题排错
FastGPT 离线或内网部署页面无响应问题排错 现象 私有化部署后，断网或内网环境下访问页面无响应。浏览器开发者工具显示页面请求了https://api.github.com/repos/labring/FastGPT，该请求无法完成导致访问失败。部分用户配置showgit后仍出现配置不生效的情况，同时存…
故障排查GitHub Issue
解决FastGPT部署后断网导致页面与创建操作加载异常的问题
解决FastGPT部署后断网导致页面与创建操作加载异常的问题 现象 完成FastGPT部署，获取所需的docker-compose.yml与配置文件后，通过docker compose up -d命令启动成功。断开主机网络连接，访问localhost:3000时页面加载失败，创建应用或知识库的操作持续处于加…
故障排查GitHub Issue
解决FastGPT集成开源离线私有LLM与embedding模型的部署问题
解决FastGPT集成开源离线私有LLM与embedding模型的部署问题 现象 在FastGPT中尝试集成更多开源离线私有LLM模型和embedding模型，并通过docker镜像部署时，无法实现预期的模型集成效果。按照现有流程配置后，模型无法正常加载或调用，业务流程无法正常运行。 可能原因 FastGP…
故障排查GitHub Issue
FastGPT配置Ollama时找不到配置入口的排障方法
FastGPT配置Ollama时找不到配置入口的排障方法 现象 在FastGPT中配置Ollama服务时，无法找到对应的配置入口，无法完成配置流程；部分场景下完成配置后，配合数据库运行速度较慢。 可能原因 无法找到配置入口的原因可能为未定位到FastGPT内置的Ollama配置模块；配置后运行速度较慢的原因…