CarrierWave for Aliyun OSS

This gem adds support for Aliyun OSS to CarrierWave

NOTE: 此 Gem 是一个 CarrierWave 的组件，你需要配合 CarrierWave 一起使用，如果你需要直接用 Aliyun OSS，可以尝试用 aliyun-oss-ruby-sdk 这个 Gem。

Using Bundler

gem 'carrierwave-aliyun'

Configuration

创建这么个脚本 config/initializers/carrierwave.rb 填入下面的代码，并修改对应的配置：

CarrierWave.configure do |config|
  config.storage           = :aliyun
  config.aliyun_access_id  = "xxxxxx"
  config.aliyun_access_key = 'xxxxxx'
  # 你需要在 Aliyum OSS 上面提前创建一个 Bucket
  config.aliyun_bucket     = "simple"
  # 是否使用内部连接，true - 使用 Aliyun 主机内部局域网的方式访问  false - 外部网络访问
  config.aliyun_internal   = true
  # 配置存储的地区数据中心，默认: cn-hangzhou
  # config.aliyun_area     = "cn-hangzhou"
  # 使用自定义域名，设定此项，carrierwave 返回的 URL 将会用自定义域名
  # 自定于域名请 CNAME 到 you_bucket_name.oss-cn-hangzhou.aliyuncs.com (you_bucket_name 是你的 bucket 的名称)
  config.aliyun_host       = "https://foo.bar.com"
  # Bucket 为私有读取请设置 true，默认 false，以便得到的 URL 是能带有 private 空间访问权限的逻辑
  # config.aliyun_private_read = false
end

阿里云 OSS 图片缩略图

NOTE: 此方法同样支持 Private 的 Bucket 哦！

关于阿里云 OSS 图片缩略图的详细文档，请仔细阅读: Aliyun OSS 接入图片服务

irb> User.last.avatar.url(thumb: '?x-oss-process=image/resize,h_100')
"https://simple.oss-cn-hangzhou.aliyuncs.com/users/avatar/12.png?x-oss-process=image/resize,h_100"
irb> User.last.avatar.url(thumb: '?x-oss-process=image/resize,h_100,w_100')
"https://simple.oss-cn-hangzhou.aliyuncs.com/users/avatar/12.png?x-oss-process=image/resize,h_100,w_100"

增对文件设置 Content-Disposition

在文件上传的场景（非图片），你可能需要给上传的文件设置 Content-Disposition 以便于用户直接访问 URL 的时候能够用你期望的文件名或原文件名来下载并保存。

这个时候你需要给 Uploader 实现 content_disposition 函数，例如：

# app/uploaders/attachment_uploader.rb
class AttachmentUploader < CarrierWave::Uploader::Base
  def content_disposition
    # 非图片文件，给 content_disposition
    unless file.extension.downcase.in?(%w(jpg jpeg gif png svg))
      "attachment;filename=#{file.original_filename}"
    end
  end
end

通过 CDN 获取文件

当需要大量分发文件时( 活动海报, apk ), CDN 的流量费用大概只有 OSS 的一半. 客户端访问 CDN, CDN 回源 OSS 的方式, 可以节省不少成本.

在 config/initializers/carrierwave.rb 增加配置:

CarrierWave.configure do |config|
  config.cdn_host = 'http://cdn-host.com'
end

这样之后, 就可以做到: