在 OpenWebUI 中使用腾讯云 COS 作为后端存储

开发调优
1

随着 0.5.17 版本的发布，终于可以使用腾讯云 COS 桶作为存储后端，具体配置方式如下

增加环境变量

STORAGE_PROVIDER: "s3"
S3_ADDRESSING_STYLE: "virtual"
S3_ACCESS_KEY_ID: ""
S3_SECRET_ACCESS_KEY: ""
S3_BUCKET_NAME: ""
S3_ENDPOINT_URL: "https://cos.ap-guangzhou.myqcloud.com/"
S3_KEY_PREFIX: "uploads/"
S3_REGION_NAME: "ap-guangzhou"

S3_ACCESS_KEY_ID 和 S3_SECRET_ACCESS_KEY 使用腾讯云的子账户密钥即可，记得去存储桶授权给子账户

S3_BUCKET_NAME 填写存储桶名称

S3_ENDPOINT_URL 按照实际情况进行修改，主要是 ap-guangzhou 这里修改为实际的地域

S3_KEY_PREFIX 按照个人喜好修改就行，不填的话所有文件会传到桶根目录

S3_REGION_NAME 也是按照实际情况修改即可

背景： 对象存储 COS 存储桶域名使用安全管理通知（2024年1月施行）-动态与公告-文档中心-腾讯云

上面的这个政策导致必须使用 virtual path，但是 OpenWebUI 在之前没有支持，这个版本更新加上了

5 Likes
2

这个配置文件适用于阿里云OSS不

3

应该是兼容的，可以试试，不行的话告诉我，我再去提 PR :joy:

如何使用AWSS3SDK访问OSS_对象存储(OSS)-阿里云帮助中心

4

S3应该通用吧？

5

太强了，大佬

6

我翻了 openwebui 的源码，在设置 S3 存储后，上传文件时还是会在本地上传文件。还是会占用本地空间

7

oui更新的好勤啊，前几天才更新的0.5.16

8

是的，因为不是直传，会中转，理论上上传成功后就不需要了

9

那这样子设置S3存储就没意思了呀。设置S3不就是为了不占用本地的空间，结果现在设置S3，带来的就是不止占用本地的，云端的也占一份

10

oi现在输入框还能回到这个样子吗

image
image1758×141 3.26 KB

我是真受不了他更新后的两层框，尤其是在手机上用极为难受

11

可以设置 crontab 定期删除下；如果是使用 pgsql，可以直接不挂载目录，这样每次重启或者更新本地的占用就没了

12

但是删除本地文件之后，我知识库那些内容要使用的话，会用服务器上的吗？

13

好问题我测试下

14

能这么用的话，是不是也能用cloudflare的桶

15

看起来是直接用的 COS 的了

image
image2182×278 67.7 KB

16

兼容 S3 的就能用

1 Like
17

已经上传的文件可能要自行测试下哦

18

好的 我试试

19

只支持文件吗，图片可以吗 :tieba_087:

20

好像不能套cdn