Minio Client完全指南

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

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

1. 下载Minio Client

Docker稳定版

  1. docker pull minio/mc
  2. docker run minio/mc ls play

Docker尝鲜版

  1. docker pull minio/mc:edge
  2. docker run minio/mc:edge ls play

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

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

然后使用mc config命令

Homebrew (macOS)

使用Homebrew安装mc。

  1. brew install minio/stable/mc
  2. mc --help

下载二进制文件(GNU/Linux)

平台CPU架构URL
GNU/Linux64-bit Intelhttps://dl.minio.io/client/mc/release/linux-amd64/mc
  1. chmod +x mc
  2. ./mc --help

下载二进制文件(Microsoft Windows)

平台CPU架构URL
Microsoft Windows64-bit Intelhttps://dl.minio.io/client/mc/release/windows-amd64/mc.exe
  1. mc.exe --help

通过源码安装

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

如果您没有Golang环境,请按照 如何安装Golang

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

2. 运行Minio Client

GNU/Linux

  1. chmod +x mc
  2. ./mc --help

macOS

  1. chmod 755 mc
  2. ./mc --help

Microsoft Windows

  1. mc.exe --help

3. 添加一个云存储服务

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

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

使用

  1. mc config host add <ALIAS><YOUR-S3-ENDPOINT><YOUR-ACCESS-KEY><YOUR-SECRET-KEY><API-SIGNATURE>

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

示例-Minio云存储

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

  1. mc config host add minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 S3v4

示例-Amazon S3云存储

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

  1. mc config host add s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 S3v4

示例-Google云存储

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

  1. mc config host add gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 S3v2

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

4. 验证

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

示例:

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

  1. mc ls play
  2. [2016-03-2219:47:48 PDT]0Bmy-bucketname/
  3. [2016-03-2222:01:07 PDT]0B mytestbucket/
  4. [2016-03-2220:04:39 PDT]0B mybucketname/
  5. [2016-01-2817:23:11 PST]0B newbucket/
  6. [2016-03-2009:08:36 PDT]0B s3git-test/

5. 日常使用

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

  1. alias ls='mc ls'
  2. alias cp='mc cp'
  3. alias cat='mc cat'
  4. alias mkdir='mc mb'
  5. alias pipe='mc pipe'
  6. alias find='mc find'

6. 全局参数

参数 [—debug]

Debug参数开启控制台输出debug信息。

示例:输出ls命令的详细debug信息。

  1. mc --debug ls play
  2. mc:<DEBUG> GET / HTTP/1.1
  3. Host: play.minio.io:9000
  4. User-Agent:Minio(darwin; amd64) minio-go/1.0.1 mc/2016-04-01T00:22:11Z
  5. Authorization: AWS4-HMAC-SHA256 Credential=**REDACTED**/20160408/us-east-1/s3/aws4_request,SignedHeaders=expect;host;x-amz-content-sha256;x-amz-date,Signature=**REDACTED**
  6. Expect:100-continue
  7. X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
  8. X-Amz-Date:20160408T145236Z
  9. Accept-Encoding: gzip
  10. mc:<DEBUG> HTTP/1.1200 OK
  11. Transfer-Encoding: chunked
  12. Accept-Ranges: bytes
  13. Content-Type: text/xml; charset=utf-8
  14. Date:Fri,08Apr201614:54:55 GMT
  15. Server:Minio/DEVELOPMENT.2016-04-07T18-53-27Z(linux; amd64)
  16. Vary:Origin
  17. X-Amz-Request-Id: HP30I0W2U49BDBIO
  18. mc:<DEBUG>ResponseTime:1.220112837s
  19. [...]
  20. [2016-04-0803:56:14 IST]0B albums/
  21. [2016-04-0416:11:45 IST]0B backup/
  22. [2016-04-0120:10:53 IST]0B deebucket/
  23. [2016-03-2821:53:49 IST]0B guestbucket/

参数 [—json]

JSON参数启用JSON格式的输出。

