阿里云对象存储 OSS

当前，以演示站点域名moredoc.mnt.ltd和对象存储绑定的域名static.moredoc.mnt.ltd来作为配置演示，其他配置项仅作为参考。

步骤

1. 开通阿里云对象存储OSS

地址：https://www.aliyun.com/product/oss

阿里云对象存储 OSS - 图1

2. 创建私有 Bucket

地址：https://oss.console.aliyun.com/bucket

阿里云对象存储 OSS - 图2

2.1 注意事项(2024-06-14)

今天帮客户部署的时候，发现阿里云对象存储OSS突然多了一项阻止公共访问的配置项，请把它关闭。

阿里云对象存储 OSS - 图3

如果已开启，则在对象存储相应Bucket下的权限控制里关闭。

阿里云对象存储 OSS - 图4

因为bucket设置为私有，但是我们在存储图片的时候，需要通过API来将图片设置为公共读，如果开启了这个功能，会导致图片等相关资源转存失败！！！

3. 创建Access Key

地址： https://ram.console.aliyun.com/manage/ak

如已有Access Key，则可跳过创建

阿里云对象存储 OSS - 图5

4. 配置

修改 app.toml 下的cloudStore

  1. [cloudStore]
  2.     # 存储类型，填oss，即阿里云对象存储
  3.     storeType = "oss"
  5.     # 存储绑定的域名，带 http:// 或 https:// ，可以为空。
  6.     domain = "https://static.moredoc.mnt.ltd"
  8.     # 阿里云的 AccessKey ID
  9.     accessKey = "AccessKey ID"
  11.     # 阿里云的 AccessKey Secret
  12.     secretKey = "AccessKey Secret"
  14.     # 对象存储的bucket
  15.     bucket = "moredoc-private"
  17.     # 对象存储 endpoint
  18.     endpoint = "oss-cn-shenzhen.aliyuncs.com"

5. 迁移与重启

迁移本地的 uploads和 documents 到对象存储

  1. ./moredoc migrateCloudstore

重启文库程序。

配置参考

完整配置参考示例如下：

  1. # 程序运行级别：debug、info、warn、error，生产环境使用 info及其以上级别
  2. level = "debug"
  4. # 日志编码方式，支持：json、console
  5. logEncoding = "console"
  7. # 程序运行端口
  8. port = "8880"
  10. # 数据库配置
  11. [database]
  12.     driver = "mysql"
  13.     dsn = "root:root@tcp(localhost:3306)/moredoc?charset=utf8mb4&loc=Local&parseTime=true"
  14.     showSQL = true
  15.     maxOpen = 10
  16.     maxIdle = 10
  18. # JSON Web Token 配置
  19. [jwt]
  20.     # 生成 token 的密钥，请务必修改！！！
  21.     secret = "moredoc"
  22.     # token 过期时间
  23.     expireDays = 365
  25. [cloudStore]
  26.     # 存储类型，填oss，即阿里云对象存储
  27.     storeType = "oss"
  28.     # 存储绑定的域名，带 http:// 或 https:// ，可以为空。
  29.     domain = "https://static.moredoc.mnt.ltd"
  30.     # 阿里云的 AccessKey ID
  31.     accessKey = "AccessKey ID"
  32.     # 阿里云的 AccessKey Secret
  33.     secretKey = "AccessKey Secret"
  34.     # 对象存储的bucket
  35.     bucket = "moredoc-private"
  36.     # 对象存储 endpoint
  37.     endpoint = "oss-cn-shenzhen.aliyuncs.com"