Skip to content

接入七牛云OSS服务

文件存储采用七牛云的OSS(对象存储服务)

这部分将手把手介绍如何在本项目中接入七牛云OSS

为什么使用七牛云?

  • 因为资费便宜,还有30G的免费额度

1. 账号注册

访问七牛云-注册页面 注册一个账号

2. 创建存储空间

访问七牛云-对象存储

戳页面上的立即使用

新建空间,输入一些必要的数据

其中访问控制一定记得选私有,避免文件不通过鉴权就被下载

TIP

  • 存储空间名即为,后端服务中.envQINIU_BUCKET_NAME的值
  • 存储区域对应后端服务.envQINIU_BUCKET_ZONE的值

QINIU_BUCKET_ZONE可选值如下

存储区域
华东huadong
华北huabei
华南huanan
北美beimei
东南亚SoutheastAsia

创建成功提示,测试域名有30天有效期

如果需要长期使用,建议绑定一个自定义域名,

我没有域名怎么办

当然如果你没有域名,可以联系作者,提供一个.sugarat.top下的3级,4级域名

3. 获取到域名

进入我们创建的空间easypicker-test,就能看到提供的测试域名

TIP

域名即为后端服务中.envQINIU_BUCKET_DOMAIN的值

注意:这里的值需要加上协议

  • 注意:这里的值需要加上协议http://你的域名
  • 注意:这里的值需要加上协议http://你的域名
  • 注意:这里的值需要加上协议http://你的域名
    • 如果升级了https,这里对应填入https

4. 获取ack与sek

重要提示!!!

这两个东西千万不要泄露!!!

这两个东西千万不要泄露!!!

当然泄漏了可自己进行重置

获取位置如下

控制面板右上角,的秘钥管理

接下来就能看到

TIP

  • AK 对应.env中的 QINIU_ACCESS_KEY
  • SC 对应.env中的 QINIU_SECRET_KEY

5. 通过面板快速更新配置

到此七牛云相关的 5 个必要需要的环境变量我们都拿到了

  • QINIU_BUCKET_ZONE
  • QINIU_BUCKET_NAME
  • QINIU_BUCKET_DOMAIN
  • QINIU_ACCESS_KEY
  • QINIU_SECRET_KEY

将其更新到管理面板中七牛云配置的位置即可

如果应用版本 < v2.1.9,需要手动更新

手动将上述配置内容填写到,后端服务中.env中对应位置,然后重启服务即可

6. 添加必要响应头信息

目的:避免图片,pdf,txt等浏览器支持预览的文件直接被预览而不触发下载

首先找到对应的存储空间,选择绑定的域名查看详情

在打开的详情页面中找到 HTTP响应头配置

添加一条规则,然后点击确定即可

sh
Content-Disposition attachment

7. 设置图片样式(可选)

现在手机拍摄的图片往往都很大,动辄10几兆,为了加快图片的预览与节省服务带宽可以配置七牛云的图片样式进行裁剪

点击新建图片样式,然后根据指引操作,完成创建

共需要两个样式,一个缩略图一个预览图,下面是场景示例

缩略图预览图

设置样式分隔符

在配置面板中更新即可

  • 注意
    • 不同存储空间之间的样式不互通
    • 填入格式是分隔符+样式名

完成配置后重启服务即可

如果应用版本 < v2.1.9,需要手动在配置文件中更新

将创建好的样式名和分隔符,填入到服务端的环境变量中

8. 绑定自定义域名(可选)

在存储空间里找到域名管理,点击绑定域名即可

域名输入一个自己域名对应的2/3/4级域名均可

  • 例如:sugarat.top
    • 3级域名: ep.sugarat.top
    • 4级域名: ep.test.sugarat.top
    • 5级: ep.test.file.sugarat.top

填写完成后点击创建即可,然后按照要求添加域名解析

可以自行阅读七牛云提供的域名绑定文档完成

有其它问题可以小群交流,方便可以加入及时交流沟通问题: 685446473