.NET4通过HTTP操作MINIO

MINIO是提供.NET SDK的，但是这么老的版本没找到，于是使用http的方式直接调用，方便简单。

我这里需求不复杂，只需要上传下载删除即可，如果后续有需求再补充方法。

核心代码MinioHttpOperatorDemo如下:

using System; using System.IO; using System.Net; using System.Text; using System.Collections.Specialized; // For NameValueCollection, though not directly used in this version, good to keep for potential expansion. using System.Security.Cryptography; // For HMACSHA256, SHA256Managed using System.Globalization; // For CultureInfo.InvariantCulture using System.Collections.Generic; // For SortedList using System.Linq; // For string.Join and other LINQ operations using System.Xml.Linq;  namespace MinioHttpOperatorDemo {     /// <summary>     /// MinIO HTTP 操作类，适用于 .NET Framework 4.0 环境，不依赖 MinIO SDK。     /// 使用 HttpWebRequest 和 HttpWebResponse 进行文件上传、下载和删除操作。     /// 已加入 AWS Signature Version 4 认证的简化实现，并进行了进一步的完善。     /// </summary>     public class MinioHttpOperator     {         private readonly string _minioEndpoint; // MinIO 服务器的端点地址，例如: http://localhost:9000         private readonly string _accessKey;     // MinIO Access Key         private readonly string _secretKey;     // MinIO Secret Key         private readonly string _region;        // S3 兼容 API 需要的区域，MinIO 通常用 "us-east-1"         private readonly string _service;       // S3 兼容 API 需要的服务名称，通常是 "s3"          /// <summary>         /// 构造函数，初始化 MinIO 操作器。         /// </summary>         /// <param name="minioEndpoint">MinIO 服务器的 URL，例如 "http://localhost:9000"</param>         /// <param name="accessKey">Access Key，用于认证。</param>         /// <param name="secretKey">Secret Key，用于认证。</param>         /// <param name="region">S3 兼容 API 需要的区域，默认为 "us-east-1"。</param>         /// <param name="service">S3 兼容 API 需要的服务名称，默认为 "s3"。</param>         public MinioHttpOperator(string minioEndpoint, string accessKey, string secretKey, string region = "cn-north-1", string service = "s3")         {             // 移除末尾的斜杠，确保 URL 格式正确             _minioEndpoint = minioEndpoint.TrimEnd('/');             _accessKey = accessKey;             _secretKey = secretKey;             _region = region;             _service = service;              if (string.IsNullOrEmpty(_accessKey) || string.IsNullOrEmpty(_secretKey))             {                 // 抛出异常而不是警告，因为没有凭据就无法认证                 throw new ArgumentNullException("AccessKey 和 SecretKey 不能为空，因为需要进行认证。");             }         }          /// <summary>         /// 上传文件到 MinIO。         /// </summary>         /// <param name="bucketName">目标桶的名称。</param>         /// <param name="objectName">在桶中保存的对象名称（包含路径，例如 "myfolder/myfile.txt"）。</param>         /// <param name="filePath">本地待上传文件的完整路径。</param>         /// <param name="contentType">文件的 MIME 类型，例如 "application/octet-stream"、"image/jpeg"、"text/plain"。</param>         /// <returns>如果上传成功返回 true，否则返回 false。</returns>         public bool UploadFile(string bucketName, string objectName, string filePath, string contentType = "application/octet-stream")         {             try             {                 if (!File.Exists(filePath))                 {                     Console.WriteLine($"错误：文件未找到，路径：{filePath}");                     return false;                 }                  string url = $"{_minioEndpoint}/{bucketName}/{objectName}";                 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);                 request.Method = "PUT";                 request.ContentType = contentType;                  // 计算文件内容的 SHA256 哈希值                 string contentHash;                 using (FileStream fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read))                 {                     using (SHA256 sha256 = new SHA256Managed())                     {                         byte[] hashBytes = sha256.ComputeHash(fileStream);                         contentHash = BitConverter.ToString(hashBytes).Replace("-", "").ToLowerInvariant();                     }                     fileStream.Position = 0; // 重置流位置以便后续读取                     request.ContentLength = fileStream.Length; // 设置请求内容长度                      // 签名请求                     SignRequest(request, bucketName, objectName, contentHash);                      // 获取请求流并写入文件内容                     using (Stream requestStream = request.GetRequestStream())                     {                         byte[] buffer = new byte[4096]; // 4KB 缓冲区                         int bytesRead;                         while ((bytesRead = fileStream.Read(buffer, 0, buffer.Length)) > 0)                         {                             requestStream.Write(buffer, 0, bytesRead);                         }                     }                 }                  using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())                 {                     if (response.StatusCode == HttpStatusCode.OK)                     {                         Console.WriteLine($"成功上传文件 {objectName} 到桶 {bucketName}。");                         return true;                     }                     else                     {                         Console.WriteLine($"上传文件 {objectName} 失败。状态码：{response.StatusCode}");                         return false;                     }                 }             }             catch (WebException webEx)             {                 HandleWebException(webEx, "上传");                 return false;             }             catch (Exception ex)             {                 Console.WriteLine($"上传时发生未知错误：{ex.Message}");                 return false;             }         }          /// <summary>         /// 从 MinIO 下载文件。         /// </summary>         /// <param name="bucketName">源桶的名称。</param>         /// <param name="objectName">要下载的对象名称。</param>         /// <param name="savePath">本地保存文件的完整路径。</param>         /// <returns>如果下载成功返回 true，否则返回 false。</returns>         public bool DownloadFile(string bucketName, string objectName, string savePath)         {             try             {                 string url = $"{_minioEndpoint}/{bucketName}/{objectName}";                 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);                 request.Method = "GET";                  // 对于 GET 请求，payload hash 是固定的空字符串的 SHA256 哈希                 string contentHash = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"; // SHA256("")                  SignRequest(request, bucketName, objectName, contentHash);                  using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())                 {                     if (response.StatusCode == HttpStatusCode.OK)                     {                         using (Stream responseStream = response.GetResponseStream())                         using (FileStream fileStream = new FileStream(savePath, FileMode.Create, FileAccess.Write))                         {                             byte[] buffer = new byte[4096];                             int bytesRead;                             while ((bytesRead = responseStream.Read(buffer, 0, buffer.Length)) > 0)                             {                                 fileStream.Write(buffer, 0, bytesRead);                             }                         }                         Console.WriteLine($"成功下载文件 {objectName} 到 {savePath}。");                         return true;                     }                     else                     {                         Console.WriteLine($"下载文件 {objectName} 失败。状态码：{response.StatusCode}");                         return false;                     }                 }             }             catch (WebException webEx)             {                 HandleWebException(webEx, "下载");                 return false;             }             catch (Exception ex)             {                 Console.WriteLine($"下载时发生未知错误：{ex.Message}");                 return false;             }         }          /// <summary>         /// 从 MinIO 删除文件。         /// </summary>         /// <param name="bucketName">文件所在桶的名称。</param>         /// <param name="objectName">要删除的对象名称。</param>         /// <returns>如果删除成功返回 true，否则返回 false。</returns>         public bool DeleteFile(string bucketName, string objectName)         {             try             {                 string url = $"{_minioEndpoint}/{bucketName}/{objectName}";                 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);                 request.Method = "DELETE";                  // 对于 DELETE 请求，payload hash 是固定的空字符串的 SHA256 哈希                 string contentHash = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"; // SHA256("")                  SignRequest(request, bucketName, objectName, contentHash);                  using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())                 {                     // 成功的 DELETE 请求通常返回 204 No Content                     if (response.StatusCode == HttpStatusCode.NoContent)                     {                         Console.WriteLine($"成功删除文件 {objectName} 从桶 {bucketName}。");                         return true;                     }                     else                     {                         Console.WriteLine($"删除文件 {objectName} 失败。状态码：{response.StatusCode}");                         return false;                     }                 }             }             catch (WebException webEx)             {                 HandleWebException(webEx, "删除");                 return false;             }             catch (Exception ex)             {                 Console.WriteLine($"删除时发生未知错误：{ex.Message}");                 return false;             }         }           /// <summary>         /// 处理 Web 请求异常并输出详细信息。         /// </summary>         /// <param name="webEx">WebException 实例。</param>         /// <param name="operation">发生异常的操作名称（例如："上传"、"下载"）。</param>         private void HandleWebException(WebException webEx, string operation)         {             if (webEx.Response != null)             {                 using (StreamReader reader = new StreamReader(webEx.Response.GetResponseStream()))                 {                     string responseText = reader.ReadToEnd();                     Console.WriteLine($"{operation}时发生 Web 异常：{webEx.Message}。状态码：{(int)((HttpWebResponse)webEx.Response).StatusCode}。响应内容：{responseText}");                 }             }             else             {                 Console.WriteLine($"{operation}时发生 Web 异常：{webEx.Message}");             }         }          /// <summary>         /// 为 HttpWebRequest 签名 AWS Signature Version 4 认证头部。         /// 这是 AWS Signature Version 4 规范的简化实现，旨在与 MinIO 兼容。         /// </summary>         /// <param name="request">要签名的 HttpWebRequest 实例。</param>         /// <param name="bucketName">桶名称。</param>         /// <param name="objectName">对象名称。</param>         /// <param name="contentHash">请求体的 SHA256 哈希值。</param>         private void SignRequest(HttpWebRequest request, string bucketName, string objectName, string contentHash)         {             // --- 步骤 1: 创建 Canonical Request ---              // 1.1 HTTP 方法             string httpRequestMethod = request.Method;              // 1.2 Canonical URI             // 对象名必须进行 URI 编码，但斜杠 (/) 作为路径分隔符不能被编码。             // Uri.EscapeDataString 会编码 '/' 为 '%2F'，需要将其替换回来。             // 确保 objectName 不以斜杠开头，因为 canonicalUri 会添加一个。             string cleanedObjectName = objectName.StartsWith("/") ? objectName.Substring(1) : objectName;             string encodedObjectName = Uri.EscapeDataString(cleanedObjectName).Replace("%2F", "/");             string canonicalUri = $"/{bucketName}/{encodedObjectName}";              // 1.3 Canonical Query String (本示例不处理查询参数，因此为空)             string canonicalQueryString = "";              // 1.4 Canonical Headers             // 头部名称必须小写，并按字典序排序。             // 头部值必须去除前导/尾随空格，多个空格替换为单个空格。             // Host 头部必须包含端口（如果是非默认端口）。             var headersToSign = new SortedList<string, string>();              // Host 头部             string hostHeaderValue = request.RequestUri.Host;             if (!request.RequestUri.IsDefaultPort)             {                 hostHeaderValue += ":" + request.RequestUri.Port;             }             headersToSign.Add("host", hostHeaderValue);              // x-amz-content-sha256 头部             headersToSign.Add("x-amz-content-sha256", contentHash);              // x-amz-date 头部             DateTime requestDateTime = DateTime.UtcNow;             string amzDate = requestDateTime.ToString("yyyyMMddTHHmmssZ", CultureInfo.InvariantCulture);             headersToSign.Add("x-amz-date", amzDate);              // Content-Type 头部 (仅用于 PUT/POST 请求)             if (request.Method == "PUT" || request.Method == "POST")             {                 string actualContentType = request.ContentType;                 if (string.IsNullOrEmpty(actualContentType))                 {                     actualContentType = "application/octet-stream"; // 签名时使用的默认 Content-Type                 }                 headersToSign.Add("content-type", actualContentType);             }              // 构建 canonicalHeaders 字符串             StringBuilder canonicalHeadersBuilder = new StringBuilder();             foreach (var header in headersToSign)             {                 canonicalHeadersBuilder.AppendFormat(CultureInfo.InvariantCulture, "{0}:{1}n", header.Key, header.Value.Trim()); // trim header values             }             string canonicalHeaders = canonicalHeadersBuilder.ToString();              // 1.5 Signed Headers             // 包含在规范化头部中所有头部名称的列表，小写，按字典序排序，用分号分隔。             string signedHeaders = string.Join(";", headersToSign.Keys.ToArray());              // 1.6 Payload Hash (已在方法参数中提供)              // 1.7 组合 Canonical Request             string canonicalRequest = string.Format(CultureInfo.InvariantCulture,                 "{0}n{1}n{2}n{3}n{4}n{5}",                 httpRequestMethod,                 canonicalUri,                 canonicalQueryString,                 canonicalHeaders, // 注意这里已经包含了末尾的换行符                 signedHeaders,                 contentHash);              // --- 步骤 2: 创建 String to Sign ---              // Algorithm             string algorithm = "AWS4-HMAC-SHA256";              // Credential Scope             string dateStamp = requestDateTime.ToString("yyyyMMdd", CultureInfo.InvariantCulture);             string credentialScope = string.Format(CultureInfo.InvariantCulture,                 "{0}/{1}/{2}/aws4_request",                 dateStamp,                 _region,                 _service);              // Hash of Canonical Request             string hashedCanonicalRequest = ToHex(Hash(Encoding.UTF8.GetBytes(canonicalRequest)));              // 组合 String to Sign             string stringToSign = string.Format(CultureInfo.InvariantCulture,                 "{0}n{1}n{2}n{3}",                 algorithm,                 amzDate,                 credentialScope,                 hashedCanonicalRequest);              // --- 步骤 3: 计算签名 ---              // Signing Key 派生             byte[] kSecret = Encoding.UTF8.GetBytes("AWS4" + _secretKey);             byte[] kDate = HmacSha256(kSecret, dateStamp);             byte[] kRegion = HmacSha256(kDate, _region);             byte[] kService = HmacSha256(kRegion, _service);             byte[] kSigning = HmacSha256(kService, "aws4_request");              // 计算最终签名             byte[] signatureBytes = HmacSha256(kSigning, stringToSign);             string signature = ToHex(signatureBytes);              // --- 步骤 4: 添加 Authorization 头部 ---             string authorizationHeader = string.Format(CultureInfo.InvariantCulture,                 "{0} Credential={1}/{2}, SignedHeaders={3}, Signature={4}",                 algorithm,                 _accessKey,                 credentialScope,                 signedHeaders,                 signature);              request.Headers["Authorization"] = authorizationHeader;              // 设置 x-amz-date 头部（如果尚未设置）             request.Headers["x-amz-date"] = amzDate;             // 设置 x-amz-content-sha256 头部（如果尚未设置）             request.Headers["x-amz-content-sha256"] = contentHash;         }          /// <summary>         /// 计算字节数组的 SHA256 哈希值。         /// </summary>         private static byte[] Hash(byte[] bytes)         {             using (SHA256 sha256 = new SHA256Managed())             {                 return sha256.ComputeHash(bytes);             }         }          /// <summary>         /// 计算 HMAC-SHA256 哈希值。         /// </summary>         private static byte[] HmacSha256(byte[] key, string data)         {             using (HMACSHA256 hmac = new HMACSHA256(key))             {                 return hmac.ComputeHash(Encoding.UTF8.GetBytes(data));             }         }          /// <summary>         /// 将字节数组转换为十六进制字符串。         /// </summary>         private static string ToHex(byte[] bytes)         {             return BitConverter.ToString(bytes).Replace("-", "").ToLowerInvariant();         }     } }  