示例:列出Minio play服务的所有存储桶。

  1. mc --json ls play
  2. {"status":"success","type":"folder","lastModified":"2016-04-08T03:56:14.577+05:30","size":0,"key":"albums/"}
  3. {"status":"success","type":"folder","lastModified":"2016-04-04T16:11:45.349+05:30","size":0,"key":"backup/"}
  4. {"status":"success","type":"folder","lastModified":"2016-04-01T20:10:53.941+05:30","size":0,"key":"deebucket/"}
  5. {"status":"success","type":"folder","lastModified":"2016-03-28T21:53:49.217+05:30","size":0,"key":"guestbucket/"}

参数 [—no-color]

这个参数禁用颜色主题。对于一些比较老的终端有用。

参数 [—quiet]

这个参数关闭控制台日志输出。

参数 [—config-folder]

这个参数参数自定义的配置文件路径。

参数 [ —insecure]

跳过SSL证书验证。

7. 命令

ls - 列出存储桶和对象mb - 创建存储桶cat - 合并对象
cp - 拷贝对象rm - 删除对象pipe - Pipe到一个对象
share - 共享mirror - 存储桶镜像find - 查找文件和对象
diff - 比较存储桶差异policy - 给存储桶或前缀设置访问策略session - 管理保存的会话
config - 管理配置文件watch - 事件监听events - 管理存储桶事件
update - 管理软件更新version - 显示版本信息

ls命令 - 列出对象

ls命令列出文件、对象和存储桶。使用—incomplete flag可列出未完整拷贝的内容。

  1. 用法:
  2. mc ls [FLAGS] TARGET [TARGET ...]
  3. FLAGS:
  4. --help,-h 显示帮助。
  5. --recursive,-r 递归。
  6. --incomplete,-I 列出未完整上传的对象。

示例: 列出所有https://play.minio.io:9000上的存储桶。

  1. mc ls play
  2. [2016-04-0803:56:14 IST]0B albums/
  3. [2016-04-0416:11:45 IST]0B backup/
  4. [2016-04-0120:10:53 IST]0B deebucket/
  5. [2016-03-2821:53:49 IST]0B guestbucket/
  6. [2016-04-0820:58:18 IST]0B mybucket/

mb命令 - 创建存储桶

mb命令在对象存储上创建一个新的存储桶。在文件系统,它就和mkdir -p命令是一样的。存储桶相当于文件系统中的磁盘或挂载点,不应视为文件夹。Minio对每个​​用户创建的存储桶数量没有限制。在Amazon S3上,每个帐户被限制为100个存储桶。有关更多信息,请参阅S3上的存储桶限制和限制

  1. 用法:
  2. mc mb [FLAGS] TARGET [TARGET...]
  3. FLAGS:
  4. --help,-h 显示帮助。
  5. --region "us-east-1"指定存储桶的region,默认是‘us-east-1’.

示例:在https://play.minio.io:9000上创建一个名叫"mybucket"的存储桶。

  1. mc mb play/mybucket
  2. Bucket created successfully play/mybucket’.

cat命令 - 合并对象

cat命令将一个文件或者对象的内容合并到另一个上。你也可以用它将对象的内容输出到stdout。

  1. 用法:
  2. mc cat [FLAGS] SOURCE [SOURCE...]
  3. FLAGS:
  4. --help,-h 显示帮助。

示例: 显示myobject.txt文件的内容

  1. mc cat play/mybucket/myobject.txt
  2. HelloMinio!!

pipe命令 - Pipe到对象

pipe命令拷贝stdin里的内容到目标输出,如果没有指定目标输出,则输出到stdout。

  1. 用法:
  2. mc pipe [FLAGS][TARGET]
  3. FLAGS:
  4. --help,-h 显示帮助。

示例: 将MySQL数据库dump文件输出到Amazon S3。

  1. mysqldump -u root -p ******* accountsdb | mc pipe s3/ferenginar/backups/accountsdb-oct-9-2015.sql

cp命令 - 拷贝对象

