如何使用C#连接IONOS云存储（ASP.NET Core Web API）

1. 选择NuGet包 #

IONOS S3兼容标准S3协议，直接用AWS官方的S3 SDK即可，你之前用AWSSDK.S3没成功大概率是配置问题，不是包的问题。推荐两个选项：

• AWSSDK.S3：传统全量SDK，适合快速上手
• Amazon.S3（AWS SDK for .NET V3）：模块化轻量版本，性能更优

安装命令（Package Manager Console）：

• 全量版：Install-Package AWSSDK.S3
• 模块化版：Install-Package Amazon.S3

2. 核心配置：Endpoint与凭证 #

IONOS S3需要指定专属区域Endpoint，同时配置你的IONOS Access Key和Secret Key，关键要开启路径模式访问。

测试用代码配置 #

using Amazon.S3;
using Amazon.S3.Model;

// 替换为你的IONOS区域Endpoint，比如法兰克福是https://s3-eu-central-1.ionoscloud.com
var s3Config = new AmazonS3Config
{
    ServiceURL = "你的IONOS S3 Endpoint",
    SignatureVersion = "v4",
    ForcePathStyle = true // 必须开启，IONOS S3要求路径模式
};

// 用IONOS的Access Key和Secret Key创建客户端
var s3Client = new AmazonS3Client("你的Access Key", "你的Secret Key", s3Config);

// 测试：列出所有存储桶
var buckets = await s3Client.ListBucketsAsync();
foreach (var bucket in buckets.Buckets)
{
    Console.WriteLine(bucket.BucketName);
}

生产环境配置（appsettings.json） #

在appsettings.json中添加配置节点：

"IonosS3": {
  "AccessKey": "你的IONOS Access Key",
  "SecretKey": "你的IONOS Secret Key",
  "Endpoint": "https://s3-eu-central-1.ionoscloud.com" // 替换为你的区域Endpoint
}

在Program.cs中注册S3服务：

var builder = WebApplication.CreateBuilder(args);

// 注册IONOS S3客户端
builder.Services.AddAWSService<IAmazonS3>(options =>
{
    var ionoS3Settings = builder.Configuration.GetSection("IonosS3");
    options.ServiceURL = ionoS3Settings["Endpoint"];
    options.SignatureVersion = "v4";
    options.ForcePathStyle = true;
    options.Credentials = new Amazon.Runtime.BasicAWSCredentials(
        ionoS3Settings["AccessKey"],
        ionoS3Settings["SecretKey"]
    );
});

// 其他服务注册...
var app = builder.Build();

// 中间件配置...
app.Run();

在控制器中注入使用：

[ApiController]
[Route("api/s3")]
public class S3Controller : ControllerBase
{
    private readonly IAmazonS3 _s3Client;

    public S3Controller(IAmazonS3 s3Client)
    {
        _s3Client = s3Client;
    }

    [HttpGet("buckets")]
    public async Task<IActionResult> GetAllBuckets()
    {
        var response = await _s3Client.ListBucketsAsync();
        var bucketNames = response.Buckets.Select(b => b.BucketName);
        return Ok(bucketNames);
    }
}

3. 常见踩坑点 #

• Endpoint错误：IONOS不同区域的Endpoint不同，务必从IONOS控制台的S3存储页面复制正确地址
• 未开启路径模式：ForcePathStyle = true是必须的，否则会请求失败
• 凭证错误：确保使用的是IONOS专门生成的S3访问凭证，不是其他服务的密钥
• 网络问题：检查应用服务器是否能访问IONOS的S3 Endpoint，排除防火墙或代理拦截

内容的提问来源于stack exchange，提问作者Nasim