部署与升级官方文档3 分钟阅读部署场景

配置FastGPT应用与管理端共享的对象存储环境变量

这部分内容用于配置FastGPT应用与管理端共享的对象存储相关环境变量,统一管理文件存储的基础参数。

对象存储环境变量总览

这部分内容用于配置FastGPT应用与管理端共享的对象存储相关环境变量,统一管理文件存储的基础参数。通用基础参数包括:STORAGEVENDOR,定义对象存储类型,可选minio、aws-s3、r2、cos、oss,默认值为minio;STORAGEPUBLICBUCKET为公开文件存储桶,默认值为fastgpt-public;STORAGEPRIVATEBUCKET为私有文件存储桶,默认值为fastgpt-private;STORAGEREGION为对象存储区域,默认值为us-east-1;STORAGEEXTERNALENDPOINT为外部可访问的对象存储地址,用于浏览器或外部服务访问,默认值为空。

快速配置步骤

  1. 确定对象存储类型,将STORAGE_VENDOR设置为对应的值。
  2. 配置访问凭证:设置STORAGEACCESSKEYID和STORAGESECRETACCESSKEY,默认值为minioadmin和minioadmin,生产环境需替换为实际凭证。
  3. 配置存储端点:根据所选存储类型设置对应端点参数。例如使用MinIO时,默认STORAGES3ENDPOINT为http://localhost:9000,若部署在其他地址需修改该参数。
  4. 调整存储桶名称:若无需使用默认值,可修改STORAGEPUBLICBUCKET和STORAGEPRIVATEBUCKET为自定义桶名。
  5. 配置下载模式:设置STORAGEDOWNLOADURLMODE,可选short-proxy或short-redirect,默认值为short-proxy。若使用short-redirect模式,可通过STORAGEDOWNLOADREDIRECTTTL_SECONDS调整临时下载地址的有效时间,单位为秒,默认值为300。
  6. 补充特定存储类型配置:根据所选存储类型,配置对应专属参数。例如当STORAGEVENDOR设置为r2时,需必填STORAGER2PUBLICENDPOINT;配置S3/MinIO强制路径访问时,可设置STORAGES3FORCEPATHSTYLE为true。

高级配置补充

部分扩展参数可根据需求配置:STORAGES3CDNENDPOINT为临时下载地址使用的CDN地址,配置时需同时配置STORAGEEXTERNALENDPOINT;STORAGES3MAXRETRIES为S3客户端的最大重试次数,默认值为3;STORAGEPUBLICACCESSEXTRASUB_PATH为公开文件访问路径的额外子路径,默认值为空。针对不同存储类型,还可配置专属参数,例如配置协议、加速域名、CNAME、内网访问等相关参数。

来源:FastGPT 官方文档