title: "MinIO客户端快速入门指南mc"
date: 2021-01-25T19:51:35+08:00
draft: true
tags: ['minio']
author: "dadigang"
author_cn: "大地缸"
personal: "http://www.real007.cn"

关于作者

http://www.real007.cn/about

image

](javascript:window.open('http://www.minio.org.cn/');)

• MinIO服务器 - MinIO快速入门指南
  • MinIO Docker快速入门
  • MinIO纠删码快速入门
  • 分布式MinIO快速入门
  • 使用MinIO分解后的Spark和Hadoop Hive
  • 使用TLS安全的访问MinIO服务
  • MinIO存储桶通知指南
  • MinIO服务限制/租户
  • MinIO Server配置指南
  • MinIO多租户（Multi-tenant）部署指南
  • MinIO Azure网关
  • MinIO GCS网关
  • MinIO NAS网关
  • MinIO S3网关
  • MinIO HDFS网关
  • MinIO磁盘缓存指南
  • MinIO监控指南
  • 如何使用Prometheus监控MinIO
  • MinIO Federation快速入门指南
  • MinIO KMS快速入门指南
  • MinIO Select API快速入门指南
  • MinIO压缩指南
  • MinIO多用户快速入门指南
  • MinIO STS快速入门指南
• MinIO部署 - MinIO部署快速入门
  • 使用Docker Swarm部署MinIO
  • 使用Kubernetes部署MinIO
  • 使用Docker Compose部署MinIO
• MinIO客户端 - MinIO客户端快速入门指南
  • MinIO Client完全指南
  • MinIO Admin完全指南
• MinIO SDKs - JavaScript Client快速入门指南
  • JavaScript Client API参考文档
  • Java Client快速入门指南
  • Java Client API参考文档
  • Python Client快速入门指南
  • Python Client API参考文档
  • Golang Client快速入门指南
  • Golang Client API参考文档
  • .NET Client快速入门指南
  • .NET Client API参考文档
  • Haskell客户端快速入门指南
  • Haskell客户端API参考
• 实战秘籍 - 使用S3cmd操作MinIO
  • 使用AWS CLI结合MinIO
  • restic结合MinIO
  • 将MySQL备份存储到MinIO
  • 将MongoDB备份存储到MinIO
  • 将PostgreSQL备份存储到MinIO
  • 为MinIO设置Caddy proxy
  • 为MinIO设置Nginx代理
  • 将Apache日志存储到MinIO
  • Rclone结合MinIO Server
  • 结合MinIO运行Deis Workflow
  • 为MinIO Server设置Apache HTTP proxy
  • 使用pre-signed URLs通过浏览器上传
  • 如何在FreeNAS中运行MinIO?
  • 如何使用Cyberduck结合MinIO
  • 如何使用AWS SDK for PHP操作MinIO Server
  • 如何使用AWS SDK for Ruby操作MinIO Server
  • 如何使用AWS SDK for Python操作MinIO Server
  • 如何使用Mountain Duck结合MinIO
  • 如何使用AWS SDK for Javascript操作MinIO Server
  • 如何使用Træfɪk代理多个MinIO服务
  • 如何使用AWS SDK for Go操作MinIO Server
  • 如何使用AWS SDK for Java操作MinIO Server
  • 如何使用Paperclip操作MinIO Server
  • 如何使用AWS SDK for .NET操作MinIO Server
  • 如何使用aws-cli调用MinIO服务端加密

MinIO客户端快速入门指南

[图片上传失败...(image-d9741-1611666481422)][图片上传失败...(image-a6e3ee-1611666481422)][图片上传失败...(image-db78eb-1611666481422)]

MinIO Client (mc)为ls，cat，cp，mirror，diff，find等UNIX命令提供了一种替代方案。它支持文件系统和兼容Amazon S3的云存储服务（AWS Signature v2和v4）。

