# 分布式对象存储 MinIO 客户端 mc 的使用 {#分布式对象存储-minio-客户端-mc-的使用}

本文介绍开源的分布式对象存储服务 MinIO 的客户端的使用方法。对象存储系统相比于传统的 NAS 文件系统有很多的优势，访问效率高、方便扩容，支持分布式等特性。MinIO 基于 Goland 开发，所以部署非常方便。

MinIO 服务的搭建步骤请前往搭建分布式对象存储服务 MinIO-单点模式

# 1. 安装客户端工具 mc {#_1-安装客户端工具-mc}

# 1.1 docker 方式安装 {#_1-1-docker-方式安装}

执行如下命令，完成安装，并进入容器内

docker run -it --entrypoint=/bin/sh minio/mc

# 1.2 二进制方式安装 {#_1-2-二进制方式安装}

curl -O https://dl.min.io/client/mc/release/linux-amd64/mc

# 2. 云主机的管理 {#_2-云主机的管理}

# 2.1 添加主机 {#_2-1-添加主机}

MinIO 除了支持 MinIO 之外，还支持 aws 对象存储。本章节以添加MinIO 云存储 为例。
命令格式:

mc config host add <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> [--api API-SIGNATURE]

别名就是给你的云存储服务起了一个短点的外号。S3 endpoint,access key 和 secret key 是你的云存储服务提供的。API 签名是可选参数，默认情况下，它被设置为"S3v4"。

示例如下:

mc config host add minio http://172.18.100.177:9000 minioadmin minioadmin --api s3v4

# 2.2 删除主机 {#_2-2-删除主机}

mc config host remove 主机名称
示例: mc config host remove minio

# 2.3 查询关联的主机列表 {#_2-3-查询关联的主机列表}

mc config host ls
示例如下:

IDC:: root@uy02-01-v18:~# ./mc config host ls
gcs  
  URL       : https://storage.googleapis.com
  AccessKey : YOUR-ACCESS-KEY-HERE
  SecretKey : YOUR-SECRET-KEY-HERE
  API       : S3v2
  Path      : dns

local
  URL       : http://localhost:9000
  AccessKey : 
  SecretKey :                                                                                                                                  
  API       : 
  Path      : auto

minio
  URL       : http://192.168.11.13:9000
  AccessKey : admin
  SecretKey : novelimg
  API       : s3v4
  Path      : auto

play 
  URL       : https://play.min.io
  AccessKey : Q3AM3UQ867SPQQA43P2F
  SecretKey : zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG
  API       : S3v4
  Path      : auto

s3   
  URL       : https://s3.amazonaws.com
  AccessKey : YOUR-ACCESS-KEY-HERE
  SecretKey : YOUR-SECRET-KEY-HERE
  API       : S3v4
  Path      : dns

IDC:: root@uy02-01-v18:~#

# 2.4 某主机下的桶管理 {#_2-4-某主机下的桶管理}

# 2.4.1 创建桶 {#_2-4-1-创建桶}

mc mb minio/bucket1
示例如下:

IDC:: root@uy02-01-v18:~# ./mc mb minio/bucket1
Bucket created successfully `minio/bucket1`.
IDC:: root@uy02-01-v18:~#

# 2.4.2 删除桶 {#_2-4-2-删除桶}

mc rm minio/bucket1

# 2.4.3 查询某个主机下的桶列表 {#_2-4-3-查询某个主机下的桶列表}

mc ls 主机名称
示例如下:

/ # mc ls minio
[2020-10-29 08:56:20 UTC]     0B bucket1/
/ #

# 2.5 上传文件 {#_2-5-上传文件}

mc cp 本地文件路径桶的路径
示例如下:

IDC:: root@uy02-01-v18:~# ./mc cp ./test123.txt minio/bucket1
./test123.txt:            8 B / 8 B ┃▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓┃ 125 B/s 0sIDC:: root@uy02-01-v18:~# ░░░░░░░░░░░░░░░░░░▓┃
IDC:: root@uy02-01-v18:~#