cp命令拷贝一个或多个源文件目标输出。所有到对象存储的拷贝操作都进行了MD4SUM checkSUM校验。可以从故障点恢复中断或失败的复制操作。

  1. 用法:
  2. mc cp [FLAGS] SOURCE [SOURCE...] TARGET
  3. FLAGS:
  4. --help,-h 显示帮助。
  5. --recursive,-r 递归拷贝。

示例: 拷贝一个文本文件到对象存储。

  1. mc cp myobject.txt play/mybucket
  2. myobject.txt:14 B /14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓100.00%41 B/s 0

rm命令 - 删除存储桶和对象。

使用rm命令删除文件对象或者存储桶。

  1. 用法:
  2. mc rm [FLAGS] TARGET [TARGET ...]
  3. FLAGS:
  4. --help,-h 显示帮助。
  5. --recursive,-r 递归删除。
  6. --force 强制执行删除操作。
  7. --prefix 删除批配这个前缀的对象。
  8. --incomplete,-I 删除未完整上传的对象。
  9. --fake 模拟一个假的删除操作。
  10. --stdin STDIN中读对象列表。
  11. --older-than value 删除N天前的对象(默认是0天)。

示例: 删除一个对象。

  1. mc rm play/mybucket/myobject.txt
  2. Removedplay/mybucket/myobject.txt’.

示例:删除一个存储桶并递归删除里面所有的内容。由于这个操作太危险了,你必须传—force参数指定强制删除。

  1. mc rm --recursive --force play/myobject
  2. Removedplay/myobject/newfile.txt’.
  3. Removed'play/myobject/otherobject.txt’.

示例: 从mybucket里删除所有未完整上传的对象。

  1. mc rm --incomplete --recursive --force play/mybucket
  2. Removedplay/mybucket/mydvd.iso’.
  3. Removed'play/mybucket/backup.tgz’.

示例: 删除一天前的对象。

  1. mc rm --force --older-than=1 play/mybucket/oldsongs

share命令 - 共享

share命令安全地授予上传或下载的权限。此访问只是临时的,与远程用户和应用程序共享也是安全的。如果你想授予永久访问权限,你可以看看mc policy命令。

生成的网址中含有编码后的访问认证信息,任何企图篡改URL的行为都会使访问无效。想了解这种机制是如何工作的,请参考Pre-Signed URL技术。

  1. 用法:
  2. mc share [FLAGS] COMMAND
  3. FLAGS:
  4. --help,-h 显示帮助。
  5. COMMANDS:
  6. download 生成有下载权限的URL
  7. upload 生成有上传权限的URL
  8. list 列出先前共享的对象和文件夹。

子命令share download - 共享下载

share download命令生成不需要access key和secret key即可下载的URL,过期参数设置成最大有效期(不大于7天),过期之后权限自动回收。

  1. 用法:
  2. mc share download [FLAGS] TARGET [TARGET...]
  3. FLAGS:
  4. --help,-h 显示帮助。
  5. --recursive,-r 递归共享所有对象。
  6. --expire,-E "168h"设置过期时限,NN[h|m|s]。

示例: 生成一个对一个对象有4小时访问权限的URL。

  1. mc share download --expire 4h play/mybucket/myobject.txt
  2. URL: https://play.minio.io:9000/mybucket/myobject.txt
  3. Expire:0 days 4 hours 0 minutes 0 seconds
  4. Share: https://play.minio.io:9000/mybucket/myobject.txt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=Q3AM3UQ867SPQQA43P2F%2F20160408%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20160408T182008Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=1527fc8f21a3a7e39ce3c456907a10b389125047adc552bcd86630b9d459b634

子命令share upload - 共享上传

share upload命令生成不需要access key和secret key即可上传的URL。过期参数设置成最大有效期(不大于7天),过期之后权限自动回收。Content-type参数限制只允许上传指定类型的文件。

  1. 用法:
  2. mc share upload [FLAGS] TARGET [TARGET...]
  3. FLAGS:
  4. --help,-h 显示帮助。
  5. --recursive,-r 递归共享所有对象。
  6. --expire,-E "168h"设置过期时限,NN[h|m|s].

