如何在本地开发中为MinIO配置虚拟主机样式URL？

MinIO完全支持S3虚拟主机样式URL，问题出在配置缺失和代码中的小错误，按以下步骤修复：

1. 修改Docker Compose配置 #

给MinIO添加MINIO_DOMAIN环境变量，指定本地根域名，让MinIO能识别子域名形式的bucket：

services:
  minio:
    container_name: "minio"
    image: minio/minio:RELEASE.2025-03-12T18-04-18Z
    ports:
      - "9000:9000"
      - "9001:9001"
    environment:
      - MINIO_ROOT_USER=user
      - MINIO_ROOT_PASSWORD=1234678
      - MINIO_DOMAIN=localhost  # 新增：指定本地根域名
    command: server /data --console-address ":9001"

2. 修正.NET SDK配置 #

调整AmazonS3Config确保启用虚拟主机样式，同时修正密码不一致的问题：

private static void AddAmazonS3(this IServiceCollection services)
{
    var options = new AmazonS3Config
    {
        UseHttp = true,
        ServiceURL = "http://localhost:9000",
        ForcePathStyle = false,  // 显式禁用路径样式，强制使用虚拟主机模式
        RegionEndpoint = RegionEndpoint.USEast1,  // MinIO默认兼容us-east-1区域
    };
    // 注意：密码要和Docker配置中的MINIO_ROOT_PASSWORD完全一致
    services.AddSingleton<IAmazonS3>(_ => new AmazonS3Client("user", "1234678", options));
}

3. 验证配置并重启服务 #

• 重启MinIO容器，确保新环境变量生效
• 通过MinIO控制台（http://localhost:9001）确认bucket-name已正确创建
• 测试文件上传，此时SDK会自动生成http://bucket-name.localhost:9000/object-key格式的请求，MinIO可正确识别bucket

关键说明 #

• MINIO_DOMAIN是虚拟主机模式的核心配置，MinIO会将子域名解析为对应的bucket名称
• 代码中密码与Docker配置不一致是常见隐性错误，必须完全匹配
• 若使用自定义本地域名（如my-minio.local），只需将MINIO_DOMAIN设为该域名，并在hosts中配置127.0.0.1 bucket-name.my-minio.local

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