五分钟为你的AspNetCore项目集成图片服务器

      为何要使用图片服务器？把图片放到本地不就行了？  项目小的时候，这样作固然没有问题；项目大了服务多了，还这样作问题就出来了。好比：
      须要使用缩略图，各个带图片的服务须要本身实现缩略图功能。
      服务引用其余服务图片时，确认使用哪一个域名是个问题（测试环境域名？生产环境域名？换域名了更麻烦）。
      各服务的承载服务器都要留出放图片的空间，不易管理。
      研发没有服务器的权限，想管理图片时只能找 IT 部门。
      ……

      那咱们 .Neter 适合作一个什么样的图片服务器呢？以前本身写过图片服务器，只是简单的把图片存起来，须要缩略图的时候读取出来，裁一下。可是研究了各类方案后，仍是以为 Minio + ImageProxy 的方案是最好的，效率、扩展性、学习曲线几个方面都很好。如何快速在项目中集成这一方案呢？真的能在五分钟内集成吗？真的能，不信您数着。
      先介绍一个开源项目 MinioEx 是本人写的一个对 Minio 的一个很是简单的扩展。
      https://github.com/zl33842901/MinioEx

      下面咱们就跟着项目的 ReadMe 文档，在五分钟内把图片服务器集成到项目里吧。计时开始！

      第一步，下载镜像、下载工具。
      假设如今您有一台 IP 为 172.16.250.147 的 Linux 服务器，已经安装了 docker。那么须要在上面把 Minio 和 ImageProxy 安装起来。若是您不想使用图片缩略功能，那么 ImageProxy 不是必须的。

docker run -d --name minio -p 9100:9000 -v /data/miniodata:/data -e "MINIO_ROOT_USER=admin" -e "MINIO_ROOT_PASSWORD=admin_123.abc" minio/minio server /data

docker run -d --name imageproxy -p 8180:8080 -e "AWS_ACCESS_KEY_ID=admin" -e "AWS_SECRET_KEY=admin_123.abc" willnorris/imageproxy -baseURL http://172.16.250.147:9100/ -addr 0.0.0.0:8080 -cache "s3://us-east-1/thumbs/images?endpoint=172.16.250.147:9100&disableSSL=1&s3ForcePathStyle=1"

      执行上面两条命令后，服务器已经开始下载 Minio 和 ImageProxy 的镜像，下载后会自动跑起来，咱们同时在本地下载一下 Minio 的管理工具 mc.exe。地址：https://dl.min.io/client/mc/release/windows-amd64/mc.exe 若是想下载 linux 或 mac 的，看这里
     第一步耗时一分钟。

     第二步，准备命令行。
     mc.exe 是管理远程 Minio 的工具，有些命令咱们须要准备一下，等步骤一的命令和下载完成后，咱们执行。在 mc.exe 的保存目录，咱们建一个 connect.bat 并输入  mc config host add minio147 http://172.16.250.147:9100 admin admin_123.abc
     解释一下： 这个命令能够认为是链接到远程 Minio 服务器的命令， minio147 是本身命令的别名，以后就用这个名字管理远程的 Minio，能够本身随便起名。admin 是 docker 命令里指定的超管用户名，admin_123.abc 是 docker 命令里指定的超管密码，建议换一下哈，个人这个太简单。而后把个人开源项目根目录里的 newbucket.bat 下载下来，也放到 mc.exe 的保存路径。若是你命名的别名不是“minio147”，你须要编辑一下这个 bat 文件，把第一行的 minio147 换成你命名的别名。
     这个bat 文件的功能有：
      a，建立存储桶
      b，设置存储桶的匿名权限为只读
      c，新增管理员 YourBucketName_admin ，密码为 YourBucketName_123.abc
      d，新增管理策略 YourBucketName_admin_policy，此策略对建立的存储桶具备读写权限
      e，将管理策略 YourBucketName_admin_policy 应用到管理员 YourBucketName_admin。
     第二步耗时一分钟。

    第三步，执行命令。
    这时，第一步的下载镜像、下载工具应该完成了，网慢不要怪我哈，等等就行了。打开命令提示符，目录切到 mc.exe 保存的目录，先执行 connect.bat 链接上 Minio 服务器。而后咱们须要新建一个存储桶，先想一个桶名，能够为这个桶指定一个专有的管理员来上传文档。能够叫 oa 或 crm 等。好比我在这里用 crm 这个名称。而后执行 “newbucket crm” 这个 bat 会帮咱们建桶、把桶设为匿名可读、建立 crm_admin 用户（密码是 crm_123.abc）、建立 crm 的读写权限并赋给 crm_admin。btw 密码能够在 http://172.16.250.147:9100 修改。
    第三步耗时一分钟。

    第四步，集成程序包。
    若是您的项目是 AspNetCore 项目，那么这么作：
    经过 Nuget 引用 xLiAd.MinioEx.AspNetCore 包。在 Startup 类的 ConfigureServices 方法里加入如下代码：

            services.AddMinioEx((sp, options) =>
            {
                var conf = sp.GetService<IConfiguration>();
                options.MinioUrl = conf.GetSection("MinioUrl").Value;
                options.BucketName = conf.GetSection("BucketName").Value;
                options.AccessKey = conf.GetSection("AccessKey").Value;
                options.SecretKey = conf.GetSection("SecretKey").Value;
                options.ImageProxyUrl = conf.GetSection("ImageProxyUrl").Value;
                options.DirectoryPolicy = DirectoryPolicy.ByMonth;
            });

   并在配置文件中加入如下代码：

{
  "MinioUrl": "172.16.250.147:9100",
  "BucketName": "crm",
  "AccessKey": "crm_admin",
  "SecretKey": "crm_123.abc",
  "ImageProxyUrl": "http://172.16.250.147:8180" /*ImageProxy 地址*/
}

    若是您的项目不是 AspNetCore 而是通常的 dotnet 程序，您须要本身实例化对象：

var client = new MinioEx("172.16.250.147:9100", "crm", "crm_admin", "crm_123.abc", "http://172.16.250.147:8180", DirectoryPolicy.None);

    第四步耗时一分钟。

第五步，写代码。
在你接收文件的Controller 里，注入 IMinioEx 实例（不是 AspNetCore 的本身实例化一下），在Action里，好比个人 Action 叫 Upload， 写以下代码：

        public async Task<IActionResult> Upload()
        {
            var file = Request.Form.Files.FirstOrDefault();
            if (file != null)
            {
                using var stream = file.OpenReadStream();
                var result = await minioEx.UploadAsync(stream, System.IO.Path.GetExtension(file.FileName), file.ContentType);
                //生成个缩略图连接
                if(result.Length > 1)
                {
                    var thumb = result[1].Insert(result[1].IndexOf('/', 9) + 1, "200x300");
                    result = result.ToList().Union(new string[] { thumb }).ToArray();
                }
                return Json(new { suc = true, path = result });
            }
            else
                return Json(new { suc = false, msg = "没有上传数据" });
        }

     UploadAsync 返回值是上传后的路径，若是是图片，还会返回 ImageProxy 代理的路径。返回类型是字符串数组，第一个元素固定是 minio 中的地址，若是存在第二个元素，则是 ImageProxy 的文件路径（须要是图片），在路径中增长 option 信息能够对图片进行缩略。
     第五步，耗时一分钟，好了，集成完成。

    能够参照开源项目里的 xLiAd.MinioEx.AspNetCore.Sample 这个项目，思路是同样的。 前端使用了个人另外一个开源项目 zupload.js 。
    怎么样，很简单吧？快来试试吧。