MinIO Quickstart Guide

MinIO 是一个基于Apache License v2.0开源协议的对象存储服务。它兼容亚马逊S3云存储服务接口，非常适合于存储大容量非结构化的数据，例如图片、视频、日志文件、备份数据和容器/虚拟机镜像等，而一个对象文件可以是任意大小，从几kb到最大5T不等。

MinIO是一个非常轻量的服务,可以很简单的和其他应用的结合，类似 NodeJS, Redis 或者 MySQL。

Docker 容器

稳定版

docker run -p 9000:9000 \

-e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \

-e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \

minio/minio server /data

尝鲜版

docker run -p 9000:9000 \

-e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \

-e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \

minio/minio:edge server /data

提示：除非你通过-it(TTY交互)参数启动容器，否则Docker将不会显示默认的密钥。一般情况下，并不推荐使用容器的默认密钥，更多Docker部署信息请访问 这里

macOS

Homebrew(推荐)

使用 Homebrew安装minio

brew install minio/stable/minio

minio server /data

提示：如果你之前使用 brew install minio安装过minio, 可以用 minio/stable/minio 官方镜像进行重装. 由于golang 1.8的bug,homebrew版本不太稳定。

brew uninstall minio

brew install minio/stable/minio

下载二进制文件

chmod 755 minio

./minio server /data

GNU/Linux

下载二进制文件

wget https://dl.min.io/server/minio/release/linux-amd64/minio

chmod +x minio

./minio server /data

wget https://dl.min.io/server/minio/release/linux-ppc64le/minio

chmod +x minio

./minio server /data

微软Windows系统

下载二进制文件

minio.exe server D:\Photos

FreeBSD

Port

使用 pkg进行安装，, MinIO官方并没有提供FreeBSD二进制文件， 它由FreeBSD上游维护，点击 这里查看。

pkg install minio

sysrc minio_enable=yes

sysrc minio_disks=/home/user/Photos

service minio start

使用源码安装

采用源码安装仅供开发人员和高级用户使用,如果你还没有Golang环境， 请参考 How to install Golang。最低需要Golang版本为 go1.14

GO111MODULE=on go get github.com/minio/minio

为防火墙设置允许访问的端口

默认情况下，MinIO 使用端口9000来侦听传入的连接。如果你的平台默认阻止了该端口，则需要启用对该端口的访问。

ufw

对于启用了ufw的主机(基于Debian的发行版), 你可以通过ufw命令允许指定端口上的所有流量连接. 通过如下命令允许访问端口9000

ufw allow 9000

如下命令允许端口9000-9010上的所有传入流量。

ufw allow 9000:9010/tcp

firewall-cmd

对于启用了firewall-cmd的主机(CentOS), 你可以通过firewall-cmd命令允许指定端口上的所有流量连接。 通过如下命令允许访问端口9000

firewall-cmd --get-active-zones

这个命令获取当前正在使用的区域。 现在，就可以为以上返回的区域应用端口规则了。 假如返回的区域是 public, 使用如下命令

firewall-cmd --zone=public --add-port=9000/tcp --permanent

这里的permanent参数表示持久化存储规则，可用于防火墙启动、重启和重新加载。 最后，需要防火墙重新加载，让我们刚刚的修改生效。

firewall-cmd --reload

iptables

对于启用了iptables的主机(RHEL, CentOS, etc), 你可以通过iptables命令允许指定端口上的所有流量连接。 通过如下命令允许访问端口9000

iptables -A INPUT -p tcp --dport 9000 -j ACCEPT

service iptables restart

如下命令允许端口9000-9010上的所有传入流量。

iptables -A INPUT -p tcp --dport 9000:9010 -j ACCEPT

service iptables restart

使用MinIO浏览器进行验证

MinIO Server带有一个嵌入的Web对象浏览器，安装后使用浏览器访问http://127.0.0.1:9000，如果可以访问，则表示minio已经安装成功。

使用MinIO客户端 mc进行验证

mc 提供了一些UNIX常用命令的替代品，像ls, cat, cp, mirror, diff这些。 它支持文件系统和亚马逊S3云存储服务。 更多信息请参考 mc快速入门 。

已经存在的数据

当在单块磁盘上部署MinIO server,MinIO server允许客户端访问数据目录下已经存在的数据。比如，如果MinIO使用minio server /mnt/data启动，那么所有已经在/mnt/data目录下的数据都可以被客户端访问到。

上述描述对所有网关后端同样有效。

升级 MinIO

MinIO 服务端支持滚动升级, 也就是说你可以一次更新分布式集群中的一个MinIO实例。 这样可以在不停机的情况下进行升级。可以通过将二进制文件替换为最新版本并以滚动方式重新启动所有服务器来手动完成升级。但是, 我们建议所有用户从客户端使用 mc admin update 命令升级。 这将同时更新集群中的所有节点并重新启动它们, 如下命令所示:

mc admin update

注意: 有些发行版可能不允许滚动升级，这通常在发行说明中提到，所以建议在升级之前阅读发行说明。在这种情况下，建议使用mc admin update升级机制来一次升级所有服务器。

MinIO升级时要记住的重要事项

mc admin update 命令仅当运行MinIO的用户对二进制文件所在的父目录具有写权限时才工作, 比如当前二进制文件位于/usr/local/bin/minio, 你需要具备/usr/local/bin目录的写权限.

mc admin update 命令同时更新并重新启动所有服务器，应用程序将在升级后重试并继续各自的操作。

mc admin update 命令在 kubernetes/container 环境下是不能用的, 容器环境提供了它自己的更新机制来更新。

对于联盟部署模式，应分别针对每个群集运行mc admin update。 在成功更新所有群集之前，不要将mc更新为任何新版本。

如果将kes用作MinIO的KMS，只需替换二进制文件并重新启动kes，可以在 这里 找到有关kes的更多信息。

了解更多

如何参与到MinIO项目

请参考 贡献者指南。欢迎各位中国程序员加到MinIO项目中。

授权许可

MinIO的使用受 Apache 2.0 License 约束，你可以在 LICENSE 查看许可。