示例: 生成一个curl命令,赋予上传到play/mybucket/myotherobject.txt的权限。

  1. mc share upload play/mybucket/myotherobject.txt
  2. URL: https://play.minio.io:9000/mybucket/myotherobject.txt
  3. Expire:7 days 0 hours 0 minutes 0 seconds
  4. Share: curl https://play.minio.io:9000/mybucket -F x-amz-date=20160408T182356Z -F x-amz-signature=de343934bd0ba38bda0903813b5738f23dde67b4065ea2ec2e4e52f6389e51e1 -F bucket=mybucket -F policy=eyJleHBpcmF0aW9uIjoiMjAxNi0wNC0xNVQxODoyMzo1NS4wMDdaIiwiY29uZGl0aW9ucyI6W1siZXEiLCIkYnVja2V0IiwibXlidWNrZXQiXSxbImVxIiwiJGtleSIsIm15b3RoZXJvYmplY3QudHh0Il0sWyJlcSIsIiR4LWFtei1kYXRlIiwiMjAxNjA0MDhUMTgyMzU2WiJdLFsiZXEiLCIkeC1hbXotYWxnb3JpdGhtIiwiQVdTNC1ITUFDLVNIQTI1NiJdLFsiZXEiLCIkeC1hbXotY3JlZGVudGlhbCIsIlEzQU0zVVE4NjdTUFFRQTQzUDJGLzIwMTYwNDA4L3VzLWVhc3QtMS9zMy9hd3M0X3JlcXVlc3QiXV19 -F x-amz-algorithm=AWS4-HMAC-SHA256 -F x-amz-credential=Q3AM3UQ867SPQQA43P2F/20160408/us-east-1/s3/aws4_request -F key=myotherobject.txt -F file=@<FILE>

子命令share list - 列出之前的共享

share list列出没未过期的共享URL。

  1. 用法:
  2. mc share list COMMAND
  3. COMMAND:
  4. upload:列出先前共享的有上传权限的URL
  5. download:列出先前共享的有下载权限的URL

mirror命令 - 存储桶镜像

mirror命令和rsync类似,只不过它是在文件系统和对象存储之间做同步。

  1. 用法:
  2. mc mirror [FLAGS] SOURCE TARGET
  3. FLAGS:
  4. --help,-h 显示帮助。
  5. --force 强制覆盖已经存在的目标。
  6. --fake 模拟一个假的操作。
  7. --watch,-w 监听改变并执行镜像操作。
  8. --remove 删除目标上的外部的文件。

示例: 将一个本地文件夹镜像到https://play.minio.io:9000上的'mybucket'存储桶。

  1. mc mirror localdir/ play/mybucket
  2. localdir/b.txt:40 B /40 B ┃▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓┃100.00%73 B/s 0

示例: 持续监听本地文件夹修改并镜像到https://play.minio.io:9000上的'mybucket'存储桶。

  1. mc mirror -w localdir play/mybucket
  2. localdir/new.txt:10 MB /10 MB ┃▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓┃100.00%1 MB/s 15s

find命令 - 查找文件和对象