测试代码如下：

using System; using System.IO; using System.Threading;  namespace MinioHttpOperatorDemo {     class Program     {         static void Main(string[] args)         {   // 替换为您的 MinIO 实例的地址             string minioEndpoint = "http://127.xxx.xxx.xxx:9000";              // 如果您的 MinIO 实例需要认证，请在这里提供您的 AccessKey 和 SecretKey。             // 例如：             string accessKey = "accessKey ";             string secretKey = "secretKey ";             MinioHttpOperator minioOperator = new MinioHttpOperator(minioEndpoint, accessKey, secretKey);              // 如果 MinIO 允许匿名访问，则无需提供 AccessKey 和 SecretKey             //MinioHttpOperator minioOperator = new MinioHttpOperator(minioEndpoint);              // 确保此桶在 MinIO 中存在或 MinIO 服务器允许自动创建桶。             string bucketName = "bucketName ";             string testFolder = "test";              // --- 准备多个测试文件 ---             string localFilePath1 = Path.Combine(Path.GetTempPath(), "testfile1.txt");             string localFilePath2 = Path.Combine(Path.GetTempPath(), "testfile2.jpg"); // 模拟图片文件             string minioObjectName1 = $"{testFolder}/document1.txt";             string minioObjectName2 = $"{testFolder}/image.jpg";              string content1 = "This is the content for document one.";             byte[] content2 = new byte[1024]; // 模拟一个1KB的二进制数据作为图片内容             new Random().NextBytes(content2); // 填充随机字节              try             {                 File.WriteAllText(localFilePath1, content1);                 File.WriteAllBytes(localFilePath2, content2);                 Console.WriteLine($"已在本地创建测试文件：{localFilePath1} 和 {localFilePath2}");             }             catch (Exception ex)             {                 Console.WriteLine($"创建测试文件失败：{ex.Message}");                 Console.WriteLine("请检查文件路径和权限。程序将退出。");                 Console.ReadKey();                 return;             }              Console.WriteLine("n--- 开始 MinIO 批量操作 ---");              // --- 上传第一个文件 ---             Console.WriteLine($"n尝试上传文件：{localFilePath1} 到 {minioEndpoint}/{bucketName}/{minioObjectName1}...");             if (minioOperator.UploadFile(bucketName, minioObjectName1, localFilePath1, "text/plain"))             {                 Console.WriteLine("文件上传成功。");             }             else             {                 Console.WriteLine("文件上传失败。");             }             Thread.Sleep(1000); // 稍作等待              // --- 上传第二个文件 ---             Console.WriteLine($"n尝试上传文件：{localFilePath2} 到 {minioEndpoint}/{bucketName}/{minioObjectName2}...");             if (minioOperator.UploadFile(bucketName, minioObjectName2, localFilePath2, "image/jpeg"))             {                 Console.WriteLine("文件上传成功。");             }             else             {                 Console.WriteLine("文件上传失败。");             }             Thread.Sleep(1000); // 稍作等待              Console.WriteLine("n----------------------------------------");              // --- 下载第一个文件 ---             string downloadSavePath1 = Path.Combine(Path.GetTempPath(), "downloaded_document1.txt");             Console.WriteLine($"n尝试从 {minioEndpoint}/{bucketName}/{minioObjectName1} 下载文件到 {downloadSavePath1}...");             if (minioOperator.DownloadFile(bucketName, minioObjectName1, downloadSavePath1))             {                 Console.WriteLine("文件下载成功。");                 try                 {                     Console.WriteLine($"下载文件的内容：{File.ReadAllText(downloadSavePath1)}");                 }                 catch (Exception ex)                 {                     Console.WriteLine($"读取下载文件内容失败：{ex.Message}");                 }             }             else             {                 Console.WriteLine("文件下载失败。");             }             Thread.Sleep(1000); // 稍作等待              // --- 尝试下载一个不存在的文件 ---             string nonExistentObject = $"{testFolder}/nonexistent.pdf";             string downloadNonExistentPath = Path.Combine(Path.GetTempPath(), "nonexistent.pdf");             Console.WriteLine($"n尝试下载不存在的文件：{nonExistentObject}...");             if (!minioOperator.DownloadFile(bucketName, nonExistentObject, downloadNonExistentPath))             {                 Console.WriteLine("下载不存在的文件失败（预期结果）。");             }             Thread.Sleep(1000); // 稍作等待              Console.WriteLine("n----------------------------------------");              // --- 删除第一个文件 ---             Console.WriteLine($"n尝试从 {minioEndpoint}/{bucketName} 删除文件 {minioObjectName1}...");             if (minioOperator.DeleteFile(bucketName, minioObjectName1))             {                 Console.WriteLine("文件删除成功。");             }             else             {                 Console.WriteLine("文件删除失败。");             }             Thread.Sleep(1000); // 稍作等待              // --- 删除第二个文件 ---             Console.WriteLine($"n尝试从 {minioEndpoint}/{bucketName} 删除文件 {minioObjectName2}...");             if (minioOperator.DeleteFile(bucketName, minioObjectName2))             {                 Console.WriteLine("文件删除成功。");             }             else             {                 Console.WriteLine("文件删除失败。");             }              Console.WriteLine("n--- MinIO 批量操作结束 ---");              // 清理本地创建的测试文件             try             {                 if (File.Exists(localFilePath1))                 {                     File.Delete(localFilePath1);                     Console.WriteLine($"已清理本地测试文件：{localFilePath1}");                 }                 if (File.Exists(localFilePath2))                 {                     File.Delete(localFilePath2);                     Console.WriteLine($"已清理本地测试文件：{localFilePath2}");                 }                 if (File.Exists(downloadSavePath1))                 {                     File.Delete(downloadSavePath1);                     Console.WriteLine($"已清理本地下载文件：{downloadSavePath1}");                 }                 if (File.Exists(downloadNonExistentPath))                 {                     File.Delete(downloadNonExistentPath);                     Console.WriteLine($"已清理本地下载文件：{downloadNonExistentPath}");                 }             }             catch (Exception ex)             {                 Console.WriteLine($"清理本地文件失败：{ex.Message}");             }              Console.WriteLine("n按任意键退出程序。");             Console.ReadKey();         }     } }