.NET通过HTTP操作MINIO

MINIO 是一个高性能的分布式对象存储服务，兼容 Amazon S3 API。很多团队在私有化部署时用它来替代 S3，或者作为图床、备份存储。虽然官方提供了 .NET SDK，但有时候我们不想引入额外的依赖，或者需要更底层的控制（比如自定义签名、调试请求），这时候直接用 HTTP 请求来操作 MINIO 也是完全可行的。本文就用 .NET 的 HttpClient 来演示如何通过 HTTP 完成 MINIO 的核心操作：上传、下载、删除和生成临时链接。全程不依赖官方 SDK，只靠标准库。### 1. 准备工作：MINIO 的 HTTP 接口长什么样？MINIO 的 API 是基于 HTTP 的，所有操作都是对 /{bucket}/{object} 路径发送不同方法的请求。比如：- 上传对象：PUT /my-bucket/photo.jpg- 下载对象：GET /my-bucket/photo.jpg- 删除对象：DELETE /my-bucket/photo.jpg- 获取对象元数据：HEAD /my-bucket/photo.jpg但光有路径还不够，MINIO 要求每个请求都要带上签名（Signature），否则会返回 403 Forbidden。签名是基于 AccessKey、SecretKey 和请求参数计算出来的，最简单的做法是使用 AWS Signature Version 4（SigV4）。不过，我们不用手动实现 SigV4，因为 MINIO 提供一个更简单的临时凭证接口（PresignedURL），基于这个 URL 可以直接发起请求，不用自己算签名。这个方案非常适合生成临时上传/下载链接。### 2. 用 HttpClient 实现一个简单的 MINIO 客户端我们封装一个 MinioHttpClient 类，核心功能是：- 生成预签名 URL（上传/下载）- 用预签名 URL 上传文件- 用预签名 URL 下载文件- 删除对象（需要签名，我们直接用 Admin API 或者通过 SDK 生成签名，这里为了简单，我们会用预签名 URL 来删除------但 MINIO 的 DELETE 操作也支持预签名）下面这个示例展示了如何生成一个预签名 PUT URL，然后通过 HTTP 上传一个文本文件。csharpusing System;using System.Net.Http;using System.Threading.Tasks;public class MinioHttpClient{ private readonly HttpClient _httpClient; private readonly string _endpoint; // 例如 "http://localhost:9000" private readonly string _accessKey; private readonly string _secretKey; public MinioHttpClient(string endpoint, string accessKey, string secretKey) { _httpClient = new HttpClient(); _endpoint = endpoint.TrimEnd('/'); _accessKey = accessKey; _secretKey = secretKey; } // 生成预签名 URL（这里仅演示 PUT 方法） public string GeneratePresignedPutUrl(string bucket, string objectName, int expiresInSeconds = 3600) { // 注意：这里为了演示，直接用 MINIO 的 presigned API 生成 URL // 但官方推荐使用 SigV4 签名，不过我们为了简化，先通过调用 MINIO 的 presigned 接口生成 // 实际生产环境请实现 SigV4 签名算法 var presignedUrl = $"{_endpoint}/{bucket}/{objectName}?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential={_accessKey}%2F20250101%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250101T000000Z&X-Amz-Expires={expiresInSeconds}&X-Amz-SignedHeaders=host&X-Amz-Signature=example"; // 这里只是为了演示，实际签名需要正确计算，否则请求会 403 throw new NotImplementedException("这里应该实现 SigV4 签名，或者使用 MINIO SDK 的 PresignedPutObject 方法"); } // 上传文件到 MINIO（通过预签名 URL） public async Task<bool> UploadFileAsync(string presignedUrl, byte[] content, string contentType = "application/octet-stream") { using var contentData = new ByteArrayContent(content); contentData.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue(contentType); var response = await _httpClient.PutAsync(presignedUrl, contentData); return response.IsSuccessStatusCode; }}注意：上面的 GeneratePresignedPutUrl 方法故意不实现真正的签名，因为 SigV4 比较复杂，建议直接用官方 SDK 或参考 MINIO 文档。但这里想说明的是：HTTP 上传的本质就是发一个 PUT 请求，URL 带签名参数即可。### 3. 实战：用预签名 URL 上传文件为了能真正跑起来，我们可以使用 MINIO 的官方 .NET SDK 来生成预签名 URL（因为 SDK 内部处理了 SigV4），然后用我们自己的 HttpClient 来上传。这样既演示了 HTTP 操作，又避免重复造轮子。先安装 SDK：bashdotnet add package Minio.NetCore然后生成预签名 URL，再通过 HTTP 上传：csharpusing Minio;using Minio.DataModel.Args;using System;using System.Net.Http;using System.Threading.Tasks;class Program{ static async Task Main(string[] args) { var minioClient = new MinioClient() .WithEndpoint("localhost:9000") .WithCredentials("minioadmin", "minioadmin") .Build(); // 1. 生成预签名 PUT URL（有效期 1 小时） var presignedUrl = await minioClient.PresignedPutObjectAsync( new PresignedPutObjectArgs() .WithBucket("my-bucket") .WithObject("hello.txt") .WithExpiry(3600)); Console.WriteLine($"预签名 URL: {presignedUrl}"); // 2. 使用 HttpClient 上传 var httpClient = new HttpClient(); var content = new StringContent("Hello, MINIO via HTTP!"); var response = await httpClient.PutAsync(presignedUrl, content); if (response.IsSuccessStatusCode) { Console.WriteLine("上传成功！"); } else { Console.WriteLine($"上传失败: {response.StatusCode} - {await response.Content.ReadAsStringAsync()}"); } }}这段代码做的事情：1. 用 SDK 生成一个预签名的 PUT URL（注意，SDK 已经帮你算好了 SigV4 签名）。2. 直接用 HttpClient.PutAsync 向这个 URL 发送请求。3. 因为 URL 本身携带签名，MINIO 会认为是合法请求，从而允许上传。为什么不用 SDK 直接上传？ 因为有些场景下你可能想用自定义的 HTTP 客户端（比如配合重试策略、自定义日志、代理），或者你的代码环境不允许引入 SDK 的完整依赖（比如 Unity、嵌入式）。通过预签名 URL，你可以把签名生成和传输逻辑分离。### 4. 下载文件：同样用预签名 URL下载也类似，先生成一个 GET 预签名 URL，然后用 HttpClient.GetAsync 获取流。csharpusing Minio;using Minio.DataModel.Args;using System;using System.IO;using System.Net.Http;using System.Threading.Tasks;class DownloadExample{ static async Task Main(string[] args) { var minioClient = new MinioClient() .WithEndpoint("localhost:9000") .WithCredentials("minioadmin", "minioadmin") .Build(); // 生成预签名 GET URL var presignedGetUrl = await minioClient.PresignedGetObjectAsync( new PresignedGetObjectArgs() .WithBucket("my-bucket") .WithObject("hello.txt") .WithExpiry(3600)); Console.WriteLine($"下载 URL: {presignedGetUrl}"); // 用 HttpClient 下载 using var httpClient = new HttpClient(); using var response = await httpClient.GetAsync(presignedGetUrl); response.EnsureSuccessStatusCode(); var contentBytes = await response.Content.ReadAsByteArrayAsync(); var text = System.Text.Encoding.UTF8.GetString(contentBytes); Console.WriteLine($"下载内容: {text}"); // 也可以保存为文件 await File.WriteAllBytesAsync("downloaded.txt", contentBytes); }}这里的关键点：- PresignedGetObjectAsync 生成一个带签名的 GET URL。- HttpClient.GetAsync 直接下载，不需要额外认证。- 适合用于浏览器直链下载、CDN 回源等场景。### 5. 删除对象：用 HTTP DELETE 请求删除操作也可以走预签名 URL，但 MINIO 的预签名 DELETE 支持不是所有版本都有，建议直接用 SDK 或者用 Admin API。不过我们可以自己构造一个 DELETE 请求，但需要签名，所以这里还是用 SDK 生成预签名 DELETE URL（如果 SDK 支持的话）。但为了演示，我们直接调用 SDK 删除，因为 HTTP 删除的本质就是发 DELETE 请求，但签名麻烦，不如直接用 SDK。csharpusing Minio;using Minio.DataModel.Args;using System;using System.Threading.Tasks;class DeleteExample{ static async Task Main(string[] args) { var minioClient = new MinioClient() .WithEndpoint("localhost:9000") .WithCredentials("minioadmin", "minioadmin") .Build(); var args = new RemoveObjectArgs() .WithBucket("my-bucket") .WithObject("hello.txt"); await minioClient.RemoveObjectAsync(args); Console.WriteLine("对象已删除"); }}如果你真的想用纯 HTTP 删除，可以自己实现 SigV4，但那样代码量会很大，而且容易出错。所以实际开发中，删除操作建议用 SDK 或直接调用 MINIO 的 Admin API（如果权限允许）。### 6. 注意事项- 签名算法 ：预签名 URL 的签名是有时效性的（默认 1 小时），过期后需要重新生成。如果文件很大，上传时间超过有效期，会导致上传失败。- Bucket 必须存在 ：上传前确保 bucket 已创建，否则会报 NoSuchBucket。- Endpoint 地址 ：如果 MINIO 用的是 HTTPS，记得写成 https://。- 网络代理 ：如果环境有代理，HttpClient 需要配置代理，否则请求可能失败。### 7. 总结通过 HTTP 操作 MINIO 的核心思路就是：用预签名 URL 携带签名，然后用普通的 HTTP 客户端发送请求。这样既避开了自己实现 SigV4 的复杂性，又保持了灵活性。适合以下场景：- 前端直传（浏览器生成预签名 URL，然后通过 AJAX 上传）- 服务间集成（用 HttpClient 下载/上传）- 不想引入 SDK 的轻量客户端当然，如果对性能要求极高或者需要复杂操作（如分片上传、生命周期管理），还是建议用官方 SDK，因为它在底层做了很多优化和错误处理。但本文展示的方法足以应对绝大多数日常操作需求。希望这篇文章能帮你理解 .NET 与 MINIO 交互的另一种姿势。如果你有更多问题，欢迎在评论区交流！