pgsty/minio

重要声明

这是由Pigsty维护的https://github.com/minio/minio%E7%A4%BE%E5%8C%BA%E5%88%86%E6%94%AF%E3%80%82%E6%9C%AC%E9%A1%B9%E7%9B%AE%E4%B8%8EMinIO, Inc.无关联、未获其认可或赞助。"MinIO"是MinIO, Inc.的商标，此处仅用于标识上游项目。

本分支仅提供缺失的RPM/DEB/Docker镜像，修改极小：恢复了嵌入式ADMIN控制台GUI版本引用，并更新了文档链接和Go模块路径以指向本仓库。

MinIO快速入门指南

![网站: minio.pigsty.io]([] ![Slack]([]

MinIO是一款高性能、兼容S3的对象存储解决方案，基于GNU AGPL v3.0许可证发布。其设计注重速度和可扩展性，为AI/ML、分析和数据密集型工作负载提供行业领先的性能。

• S3 API兼容——与现有S3工具无缝集成
• 专为AI和分析构建——针对大规模数据管道优化
• 高性能——适用于高要求的存储工作负载

本文档提供从源码构建MinIO并部署到裸机硬件的说明。使用https://github.com/minio/docs%E9%A1%B9%E7%9B%AE%E5%8F%AF%E6%9E%84%E5%BB%BA%E5%92%8C%E6%89%98%E7%AE%A1%E6%9C%AC%E5%9C%B0%E6%96%87%E6%A1%A3%E5%89%AF%E6%9C%AC%E3%80%82

从源码安装

使用以下命令从源码编译并运行独立的MinIO服务器。若没有可用的Golang环境，请遵循如何安装Golang。最低要求版本为go1.24

sh
go install github.com/pgsty/minio@latest

也可运行go build并使用GOOS和GOARCH环境变量控制目标操作系统和架构。例如：

sh
env GOOS=linux GOARCH=arm64 go build

通过运行minio server PATH启动MinIO，其中PATH是本地文件系统上的任意空文件夹。

MinIO部署使用默认根凭据minioadmin:minioadmin启动。可使用MinIO Console（MinIO Server内置的基于Web的对象浏览器）测试部署。在主机上打开Web浏览器，访问<[***]>，使用根凭据登录。可通过浏览器创建桶、上传对象和浏览MinIO服务器内容。

也可使用任何S3兼容工具连接，如MinIO Client mc命令行工具：

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

有关使用mc命令行工具的更多信息，请参见使用MinIO Client mc测试。对于应用开发者，请访问<[***]>查看支持语言的MinIO SDK。

构建Docker镜像

可使用docker build .命令在本地主机构建Docker镜像。必须先构建MinIO并确保minio二进制文件存在于项目根目录。

以下命令使用项目根目录中的默认Dockerfile构建Docker镜像，仓库和镜像标签为myminio:minio

sh
docker build -t myminio:minio .

使用docker image ls确认镜像存在于本地仓库。可使用标准Docker命令运行服务器：

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

有关构建Docker容器、管理自定义镜像或将镜像加载到编排平台的完整文档超出本文档范围。可根据具体镜像需求修改Dockerfile和dockerscripts/docker-entrypoint.sh。

使用Helm Charts安装

有两种方式在Kubernetes基础设施上安装MinIO：

• 使用https://github.com/minio/operator
• 使用社区维护的https://github.com/pgsty/minio/tree/master/helm/minio

社区Helm chart的说明位于文件夹级别的README中。

测试MinIO连接性

使用MinIO Console测试

MinIO Server附带内置的基于Web的对象浏览器。将Web浏览器指向<[***]>以确认服务器已成功启动。

[!NOTE] MinIO默认在随机端口运行控制台，若需指定端口，使用--console-address选择特定接口和端口。

使用MinIO Client mc测试

mc提供了现代替代方案，替代ls、cat、cp、mirror、diff等UNIX命令。它支持文件系统和Amazon S3兼容的云存储服务。

以下命令设置本地别名、验证服务器信息、创建桶、将数据复制到该桶并列出桶内容。

sh
mc alias set local http://localhost:9000 minioadmin minioadmin
mc admin info
mc mb data
mc cp ~/Downloads/mydata data/
mc ls data/

有关更多说明，请遵循MinIO Client 快速入门指南。

进一步探索

• MinIO纠删码概述
• 将mc与MinIO Server一起使用
• 将minio-go SDK与MinIO Server一起使用
• MinIO V3指标参考

贡献

请遵循MinIO https://github.com/minio/minio/blob/master/CONTRIBUTING.md%E4%BA%86%E8%A7%A3%E5%90%91%E4%BB%93%E5%BA%93%E6%8F%90%E4%BA%A4%E6%96%B0%E8%B4%A1%E7%8C%AE%E7%9A%84%E6%8C%87%E5%AF%BC%E3%80%82

许可证

• MinIO源码基于GNU AGPLv3许可。
• MinIO 文档基于CC BY 4.0许可。
• 许可证合规性