find命令通过指定参数查找文件,它只列出满足条件的数据。

  1. 用法:
  2. mc find PATH [FLAGS]
  3. FLAGS:
  4. --help,-h 显示帮助。
  5. --exec value 为每个匹配对象生成一个外部进程(请参阅FORMAT
  6. --name value 查找匹配通配符模式的对象。
  7. ...
  8. ...

示例: 持续从s3存储桶中查找所有jpeg图像,并复制到minio "play/bucket"存储桶

  1. mc find s3/bucket --name "*.jpg"--watch --exec"mc cp {} play/bucket"

diff命令 - 显示差异

diff命令计算两个目录之间的差异。它只列出缺少的或者大小不同的内容。

比较内容,所以可能的是,名称相同,大小相同但内容不同的对象没有被检测到。这样,它可以在不同站点或者大量数据的情况下快速比较。

  1. 用法:
  2. mc diff [FLAGS] FIRST SECOND
  3. FLAGS:
  4. --help,-h 显示帮助。

示例: 比较一个本地文件夹和一个远程对象存储服务

  1. mc diff localdir play/mybucket
  2. localdir/notes.txtandhttps://play.minio.io:9000/mybucket/notes.txt’ - only in first.

watch命令 - 监听文件和对象存储事件。

watch命令提供了一种方便监听对象存储和文件系统上不同类型事件的方式。

  1. 用法:
  2. mc watch [FLAGS] PATH
  3. FLAGS:
  4. --events value 过滤不同类型的事件,默认是所有类型的事件(默认:"put,delete,get")
  5. --prefix value 基于前缀过滤事件。
  6. --suffix value 基于后缀过滤事件。
  7. --recursive 递归方式监听事件。
  8. --help,-h 显示帮助。

示例: 监听对象存储的所有事件

  1. mc watch play/testbucket
  2. [2016-08-18T00:51:29.735Z]2.7KiBObjectCreated https://play.minio.io:9000/testbucket/CONTRIBUTING.md
  3. [2016-08-18T00:51:29.780Z]1009BObjectCreated https://play.minio.io:9000/testbucket/MAINTAINERS.md
  4. [2016-08-18T00:51:29.839Z]6.9KiBObjectCreated https://play.minio.io:9000/testbucket/README.md

示例: 监听本地文件夹的所有事件

  1. mc watch ~/Photos
  2. [2016-08-17T17:54:19.565Z]3.7MiBObjectCreated/home/minio/Downloads/tmp/5467026530_a8611b53f9_o.jpg
  3. [2016-08-17T17:54:19.565Z]3.7MiBObjectCreated/home/minio/Downloads/tmp/5467026530_a8611b53f9_o.jpg
  4. ...
  5. [2016-08-17T17:54:19.565Z]7.5MiBObjectCreated/home/minio/Downloads/tmp/8771468997_89b762d104_o.jpg

events命令 - 管理存储桶事件通知。

events提供了一种方便的配置存储桶的各种类型事件通知的方式。Minio事件通知可以配置成使用 AMQP,Redis,ElasticSearch,NATS和PostgreSQL服务。Minio configuration提供了如何配置的更多细节。

  1. 用法:
  2. mc events COMMAND [COMMAND FLAGS |-h][ARGUMENTS...]
  3. COMMANDS:
  4. add 添加一个新的存储桶通知。
  5. remove 删除一个存储桶通知。使用'--force'可以删除所有存储桶通知。
  6. list 列出存储桶通知。
  7. FLAGS:
  8. --help,-h 显示帮助。

示例: 列出所有存储桶通知。

  1. mc events list play/andoria
  2. MyTopic arn:minio:sns:us-east-1:1:TestTopic s3:ObjectCreated:*,s3:ObjectRemoved:* suffix:.jpg

示例: 添加一个新的'sqs'通知,仅接收ObjectCreated事件。

  1. mc events add play/andoria arn:minio:sqs:us-east-1:1:your-queue --events put

示例: 添加一个带有过滤器的'sqs'通知。

sqs通知添加prefixsuffix过滤规则。

  1. mc events add play/andoria arn:minio:sqs:us-east-1:1:your-queue --prefix photos/--suffix .jpg

示例: 删除一个'sqs'通知

  1. mc events remove play/andoria arn:minio:sqs:us-east-1:1:your-queue

policy命令 - 管理存储桶策略

管理匿名访问存储桶和其内部内容的策略。

  1. 用法:
  2. mc policy [FLAGS] PERMISSION TARGET
  3. mc policy [FLAGS] TARGET
  4. mc policy list [FLAGS] TARGET
  5. PERMISSION:
  6. Allowed policies are:[none, download, upload,public].
  7. FLAGS:
  8. --help,-h 显示帮助。

示例: 显示当前匿名存储桶策略

显示当前mybucket/myphotos/2020/子文件夹的匿名策略。

  1. mc policy play/mybucket/myphotos/2020/
  2. Access permission forplay/mybucket/myphotos/2020/’isnone

示例:设置可下载的匿名存储桶策略。

设置mybucket/myphotos/2020/子文件夹可匿名下载的策略。现在,这个文件夹下的对象可被公开访问。比如:mybucket/myphotos/2020/yourobjectname可通过这个URL https://play.minio.io:9000/mybucket/myphotos/2020/yourobjectname访问。

  1. mc policy download play/mybucket/myphotos/2020/
  2. Access permission forplay/mybucket/myphotos/2020/’isset to 'download'

示例:删除当前的匿名存储桶策略

删除所有mybucket/myphotos/2020/这个子文件夹下的匿名存储桶策略。

  1. mc policy none play/mybucket/myphotos/2020/
  2. Access permission forplay/mybucket/myphotos/2020/’isset to 'none'

session命令 - 管理session

session命令管理之前保存的cpmirror操作的会话。

  1. 用法:
  2. mc session COMMAND [COMMAND FLAGS |-h][ARGUMENTS...]
  3. COMMANDS:
  4. list 列出所有之前保存的会话。
  5. clear 清除某个之前保存的会话。
  6. resume 恢复某个之前保存的会话。
  7. FLAGS:
  8. --help,-h 显示帮助。

示例: 列出所有之前保存的会话

  1. mc session list
  2. IXWKjpQM->[2016-04-0819:11:14 IST] cp assets.go play/mybucket
  3. ApwAxSwa->[2016-04-0801:49:19 IST] mirror miniodoc/ play/mybucket

示例: 恢复一个之前保存的会话

  1. mc session resume IXWKjpQM
  2. ...assets.go:1.68 KB /1.68 KB ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓100.00%784 B/s 2s

示例: 清除一个之前保存的会话。

  1. mc session clear ApwAxSwa
  2. SessionApwAxSwa cleared successfully.

config命令 - 管理配置文件

config host命令提供了一个方便地管理~/.mc/config.json配置文件中的主机信息的方式,你也可以用文本编辑器手动修改这个配置文件。

  1. 用法:
  2. mc config host COMMAND [COMMAND FLAGS |-h][ARGUMENTS...]
  3. COMMANDS:
  4. add, a 添加一个新的主机到配置文件。
  5. remove, rm 从配置文件中删除一个主机。
  6. list, ls 列出配置文件中的主机。
  7. FLAGS:
  8. --help,-h 显示帮助。

示例: 管理配置文件

添加Minio服务的access和secret key到配置文件,注意,shell的history特性可能会记录这些信息,从而带来安全隐患。在bash shell,使用set -oset +o来关闭和开启history特性。

  1. set+o history
  2. mc config host add myminio http://localhost:9000 OMQAGGOL63D7UNVQFY8X GcY5RHNmnEWvD/1QxD3spEIGj+Vt9L7eHaAaBTkJ
  3. set-o history

update命令 - 软件更新

https://dl.minio.io检查软件更新。Experimental标志会检查unstable实验性的版本,通常用作测试用途。

  1. 用法:
  2. mc update [FLAGS]
  3. FLAGS:
  4. --quiet,-q 关闭控制台输出。
  5. --json 使用JSON格式输出。
  6. --help,-h 显示帮助。

示例: 检查更新

  1. mc update
  2. You are already running the most recent version of mc’.

version命令 - 显示版本信息

显示当前安装的mc版本。

  1. 用法:
  2. mc version [FLAGS]
  3. FLAGS:
  4. --quiet,-q 关闭控制台输出。
  5. --json 使用JSON格式输出。
  6. --help,-h 显示帮助。

示例: 输出mc版本。

  1. mc version
  2. Version:2016-04-01T00:22:11Z
  3. Release-tag: RELEASE.2016-04-01T00-22-11Z
  4. Commit-id:12adf3be326f5b6610cdd1438f72dfd861597fce

原文: https://docs.minio.io/cn/minio-client-complete-guide.html