MinIo 2025-10 起已明确把“社区版”降格为维护模式，并同步收紧了交付方式与功能范围；同时，官方把研发重心全部转向付费的商业版（AIStor）

对比

核心概念

一句话的理解：Master 管“调度”，Volume 管“存数据”，Filer 管“目录”，S3 Gateway 管“像 S3 一样访问”。

启动步骤

快速停止

taskkill /f /im weed.exe

Mater

Filter

Gateway

配置文件

SeaweedFS 把 S3 的 AK/SK（Access Key / Secret Key）以及权限策略统一写在一份 JSON 文件里（默认叫 s3.json），启动 S3 Gateway 时通过 -config 参数加载即可

{
  "identities": [
    {
      "name": "admin",
      "credentials": [
        {
          "accessKey": "YOUR_ACCESS_KEY",
          "secretKey": "YOUR_SECRET_KEY"
        }
      ],
      "actions": ["Admin", "Read", "Write", "List", "Tagging"]
    }
  ],
  "accounts": []
}

启动命令

# 独立 S3 Gateway 进程
weed s3 -filer=localhost:8888 -port=8333  -config=/etc/seaweedfs/s3.json

SDK

直接用 AWS 官方的 @aws-sdk/client-s3（推荐）——SeaweedFS 的 S3 Gateway 兼容 AWS 签名，只要配好 endpoint、forcePathStyle 和 AK/SK 即可 。

npm i @aws-sdk/client-s3

import { S3Client, PutObjectCommand, GetObjectCommand, ListBucketsCommand } from "@aws-sdk/client-s3";
import { createReadStream } from "fs";

const s3 = new S3Client({
  endpoint: "http://127.0.0.1:8333",   // SeaweedFS S3 端口
  region: "us-east-1",                 // 必填，但会被忽略
  forcePathStyle: true,                // 关键：关闭虚拟主机风格
  credentials: {
    accessKeyId: "YOUR_AK",
    secretAccessKey: "YOUR_SK"
  }
});

// 上传
await s3.send(new PutObjectCommand({
  Bucket: "test-bucket",
  Key: "hello.txt",
  Body: createReadStream("./hello.txt")
}));

// 列举桶
const { Buckets } = await s3.send(new ListBucketsCommand({}));
console.log("Buckets:", Buckets);