这是本节的多页打印视图。 .

.NET 快速入门指南

使用 MinIO .NET SDK 从 .NET 应用连接 SILO。

MinIO .NET SDK

SILO 实现兼容 S3 的服务端契约，因此应用可以直接使用上游 MinIO .NET SDK，无需 SILO 专用客户端分支。本指南使用稳定的 NuGet 软件包，并通过环境变量传入凭据。

说明

SDK 的运行时要求与 API 会独立于 SILO 演进。为应用选择版本前，请核对当前 NuGet 软件包与 SDK 发布记录。

安装软件包

在现有 .NET 项目中添加 Minio 软件包：

dotnet add package Minio

配置连接

设置 SILO 部署的端点与凭据，不要把密钥写进源码仓库。

export S3_ENDPOINT=127.0.0.1:9000
export S3_ACCESS_KEY=silo-admin
export S3_SECRET_KEY=replace-with-a-strong-secret
export S3_USE_SSL=false

S3_ENDPOINT 只填写主机名和可选端口，不带 http:// 或 https:// 前缀。端点启用 TLS 时，将 S3_USE_SSL 设为 true。

创建存储桶并上传对象

using Minio;
using Minio.DataModel.Args;

var endpoint = Environment.GetEnvironmentVariable("S3_ENDPOINT")
    ?? throw new InvalidOperationException("S3_ENDPOINT is required");
var accessKey = Environment.GetEnvironmentVariable("S3_ACCESS_KEY")
    ?? throw new InvalidOperationException("S3_ACCESS_KEY is required");
var secretKey = Environment.GetEnvironmentVariable("S3_SECRET_KEY")
    ?? throw new InvalidOperationException("S3_SECRET_KEY is required");
var useSsl = bool.TryParse(Environment.GetEnvironmentVariable("S3_USE_SSL"), out var ssl)
    && ssl;

var client = new MinioClient()
    .WithEndpoint(endpoint)
    .WithCredentials(accessKey, secretKey)
    .WithSSL(useSsl)
    .Build();

const string bucket = "dotnet-quickstart";
const string objectName = "hello.txt";
const string filePath = "hello.txt";

var exists = await client.BucketExistsAsync(
    new BucketExistsArgs().WithBucket(bucket));

if (!exists)
{
    await client.MakeBucketAsync(
        new MakeBucketArgs().WithBucket(bucket));
}

await client.PutObjectAsync(
    new PutObjectArgs()
        .WithBucket(bucket)
        .WithObject(objectName)
        .WithFileName(filePath)
        .WithContentType("text/plain"));

Console.WriteLine($"Uploaded {objectName} to {bucket}");

创建 hello.txt，然后运行项目：

dotnet run

ASP.NET Core 依赖注入与更多操作见 SDK 的当前 README。维护分支还提供简单控制台示例和基于 Host 的示例；把代码复制到固定版本的应用前，请先核对示例所在分支与软件包版本。

生产检查清单

启用 TLS，并验证服务端证书。
从密钥管理系统或受保护的环境中加载凭据，不要写入源码。
只授予应用实际需要的存储桶与对象权限。
把 SDK 版本固定与验证纳入应用自身的依赖生命周期。
显式处理 SDK 异常、请求取消、重试与分段上传清理。

服务端策略配置见身份与访问管理。