MinIO · 高性能 S3 兼容对象存储 · 本地部署与运维全指南

项目仓库： https://github.com/minio/minio

开源协议：GNU AGPL v3.0 · 语言：Go · 分发：源码构建（社区版不再提供预编译二进制） · 要求 Go 1.24+ · 控制台端口：9000 / 9001 · 仓库分支：master

维护提示（官方 README 顶部）：本仓库不再维护；官方推荐迁移到 AIStor Free（社区版）与 AIStor Enterprise（商业版）。社区版现已改为仅源码分发，不再提供预编译二进制。

1 项目简介

MinIO 是一个高性能、S3 兼容的对象存储解决方案，以 GNU AGPL v3.0 发布，为 AI/ML、分析与数据密集型工作负载设计。它与现有 S3 工具无缝集成，主打速度与可扩展性。

1.1 核心信息一览

1.2 适用场景

• 需要一个本地 S3 兼容对象存储替代方案。
• 为 AI/ML 数据管道、分析工作负载提供高性能存储。
• 用 mc 命令行或 S3 SDK 接入应用。

1.3 能力边界（官方口径）

• 社区版仅源码分发，不再提供预编译二进制；生产自编译二进制风险自担。
• AGPLv3 要求商业/专有使用需发布修改代码。

2 功能特性

• S3 API 兼容：与现有 S3 工具无缝集成。
• 面向 AI/分析：针对大规模数据管道优化。
• 高性能：适合苛刻存储负载。
• 内置控制台：嵌入式 Web 对象浏览器。
• Erasure Code：纠删码保障数据可靠性。

3 官方界面预览

文首为官方标识；控制台界面以浏览器访问 http://127.0.0.1:9000 为准。

4 官方跳转链接汇总

5 前置要求与服务器配置

5.1 软件前提

• Go 1.24+：用于 go install 构建。
• Docker（容器方式）。
• 磁盘目录：一个空目录作为存储路径。

5.2 端口

6 方式一：源码构建（官方推荐）

# 需 Go 1.24+
go install github.com/minio/minio@latest

# 启动 server，PATH 为任意空目录
minio server /data/minio

默认 root 凭据 minioadmin:minioadmin，浏览器访问 http://127.0.0.1:9000。

7 方式二：Docker 部署

# 先构建镜像（需项目根目录存在 minio 二进制）
docker build -t myminio:minio .

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

8 K8s 部署

• MinIO Operator：github.com/minio/operator。
• 社区 Helm chart：helm/minio 目录内 README。

9 客户端 mc 常用命令

# 设置本地别名
mc alias set local http://localhost:9000 minioadmin minioadmin

# 查看服务信息
mc admin info local

# 创建桶、拷贝、列出
mc mb data
mc cp ~/Downloads/mydata data/
mc ls data/

10 配置项说明

11 常见故障排查

• 控制台端口随机：用 --console-address :9001 指定固定端口。
• 找不到预编译二进制：社区版已改为源码分发，需 go install 构建。
• 生产使用自编译二进制：官方提示风险自担，建议评估 AIStor。

12 风险与合规说明

• 许可证：AGPLv3，商业/专有使用需遵守开源义务。
• 维护状态：本仓库已不再维护，新项目建议 AIStor。
• 凭据安全：生产环境务必修改默认 minioadmin:minioadmin。
• 非官方声明：本文基于官方仓库 README 整理，命令以 master 分支最新为准。