Object storage is amazingly versatile. We normally associate it with AWS S3, but Object Storage can also be run on your private network with MinIO. In this article, I’ll show you how to install MinIO using Docker and also on a Mac using homebrew.

对象存储功能异常强大。 我们通常将其与AWS S3关联，但是对象存储也可以使用MinIO在您的专用网络上运行。 在本文中，我将向您展示如何使用Docker以及在Mac上使用自制软件安装MinIO。

MinIO has an API which is compatible with Amazon S3. This will allow you to develop applications locally and later, easily port them to AWS or you can use MinIO as your primary object store in production.

MinIO具有与Amazon S3兼容的API。 这将使您能够在本地和以后开发应用程序，轻松地将它们移植到AWS上，或者可以将MinIO用作生产中的主要对象存储。

先决条件 (Prerequisites)

You can code along with this tutorial on any operating system If you have Docker and docker-compose.

如果您拥有Docker和docker-compose，则可以与本教程一起在任何操作系统上进行编码。

If you have a Mac you will optionally have to have homebrew installed.

如果您使用Mac，则可以选择必须安装自制软件。

If you want to run the demo application at the end of the tutorial, you will need NodeJS installed.

如果要在本教程的结尾运行演示应用程序，则需要安装NodeJS。

安装 (Installation)

使用Homebrew安装MinIO (Install MinIO using Homebrew)

Homebrew is the fastest way to get MinIO up and running if you have a Mac. If you don’t have a Mac, follow the Docker tutorial below.

如果您使用Mac，Homebrew是启动和运行MinIO的最快方法。 如果您没有Mac，请遵循以下Docker教程。

brew install minio/stable/minio

I’m also going to install the mc CLI tool

我还将安装mc CLI工具

brew install minio/stable/mc

创建一个MinIO服务器实例 (Create a MinIO server instance)

Creating a new server instance is quite simple. Run the command below in a terminal.

创建一个新的服务器实例非常简单。 在终端中运行以下命令。

minio server /path/to/some/dir

The first time you run this command, you’re going to get nagged about default ACCESS_KEY and SECRET_KEY. Let’s change them now.

第一次运行此命令时，您将对默认的ACCESS_KEY和SECRET_KEY ACCESS_KEY了解。 让我们现在更改它们。

Hit Ctrl+c to shut down the server.

Ctrl+c关闭服务器。

export ACCESS_KEY=adminexport ACCESS_SECRET=password

Now run the server again

现在再次运行服务器

minio server /path/to/some/dir

使用Docker安装MinIO (Installing MinIO using Docker)

This is my favoured approach. I have a Synology NAS, which I use to host Docker Containers and more. For MinIO it gives me plenty of storage space and access to S3 across my network.

这是我最喜欢的方法。 我有一个Synology NAS，可用来托管Docker容器等。 对于MinIO，它为我提供了足够的存储空间，并可以通过我的网络访问S3。

In this tutorial, I will use a docker-compose file so my instructions will work on any operating system you may be running. If you don’t have Docking installed, take a look at https://www.docker.com/

在本教程中，我将使用docker-compose文件，因此我的说明将在您可能正在运行的任何操作系统上运行。 如果您尚未安装扩展坞，请访问https://www.docker.com/

Create a new folder and create a docker-compose.yml file with the following contents.

创建一个新文件夹并创建一个包含以下内容docker-compose.yml文件。

Save the file and then the terminal, inside the same folder where the docker-compose file is located; run

保存文件，然后将终端保存在docker-compose文件所在的同一文件夹内； 跑

docker-compose up

The above command will bring 4 MinIO containers as a cluster. Each will have admin/password as credentials and the web interface accessible on

上面的命令将把4个MinIO容器作为一个群集。 每个人都将使用admin/password作为凭据，并可以通过以下网址访问网络界面

http://localhost:9001http://localhost:9002http://localhost:9003http://localhost:9004

Any data that is written or deleted from any one of the above instances will be replicated to the other 3.

从上述任一实例写入或删除的任何数据都将被复制到其他3。

In the subsequent sections, I will discuss accessing MinIO on port 9000 as that is the port created when installed using homebrew. If you have installed MinIO using Docker, just change port 9000 for one of the ports listed above.

在接下来的部分中，我将讨论在端口9000上访问MinIO，因为这是使用homebrew安装时创建的端口。 如果您使用Docker安装了MinIO，只需将端口9000更改为上面列出的端口之一。

其他作业系统 (Other operating systems)

The MinIO docker hub repo contains further details for installing MinIO. It also covers other operating systems such as Linux and Windows. https://registry.hub.docker.com/r/minio/minio/

MinIO泊坞中心存储库包含有关安装MinIO的更多详细信息。 它还涵盖其他操作系统，例如Linux和Windows。 https://registry.hub.docker.com/r/minio/minio/

MinIO Web界面 (The MinIO Web Interface)

This section of the tutorial assumes you used homebrew to install MinIO. If you used Docker, simply change the port number 9000 to 9001

本教程的这一部分假定您使用自制软件安装MinIO。 如果您使用的是Docker，只需将端口号9000更改为9001

In the terminal window where you started the MinIO server, you will see a list of web endpoints. You can use any of them. I will use http://localhost:9000 Visit this address in your browser.

在启动MinIO服务器的终端窗口中，您将看到Web端点列表。 您可以使用其中任何一个。 我将使用http://localhost:9000在浏览器中访问此地址。

Enter admin/password for the ACCESS Key/Secret Key

