七牛云对象存储

# 七牛云对象存储

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

# 开源地址

https://github.com/luoyunchong/dotnetcore-examples/tree/master/aspnetcore-qiniu (opens new window)

# 集成类库

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

# 前提

  • 本地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/"
  }
1
2
3
4
5
6
7

# 安装包

Install-Package MQiniu.Core 
1

# 代码解读

配置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 = "上传失败" };
        }
    }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

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

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

1
2
3
4
5
6

# 发布至Linux下的Docker

双击 publish.bat,生成的文件夹为如下:

image

修改项目名为qiniu-web,复制 至linux服务器中,(xftp工具) image

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

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

前置条件,在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端口
1
2

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

本项目已部署至服务器 http://122.152.192.161:5000/swagger/index.html (opens new window)

# 运行结果

image.png

# 参考