ls       列出文件和文件夹。
mb       创建一个存储桶或一个文件夹。
cat      显示文件和对象内容。
pipe     将一个STDIN重定向到一个对象或者文件或者STDOUT。
share    生成用于共享的URL。
cp       拷贝文件和对象。
mirror   给存储桶和文件夹做镜像。
find     基于参数查找文件。
diff     对两个文件夹或者存储桶比较差异。
rm       删除文件和对象。
events   管理对象通知。
watch    监听文件和对象的事件。
policy   管理访问策略。
session  为cp命令管理保存的会话。
config   管理mc配置文件。
update   检查软件更新。
version  输出版本信息。

Docker容器

稳定版

docker pull minio/mc
docker run minio/mc ls play

尝鲜版

docker pull minio/mc:edge
docker run minio/mc:edge ls play

注意: 上述示例默认使用MinIO 演示环境 做演示，如果想用mc操作其它S3兼容的服务，采用下面的方式来启动容器：

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

然后使用 mc config命令。

macOS

Homebrew

使用 Homebrew 安装mc。

brew install minio/stable/mc
mc --help

GNU/Linux

下载二进制文件

平台CPU架构URLGNU/Linux64-bit Intelhttp://dl.minio.org.cn/client/mc/release/linux-amd64/mc

chmod +x mc
./mc --help

Microsoft Windows

下载二进制文件

平台CPU架构URLMicrosoft Windows64-bit Intelhttp://dl.minio.org.cn/client/mc/release/windows-amd64/mc.exe

mc.exe --help

通过源码安装

通过源码安装仅适用于开发人员和高级用户。mc update命令不支持基于源码安装的更新通知。请从https://min.io/download/#minio-client下载官方版本。

如果您没有Golang环境，请参照 如何安装Golang。

go get -d github.com/minio/mc
cd ${GOPATH}/src/github.com/minio/mc
make

添加一个云存储服务

如果你打算仅在POSIX兼容文件系统中使用mc,那你可以直接略过本节，跳到 日常使用。

添加一个或多个S3兼容的服务，请参考下面说明。mc将所有的配置信息都存储在~/.mc/config.json文件中。

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"。

示例-MinIO云存储

从MinIO服务获得URL、access key和secret key。

mc config host add minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 --api s3v4

示例-Amazon S3云存储

参考 AWS Credentials指南 获取你的AccessKeyID和SecretAccessKey。

mc config host add s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 --api s3v4

示例-Google云存储

参考 Google Credentials Guide 获取你的AccessKeyID和SecretAccessKey。

mc config host add gcs  https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 --api s3v2

注意：Google云存储只支持旧版签名版本V2，所以你需要选择S3v2。

验证

mc预先配置了云存储服务URL： https://play.min.io，别名“play”。它是一个用于研发和测试的MinIO服务。如果想测试Amazon S3,你可以将“play”替换为“s3”。

示例:

列出https://play.min.io上的所有存储桶。

mc ls play
[2016-03-22 19:47:48 PDT]     0B my-bucketname/
[2016-03-22 22:01:07 PDT]     0B mytestbucket/
[2016-03-22 20:04:39 PDT]     0B mybucketname/
[2016-01-28 17:23:11 PST]     0B newbucket/
[2016-03-20 09:08:36 PDT]     0B s3git-test/

日常使用

Shell别名

你可以添加shell别名来覆盖默认的Unix工具命令。

alias ls='mc ls'
alias cp='mc cp'
alias cat='mc cat'
alias mkdir='mc mb'
alias pipe='mc pipe'
alias find='mc find'

Shell自动补全

你也可以下载 autocomplete/bash_autocomplete 到/etc/bash_completion.d/，然后将其重命名为mc。别忘了在这个文件运行source命令让其在你的当前shell上可用。

sudo wget https://raw.githubusercontent.com/minio/mc/master/autocomplete/bash_autocomplete -O /etc/bash_completion.d/mc
source /etc/bash_completion.d/mc

mc <TAB>
admin    config   diff     ls       mirror   policy   session  update   watch
cat      cp       events   mb       pipe     rm       share    version

了解更多

• MinIO Client完全指南
• MinIO快速入门
• MinIO官方文档

贡献

请遵守MinIO 贡献者指南

[如有问题，请到社区讨论](javascript:window.open('http://slack.minio.org.cn/questions');)