故障排查官方文档15 分钟阅读问题清单聚合页

FastGPT 镜像与架构适配 问题清单

查阅镜像与架构适配 问题清单,按症状与技术对象定位相关配置、排查步骤和已发布文档,结合版本边界确认适用条件。

本页汇总站内已发布的 60 篇容器镜像获取与处理器架构适配的问题,按症状分组列出,可按报错表现直接定位到对应文档。

属于这一环节的三类典型症状

  1. 镜像拉取失败或版本不符
  2. 处理器架构与镜像不匹配
  3. 原生依赖在特定架构下加载失败

若症状与上述三类都不匹配,可返回部署与环境问题全景重新分流。

排查这一环节的通用顺序

  1. 取后端服务日志中与该环节组件相关的完整报错,包括组件名与错误码
  2. 在部署环境内验证该组件是否可独立访问,排除网络与权限因素
  3. 核对该组件的版本与主服务版本的对应关系
  4. 按下方清单中症状最接近的条目执行,完成后重新验证同一操作

已发布的文档清单(60 篇)

文档类型
FastGPT 4.15.0-beta5版本镜像更新与配置操作指南技术速查
FastGPT Agent Sandbox 镜像与环境变量配置说明术语速查
FastGPT Agent沙箱的配置、镜像源设置及迁移流程说明术语速查
FastGPT OpenSandbox运行环境配置与CPU架构适配部署场景
FastGPT私有部署镜像被扫描为挖矿程序的排查与解决排错/错误码
FastGPT镜像拉取失败的排查与处理方法术语速查
指导构建适配FastGPT的MinerU镜像并解决API调用422报错术语速查
查询FastGPT各组件及部署源的官方标准镜像地址技术速查
解决CentOS部署FastGPT私有版时镜像拉取连接重置问题排错/错误码
解决FastGPT 4.8.0版本docker镜像编译失败的常见问题排错/错误码
解决FastGPT 4.8.13版本私有部署docker镜像构建失败问题排错/错误码
解决FastGPT 4.8.4版本docker compose拉取镜像停滞问题排错/错误码
解决FastGPT Docker Compose启动时镜像拉取失败问题排错/错误码
解决FastGPT Docker Compose部署的镜像与版本配置错误排错/错误码
解决FastGPT Docker构建时npm镜像配置冲突导致超时的问题排错/错误码
解决FastGPT Docker镜像构建与版本更新异常问题排错/错误码
解决FastGPT OpenSandbox镜像硬编码与配置缺失问题排错/错误码
解决FastGPT v4.9.14版本构建mcp_server镜像失败的问题排错/错误码
解决FastGPT代码沙箱镜像架构不匹配的报错问题排错/错误码
解决FastGPT使用docker-compose拉取镜像提示镜像源不存在的问题排错/错误码
解决FastGPT启动stawky/chatglm2-m3e镜像失败排错/错误码
解决FastGPT增强PDF解析中marker镜像CPU启动失败问题排错/错误码
解决FastGPT安装时etcd镜像拉取失败的问题术语速查
解决FastGPT安装过程中拉取quay.io镜像失败的问题排错/错误码
解决FastGPT打包镜像加载Docker镜像元数据失败问题排错/错误码
解决FastGPT拉取阿里云容器镜像超时报错问题排错/错误码
解决FastGPT指定版本Docker镜像拉取失败问题排错/错误码
解决FastGPT替换前端镜像后向量索引丢失问题排错/错误码
解决FastGPT的mcp_server Docker镜像构建时的bun依赖报错问题排错/错误码
解决FastGPT私有化部署arm架构镜像适配问题排错/错误码
解决FastGPT私有部署ARM架构环境下code-sandbox启动失败问题排错/错误码
解决FastGPT私有部署Redis镜像拉取失败的问题排错/错误码
解决FastGPT私有部署中镜像版本与配置不一致的问题排错/错误码
解决FastGPT私有部署后镜像重启报fetch failed的问题排错/错误码
解决FastGPT私有部署容器镜像启动报错问题排错/错误码
解决FastGPT私有部署时Docker镜像构建失败的问题排错/错误码
解决FastGPT私有部署时sandbox镜像拉取失败的问题排错/错误码
解决FastGPT私有部署构建自定义Docker镜像报错问题排错/错误码
解决FastGPT私有部署构建镜像时resolve-url-loader CSS报错问题排错/错误码
解决FastGPT私有部署镜像打包后代码修改未生效的问题排错/错误码
解决FastGPT私有部署镜像拉取时manifest未知报错问题排错/错误码
解决FastGPT调用MinerU API报错422及适配镜像构建问题排错/错误码
解决FastGPT部署中sandbox服务镜像未配置的问题排错/错误码
解决FastGPT部署时docker compose拉取镜像报undefined network vector错误排错/错误码
解决FastGPT部署时docker compose拉取镜像超时失败问题排错/错误码
解决FastGPT部署时容器镜像无法下载的问题排错/错误码
解决FastGPT部署过程中镜像配置拉取失败的问题术语速查
解决FastGPT部署镜像版本与发布包不一致的问题排错/错误码
解决FastGPT配套bge-rerank-v2-m3镜像的Docker GPU部署启动错误问题排错/错误码
解决FastGPT镜像标签与内置代码版本不一致问题排错/错误码
解决FastGPT项目x86架构下mcp_server镜像打包失败的问题排错/错误码
解决Linux ARM64架构下FastGPT原生模块加载失败问题排错/错误码
解决Mac ARM64环境下FastGPT依赖isolated-vm编译失败的问题排错/错误码
解决WSL2 Ubuntu22.04部署FastGPT后镜像重启无法登录问题排错/错误码
解决x86架构下FastGPT MCP服务镜像构建失败的问题排错/错误码
解决本地ChatGLM镜像启动与配置文件关联的问题排错/错误码
说明FastGPT Dockerfile镜像仓库的配置修改规则术语速查
说明FastGPT SSO服务镜像的部署配置方法术语速查
说明FastGPT部署Dockerfile的镜像源配置变更事项术语速查
说明FastGPT镜像名的组成、分类与使用规则术语速查

这份清单的适用范围

清单中的条目来自可公开复现的情形,按症状归组。以下情形需要另行确认:

  • 同一症状由多个原因共同导致时,需按上述顺序逐项排除
  • 商业版特有配置项引发的同类症状
  • 与具体基础设施环境耦合、无法在标准部署下复现的情形

继续阅读

参考资料

问题仍未定位时

上述条目覆盖的是可依据公开信息复现与排查的情形。若问题涉及具体部署环境的配置细节、或需要结合运行日志逐项确认,可通过商务咨询获取部署阶段的技术支持;云服务形态可直接开始使用,不需要处理部署环节的环境依赖。

  • 商务咨询: 获取私有部署与升级阶段的技术支持
  • 立即开始: 使用云服务形态,跳过环境准备
  • 定价: 对比云服务与私有部署两种形态的适用范围