故障排查GitHub issue2 分钟阅读故障排查

解决FastGPT私有部署容器镜像启动报错问题

使用FastGPT私有部署版本4.8.22时,执行docker run命令docker run --gpus all -itd -p 7231:7231 --name modelpdfv1 crpi-h3snc261q1dosroc.cn-hangzhou.personal.cr.aliyuncs.com/…

现象

使用FastGPT私有部署版本4.8.22时,执行docker run命令docker run --gpus all -itd -p 7231:7231 --name model_pdf_v1 crpi-h3snc261q1dosroc.cn-hangzhou.personal.cr.aliyuncs.com/marker11/marker_images:v0.1启动容器,出现报错,报错内容见附带截图。

可能原因

因未提供具体报错文本,可能的原因包括容器参数配置错误、镜像依赖缺失、宿主机GPU驱动不兼容、端口被占用、镜像文件损坏等,需按实际环境确认。

排查步骤

  1. 核对执行的docker run命令参数,确认--gpus all、端口映射-p 7231:7231、容器名称--name model_pdf_v1以及镜像地址均正确。
  2. 查看容器启动后的详细日志,提取具体报错信息。
  3. 检查宿主机GPU驱动状态,确认支持容器调用GPU资源。
  4. 确认7231端口未被其他进程占用。
  5. 重新拉取目标镜像,验证镜像文件完整性。

解决与验证

根据排查得到的具体问题执行对应修复操作。例如端口占用则更换映射端口,镜像损坏则重新拉取镜像,GPU驱动不兼容则更新对应驱动。修复完成后,重新执行docker run命令启动容器,确认容器正常运行且无报错。

来源: FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 故障排查 场景。执行变更前,需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照,再执行最小验证场景。