FastGPT 支持 MinIO、AWS S3、Alibaba Cloud OSS、Tencent Cloud COS 和 Cloudflare R2 五种对象存储服务。文件上传默认通过 FastGPT 后端代理，下载支持两种模式：short-proxy（默认模式，FastGPT 校验短链并代理文件流，无需配置公网对象存储地址）和short-redirect（FastGPT 校验短链后 302 跳转至短时效对象存储地址，文件流量不经过 FastGPT）。使用short-redirect模式时，自部署 MinIO 必须配置STORAGE_EXTERNAL_ENDPOINT。部署前建议提前创建STORAGE_PUBLIC_BUCKET和STORAGE_PRIVATE_BUCKET，并确保 FastGPT 使用的 Access Key 对两个存储桶均有读写权限。
不同厂商的对象存储需配置专属环境变量：MinIO 可使用兼容 S3 协议的配置项，需配置内网连接地址STORAGE_S3_ENDPOINT、服务器和客户端均可访问的外部地址STORAGE_EXTERNAL_ENDPOINT，可选配置 CDN 地址STORAGE_S3_CDN_ENDPOINT、路径路由风格参数STORAGE_S3_FORCE_PATH_STYLE（MinIO 场景固定为true）、请求最大重试次数STORAGE_S3_MAX_RETRIES（默认 3 次）。AWS S3 与 MinIO 使用同一套 S3 兼容变量。阿里云 OSS 需配置STORAGE_OSS_ENDPOINT、STORAGE_OSS_CNAME、STORAGE_OSS_SECURE等参数，公共存储桶需设置为公开读权限。腾讯云 COS 需配置协议类型STORAGE_COS_PROTOCOL，可选配置全球加速参数STORAGE_COS_USE_ACCELERATE。
快速配置示例（以 MinIO 为例）
- 提前创建名为
fastgpt-public和fastgpt-private的两个存储桶。 - 配置以下环境变量：
```env STORAGE_VENDOR = minio STORAGE_REGION = us-east-1 STORAGEACCESSKEYID = youraccess_key STORAGESECRETACCESSKEY = yoursecret_key STORAGEPUBLICBUCKET = fastgpt-public STORAGEPRIVATEBUCKET = fastgpt-private STORAGES3ENDPOINT = http://fastgpt-minio:9000 STORAGES3FORCEPATHSTYLE = true STORAGES3MAX_RETRIES = 3
``` 注意：STORAGE_EXTERNAL_ENDPOINT需填写服务器和客户端均可访问的宿主机 IP 或域名，请勿使用127.0.0.1或localhost等本地回环地址。若使用 Sealos 的对象存储服务，需将STORAGE_VENDOR设置为minio。
来源：https://doc.fastgpt.cn/zh-CN/self-host/config/object-storage