.NET4通过HTTP操作MINIO

挚魉 · 2025-9-26 11:41:17

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();
}
}
}

复制代码

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

账号		自动登录	找回密码
密码			立即注册