故障排查GitHub Issue
解决同一模型名下区分OneAPI不同调用渠道的问题
解决同一模型名下区分OneAPI不同调用渠道的问题 现象 在OneAPI中部署多个同模型名的调用渠道后，FastGPT的配置文件config.json仅配置模型名称，未指定具体OneAPI渠道。调用时无法确定实际使用的渠道，OneAPI日志仅显示模型名称，无法区分具体调用的渠道实例。 可能原因 FastGP…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
配置本地文档站点地址至FastGPT首页不生效的排错指南
配置本地文档站点地址至FastGPT首页不生效的排错指南 现象 用户本地使用Hugo搭建FastGPT的文档站点，可通过localhost:1313正常访问，但尝试将该站点地址配置到FastGPT系统首页时未生效。用户尝试在config.json的feConfigs字段中增加docUrl属性，完成修改并重启…
故障排查GitHub Issue
解决FastGPT私有部署版Doc2X PDF处理超时问题
解决FastGPT私有部署版Doc2X PDF处理超时问题 现象 使用FastGPT 4.9.0私有部署版处理PDF时，触发超时报错。后续手动检查Doc2X的请求状态，显示该请求实际处理成功。 可能原因 部分复杂PDF的Doc2X处理需要更长时间，FastGPT默认的轮询次数不足以覆盖该处理时长，导致提前触…
故障排查GitHub Issue
解决Docker部署FastGPT时找不到API配置项的问题
解决Docker部署FastGPT时找不到API配置项的问题 现象 使用Docker方式部署FastGPT后，未在部署界面或配置流程中找到官网文档提及的API配置相关内容，无法完成API配置以支持公司其他应用访问。 可能原因 需按实际部署环境确认，常见可能因素包括Docker启动参数未配置API相关选项、配…
故障排查GitHub Issue
解决FastGPT 4.8.13版本私有部署docker镜像构建失败问题
解决FastGPT 4.8.13版本私有部署docker镜像构建失败问题 现象 执行docker build -t fastgpt2 ./projects/app/命令构建FastGPT 4.8.13版本私有部署镜像时，构建流程失败，未生成指定名称的目标镜像。 可能原因 由于未获取到具体报错日志，可能的原因…
故障排查GitHub Issue
解决FastGPT私有部署docker build时pnpm构建报错问题
解决FastGPT私有部署docker build时pnpm构建报错问题 现象 执行docker build -t dockername/fastgpt:tag --build-arg name=app .命令进行镜像构建时，在最后一步出现报错[builder 10/10] RUN pnpm --filte…
故障排查GitHub Issue
解决FastGPT私有部署Docker构建时tar文件模式未知报错
解决FastGPT私有部署Docker构建时tar文件模式未知报错 现象 本地可启动FastGPT私有部署版本4.8.23的代码，执行命令docker build -f ./projects/app/Dockerfile -t registry.cn-hangzhou.aliyuncs.com/fastgp…
故障排查GitHub Issue
解决FastGPT Docker部署后挂载证书仍无法调用验证型API的问题
解决FastGPT Docker部署后挂载证书仍无法调用验证型API的问题 现象 Docker部署FastGPT后，挂载模型API所需的证书文件。部署服务器与FastGPT容器内均可正常调用目标模型API，但在FastGPT页面内配置API URL与密钥后，测试连接显示connection error，do…
故障排查GitHub Issue
解决FastGPT通过docker compose启动时config.json挂载失败的问题
解决FastGPT通过docker compose启动时config.json挂载失败的问题 现象 执行docker compose up -d命令启动FastGPT时，出现配置文件config.json挂载失败的报错提示。 可能原因 可能的原因包括本地config.json文件路径配置错误、文件不存在、文…
故障排查GitHub Issue
解决FastGPT使用docker-compose拉取镜像提示镜像源不存在的问题
解决FastGPT使用docker-compose拉取镜像提示镜像源不存在的问题 现象 使用官方文档提供的docker-compose配置拉取FastGPT镜像时，终端提示镜像源不存在。经测试网络连接状态正常，开启或关闭VPN后，该问题仍未解决。 可能原因 当前无明确指向的根因，需按实际环境确认，可能涉及镜…
故障排查GitHub Issue
FastGPT docker-compose部署初始化脚本相关问题排查
FastGPT docker-compose部署初始化脚本相关问题排查 现象 用户在使用docker-compose部署FastGPT时，提出三项核心疑问：是否需要自行支持初始化脚本，若需执行是否要按顺序执行所有版本的初始化命令，以及是否存在自动化全流程脚本，且当前需通过查看代码才能确认可用脚本。 可能原因…
故障排查GitHub Issue
解决FastGPT私有部署docker compose场景下知识库链接读取无响应问题
解决FastGPT私有部署docker compose场景下知识库链接读取无响应问题 现象 docker compose部署的FastGPT中，知识库导入环节的链接读取功能无任何反应，无法完成预期的网页内容读取操作。 可能原因 无明确预设的具体原因，需结合实际部署环境逐一排查，涉及容器运行状态、网络连通性、…