七牛云对象存储

.NET Core 下集成 七牛云下的对象存储

开源地址

OvOv.MQiniu.Core

集成类库

基础类库集成方案	开源地址	文档	说明
Qiniu 云对象存储	.net/.net core	c# sdk	由于官网未支持. net core，所以 大家看社区版解决方案

前提

• 本地 windows 10,安装 .net core 2.2+
• Linux 服务器 Ubuntu Server 16+
• 服务器安装了 Docker
• 本地 xftp、xshell（这二个分别是 windows 传文件至 linux，执行命令行。）

准备

在七牛云中自行注册后，在个人中心，密钥管理，生成自己的密钥（https://portal.qiniu.com/user/key） v* AK，SK 分别代表：AccessKey/SecretKey

• Bucket 中的 vant-ui，是创建对象存储时起的名字
• PrefixPath 中的值，随意字符串，前缀地址。
• Host 为：融合 CDN 测试域名,可自行绑定自己的域名，否则只有三十天免费使用时长。

appsettings.json 配置项

  "Qiniu": {
    "AK": "eUH1O-ft66S4XM2GIK7FGmj7czuYkcAyNGDAc-wq",
    "SK": "4dOi1daSr2-YgofhAfWb8JaLrbgozCmgD6AUmmM9",
    "Bucket": "vant-ui",
    "PrefixPath": "ui",
    "Host": "http://pu5vnz60k.bkt.clouddn.com/"
  }

安装包

Install-Package MQiniu.Core

代码解读

配置 swagger 的过程就不说了，创建 QiniuController

  /// <summary>
    /// 七牛云上传服务
    /// </summary>
    [Route("api/[controller]")]
    [ApiController]
    public class QiniuController : ControllerBase
    {
        private readonly IConfiguration _configuration;

        public QiniuController(IConfiguration configuration)
        {
            _configuration = configuration;
        }

        /// <summary>
        /// 根据后台配置项，得到请求七牛云的token值，前台也可根据此token值上传至七牛云服务
        /// </summary>
        /// <returns></returns>
        [HttpGet("access_token")]
        public string GetAccessToken()
        {
            Mac mac = new Mac(_configuration["Qiniu:AK"], _configuration["Qiniu:SK"]);
            PutPolicy putPolicy = new PutPolicy { Scope = _configuration["Qiniu:Bucket"] };
            return Auth.CreateUploadToken(mac, putPolicy.ToJsonString());
        }

        /// <summary>
        /// 上传文件至七牛云,code为200，代表上传成功,其他代表不成功
        /// </summary>
        /// <param name="file">单个文件</param>
        /// <returns>new { code = 200, data ="七牛云文件地址，包括http://....mm.png", msg = "上传成功" };</returns>
        [HttpPost("upload")]
        public dynamic Upload(IFormFile file)
        {
            if (file.Length == 0)
            {
                return new { code = 1, msg = "文件为空" };
            }

            FormUploader upload = new FormUploader(new Config()
            {
                Zone = Zone.ZONE_CN_South,//华南
                UseHttps = true
            });

            var fileName = ContentDispositionHeaderValue
                .Parse(file.ContentDisposition)
                .FileName.Trim();

            string qiniuName = _configuration["Qiniu:PrefixPath"] + "/" + DateTime.Now.ToString("yyyyMMddHHmmssffffff") + fileName;
            Stream stream = file.OpenReadStream();
            HttpResult result = upload.UploadStream(stream, qiniuName, GetAccessToken(), null);

            if (result.Code == 200)
            {
                return new { code = 200, data = _configuration["Qiniu:Host"] + qiniuName, msg = "上传成功" };
            }

            return new { code = 1, msg = "上传失败" };
        }
    }

Upload 方法中，Zone.ZONE_CN_South，代表华南，所以创建对象存储时要注意，请选择与此相同的位置（华南），或根据实际情况修改 Zone 所在地区的枚举值即可。

FormUploader upload = new FormUploader(new Config()
{
    Zone = Zone.ZONE_CN_South,//华南
    UseHttps = true
});

发布至 Linux 下的 Docker

双击 publish.bat，生成的文件夹为如下：

修改项目名为 qiniu-web，复制 至 linux 服务器中，（xftp 工具）

使用 xshell 远程登录后，进入 root 权限。

root@VM-37-104-ubuntu:/home/ubuntu/# sudo su
root@VM-37-104-ubuntu:/home/ubuntu/# cd qiniu-web

前置条件，在 ubuntu 上安装好了 docker。并且正常运行。

-d 代表后台运行，此时将对外显露 5000 端口运行，5000 是运行后，docker 对外的端口，80 是这个服务对外的端口，其中 Dockerfile 存在语句 EXPOSE 80

docker build -t igeekfan/qiniu .     #生成images
docker run -d -p 5000:80 igeekfan/qiniu  # 生成 container 并运行在5000端口

此时打开 浏览器， ip+端口 5000 即可访问服务，请加/swagger。

本项目已部署至服务器 http://122.152.192.161:5000/swagger/index.html

运行结果

参考

• .NET Core 版本七牛云 SDK 使用https://www.cnblogs.com/OMango/p/8447480.html
• .NET Core 部署至 Linux 下的 Docker http://blog.igeekfan.cn/2019/06/09/dotnetcore/aspnetcore-Deploy-To-Docker-Ubuntu/