输入admin/password作为ACCESS Key/Secret Key

The red button at the bottom right allows you to create new Buckets and upload files. I am going to create a new bucket called testing and upload a file.

右下方的红色按钮可让您创建新的存储桶并上传文件。 我将创建一个称为testing的新存储桶并上传文件。

The file I uploaded is from https://www.bensound.com. I don’t think I need to give credit in this case, but I think it’s polite.

我上传的文件来自https://www.bensound.com 。 在这种情况下，我认为我无需赞扬，但我认为这很客气。

The ellipse to the right of the file allows Downloading, Deleting and time-limited link sharing.

文件右侧的椭圆允许Downloading ， Deleting和time-limited link sharing 。

mc CLI工具 (mc CLI tool)

Let’s take a look at the MinIO CLI tool, mc

让我们看一下MinIO CLI工具mc

创建一个别名 (Creating an alias)

Before we can use mc, we need to create an alias to the MinIO server endpoint.

在使用mc之前，我们需要为MinIO服务器端点创建一个别名。

In the same terminal where your MinIO instance is running hit Ctrl+c to close the server. Then enter the following command in the terminal

在运行MinIO实例的同一终端中，按Ctrl + c关闭服务器。 然后在终端输入以下命令

mc alias set localS3 http://192.168.30.100:9000

I have used localS3 as the alias to the MinIO instance URL. You will need to change the IP address or use http://localhost:9000

我已经使用localS3作为MinIO实例URL的别名。 您将需要更改IP地址或使用http://localhost:9000

Now start the server again

现在再次启动服务器

在CLI中列出存储桶和文件 (Listing buckets and files in the CLI)

Keep the server running and open another terminal window.

保持服务器运行，并打开另一个终端窗口。

Enter the following command

输入以下命令

mc ls localS3

You should see the bucket testing that was created in the browser. The above command lists everything in the root of the data store.

您应该看到在浏览器中创建的存储桶testing 。 上面的命令列出了数据存储根目录中的所有内容。

To view the file that was uploaded

查看上载的文件

mc ls localS3/testing

and you should see

你应该看到

使用mc删除文件和存储桶 (Deleting files and buckets with mc)

The two commands used to remove buckets and files are

用于删除存储桶和文件的两个命令是

• rm : Removes a file

  rm ：删除文件

• rb : Removes a bucket

  rb ：删除一个桶

I am going to remove the file first

我要先删除文件

mc rm locals3/testing/bensound-goinghigher.mp3

and now to remove the bucket

现在要删除水桶

mc rb localS3/testing

If you again issue the command mc ls localS3 you will find that no results are returned.

如果再次发出命令mc ls localS3您将发现未返回任何结果。

Further mc commands and built in help (Further mc commands and built in help)

There is a lot more you can do with mc the built-in documentation is really helpful. To access the docs simply type mc —-help to get help on a specific command like ls type mc ls --help

mc还可以做很多事情，内置文档确实很有帮助。 要访问文档，只需键入mc —-help即可获得有关ls等特定命令的帮助，请键入mc ls --help

结合使用AWS-SDK和MinIO (Using AWS-SDK with MinIO)

As MinIO has an API compatible with AWS, it’s possible to use the AWS-SDK in your code. Even if your planning to use MinIO in production, using the AWS-SDK allows for a seamless transition to AWS at a future date.

由于MinIO具有与AWS兼容的API，因此可以在代码中使用AWS-SDK 。 即使您计划在生产中使用MinIO，使用AWS-SDK仍可在将来无缝过渡到AWS。

I’m going to demo the AWS-SDK in a small node app.

我将在一个小型节点应用程序中演示AWS-SDK。

In a terminal, issue the following commands

在终端中，发出以下命令

mkdir minio_democd minio_demonpm init -ynpm install aws-sdk

Create a new file app.js, open it in your editor, and add the following code.

创建一个新文件app.js ，在编辑器中将其打开，然后添加以下代码。

Change the endpoint to suit your MinIO store, if you followed the Docker section you can use any port between 9001 and 9004

更改端点以适合您的MinIO存储，如果您遵循Docker部分，则可以使用9001和9004之间的任何端口

If you run the app with the following command

如果您使用以下命令运行该应用程序

node app.js

You should get the following result.

您应该得到以下结果。

The above code creates a new bucket called awstest. It then creates an object with the contents Hello from MinIO! and uploads it to the bucket.

上面的代码创建了一个名为awstest的新存储桶。 然后，它创建一个包含Hello from MinIO!内容的对象Hello from MinIO! 并将其上传到存储桶。

After creating the bucket and object, the SDK is used again to download the object and save it to a local file in your app folder. Take a look, there should be a file called test_from_minio.txt

创建存储桶和对象后，将再次使用SDK下载对象并将其保存到您的应用文件夹中的本地文件中。 看一下，应该有一个名为test_from_minio.txt的文件

摘要 (Summary)

You have learned that MinIO is an Object Storage server with an AWS compatible API.

您已经了解到MinIO是具有AWS兼容API的对象存储服务器。

You can now install MinIO using Docker or homebrew on a Mac

您现在可以在Mac上使用Docker或Homebrew安装MinIO

You have installed mc the MinIO CLI and seen how it can be used to manage your MinIO instance.

您已经安装了mc MinIO CLI，并了解了如何将其用于管理MinIO实例。

You have seen how the aws-sdk can be used in a NodeJS script to interact with MinIO

您已经了解了如何在NodeJS脚本中使用aws-sdk与MinIO进行交互