minio

环境要求

• Go 语言环境，最低版本 go1.24（需自行安装 Golang）
• 本地任意一个空文件夹，用于存放对象数据（如 /tmp/minio）
• 如需构建容器镜像，需要本地已安装 Docker
• 可选：S3 兼容客户端，如 MinIO Client `mc`

安装与启动步骤

1. 1安装 Go 环境

   README 要求最低 go1.24，请按 golang.org/doc/install 安装，并确认 go 命令可用。

2. 2从源码安装

   官方推荐方式，go install 会把 minio 二进制装到 GOPATH/bin，确保该目录在 PATH 中。

   go install github.com/minio/minio@latest

   复制

3. 3交叉编译可选

   若目标机器与当前机器系统架构不同，可用 GOOS/GOARCH 控制构建目标再 go build。

   env GOOS=linux GOARCH=arm64 go build

   复制

4. 4启动 MinIO 服务

   PATH 换成你本地任意一个空文件夹，默认端口 9000；当这个目录不存在时命令会报错。

   minio server /tmp/minio

   复制

5. 5登录控制台

   浏览器访问 http://127.0.0.1:9000，用默认 root 凭据 minioadmin/minioadmin 登录，可建桶、传对象。

6. 6用 mc 验证

   用 S3 兼容的 mc 客户端配置别名并查看服务信息，确认服务可用。

   mc alias set local http://localhost:9000 minioadmin minioadmin
   mc admin info local

   复制

7. 7构建 Docker 镜像

   需先在项目根目录执行 go build，确保 minio 二进制存在，再构建镜像 myminio:minio。

   docker build -t myminio:minio .

   复制

8. 8运行容器

   映射 9000 与 9001 端口，控制台地址用 --console-address 指定为 :9001。

   docker run -p 9000:9000 -p 9001:9001 myminio:minio server /tmp/minio --console-address :9001

   复制

如何确认成功

浏览器打开 http://127.0.0.1:9000 能用 minioadmin/minioadmin 登录；或执行 mc admin info local 正常返回集群信息。

常见问题

注意事项

• 本仓库已停止维护，新项目建议评估官方推荐的 AIStor 版本后再选型。
• MinIO 采用 GNU AGPLv3 协议，在应用中使用需自行确认并履行 AGPLv3 义务，商业使用尤其要评估。
• 控制台默认地址为 http://127.0.0.1:9000，Docker 运行时若指定 --console-address :9001 则控制台走 9001 端口。
• 构建 Docker 镜像前必须先编译出 minio 二进制并放在项目根目录，否则 docker build 会失败。