故障排查GitHub issue2 分钟阅读排错/错误码

FastGPT私有部署后S3连接不可达导致页面无法访问的排查与解决

使用交互式脚本部署的FastGPT私有版本,配置S3使用本机IP,昨日可正常访问,今日无法打开页面。查看容器日志发现报错:connect EHOSTUNREACH 172.16.69.131:9000,提示无法确保fastgpt-public和fastgpt-private存储桶正常创建。 1.

现象

使用交互式脚本部署的FastGPT私有版本,配置S3使用本机IP,昨日可正常访问,今日无法打开页面。查看容器日志发现报错:connect EHOSTUNREACH 172.16.69.131:9000,提示无法确保fastgpt-publicfastgpt-private存储桶正常创建。

可能原因

  1. 配置的S3服务未正常运行或已停止;
  2. FastGPT部署环境与S3服务之间的网络连通性出现异常;
  3. S3服务的IP或端口发生变更,与FastGPT的配置不一致;
  4. 未正确配置S3相关信息,导致服务无法连接存储服务。

排查步骤

  1. 查看FastGPT容器日志,确认是否存在connect EHOSTUNREACH 172.16.69.131:9000以及无法创建指定存储桶的报错信息;
  2. 检查S3服务的运行状态,确认服务是否正常启动;
  3. 在FastGPT部署环境中测试与S3服务地址的连通性,确认网络是否可达;
  4. 核对S3服务的IP、端口是否与FastGPT的配置一致,确认是否发生过变更;
  5. 检查本地防火墙或网络策略,确认是否拦截了S3服务使用的9000端口通信。

解决与验证

针对排查出的具体问题进行处理:若S3服务异常则重启恢复;若网络连通性异常则修复对应问题;若配置的S3信息有误则修正IP、端口等参数。处理完成后,重启FastGPT相关容器,访问页面确认可以正常打开,再次查看容器日志,确认不再出现S3连接不可达的报错,即可验证问题已解决。需注意,FastGPT正常运行需正确配置S3信息,未配置或配置错误会导致服务启动失败。

来源:https://github.com/labring/FastGPT/issues/7296