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

解决FastGPT离线环境无法使用插件市场及迁移插件的问题

在离线环境部署完成FastGPT后,无法访问插件市场网页,无法直接安装市场中的插件,需要将外网环境中已下载安装的插件迁移至内网离线环境。 FastGPT的插件市场依赖外网网络访问以加载资源与安装包,离线环境无外网访问权限,无法正常加载插件市场内容;同时未提前在外网环境下载目标插件并迁移相关文件至内网。 1.

现象

在离线环境部署完成FastGPT后,无法访问插件市场网页,无法直接安装市场中的插件,需要将外网环境中已下载安装的插件迁移至内网离线环境。

可能原因

FastGPT的插件市场依赖外网网络访问以加载资源与安装包,离线环境无外网访问权限,无法正常加载插件市场内容;同时未提前在外网环境下载目标插件并迁移相关文件至内网。

排查步骤

  1. 登录部署FastGPT的服务器,通过通用网络测试工具确认当前环境是否具备外网访问能力。
  2. 进入FastGPT的插件管理界面,观察是否无法加载插件市场的内容列表。
  3. 梳理在外网环境中已安装目标插件的完整文件路径与配置信息,准备迁移所需的插件文件及配置项。

解决与验证

首先完成插件迁移操作:在外网环境中找到已安装的目标插件文件(需按实际环境确认存储路径),将其打包后复制至内网离线环境中FastGPT对应的插件目录;在内网FastGPT的配置文件中添加对应插件的加载配置(需按实际环境确认配置项),重启FastGPT服务使配置生效。 验证环节:重启服务后进入FastGPT插件管理界面,确认已迁移的插件正常显示且可正常启用,即完成插件迁移验证。

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