MinIO Client(mc)是UNIX命令(如ls、cat、cp等)的现代替代工具,支持本地文件系统和Amazon S3兼容的云存储服务,提供丰富的对象存储管理功能。
MinIO Client Quickstart Guide
MinIO Client (mc) provides a modern alternative to UNIX commands like ls, cat, cp, mirror, diff, find etc. It supports filesystems and Amazon S3 compatible cloud storage service (AWS Signature v2 and v4).
alias set, remove and list aliases in configuration file ls list buckets and objects mb make a bucket rb remove a bucket cp copy objects mirror synchronize object(s) to a remote site cat display object contents head display first 'n' lines of an object pipe stream STDIN to an object share generate URL for temporary access to an object find search for objects sql run sql queries on objects stat show object metadata mv move objects tree list buckets and objects in a tree format du summarize disk usage recursively retention set retention for object(s) legalhold set legal hold for object(s) diff list differences in object name, size, and date between two buckets rm remove objects encrypt manage bucket encryption config event manage object notifications watch listen for object notification events undo undo PUT/DELETE operations anonymous manage anonymous access to buckets and objects tag manage tags for bucket(s) and object(s) ilm manage bucket lifecycle version manage bucket versioning replicate configure server side bucket replication admin manage MinIO servers update update mc to latest release ping perform liveness check
Docker Container
Stable
docker pull jumpserver/mc docker run jumpserver/mc ls play
Edge
docker pull minio/mc:edge docker run minio/mc:edge ls play
Note: Above examples run mc against MinIO play environment by default. To run mc against other S3 compatible servers, start the container this way:
docker run -it --entrypoint=/bin/sh jumpserver/mc
then use the mc alias command.
GitLab CI
When using the Docker container in GitLab CI, you must https://docs.gitlab.com/ee/ci/docker/using_docker_images.html#override-the-entrypoint-of-an-image.
deploy: image: name: jumpserver/mc entrypoint: [''] stage: deploy before_script: - mc alias set minio $MINIO_HOST $MINIO_ACCESS_KEY $MINIO_SECRET_KEY script: - mc cp <source> <destination>
macOS
Homebrew
Install mc packages using Homebrew
brew install minio/stable/mc mc --help
GNU/Linux
Binary Download
| Platform | Architecture | URL |
|---|---|---|
| GNU/Linux | 64-bit Intel | https://dl.min.io/client/mc/release/linux-amd64/mc |
| 64-bit PPC | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
wget https://dl.min.io/client/mc/release/linux-amd64/mc chmod +x mc ./mc --help
Microsoft Windows
Binary Download
| Platform | Architecture | URL |
|---|---|---|
| Microsoft Windows | 64-bit Intel | https://dl.min.io/client/mc/release/windows-amd64/mc.exe |
mc.exe --help
Install from Source
Source installation is only intended for developers and advanced users. If you do not have a working Golang environment, please follow https://golang.org/doc/install. Minimum version required is https://golang.org/dl/#stable
shgo install github.com/minio/mc@latest
Add a Cloud Storage Service
If you are planning to use mc only on POSIX compatible filesystems, you may skip this step and proceed to everyday use.
To add one or more Amazon S3 compatible hosts, please follow the instructions below. mc stores all its configuration information in ~/.mc/config.json file.
mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE> --path <BUCKET-LOOKUP-TYPE>
<ALIAS> is simply a short name to your cloud storage service. S3 end-point, access and secret keys are supplied by your cloud storage provider. API signature is an optional argument. By default, it is set to "S3v4".
Path is an optional argument. It is used to indicate whether dns or path style url requests are supported by the server. It accepts "on", "off" as valid values to enable/disable path style requests.. By default, it is set to "auto" and SDK automatically determines the type of url lookup to use.
Example - MinIO Cloud Storage
MinIO server startup banner displays URL, access and secret keys.
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Example - Amazon S3 Cloud Storage
Get your AccessKeyID and SecretAccessKey by following http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html.
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Note: As an IAM user on Amazon S3 you need to make sure the user has full access to the buckets or set the following restricted policy for your IAM user
json{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowBucketStat", "Effect": "Allow", "Action": [ "s3:HeadBucket" ], "Resource": "*" }, { "Sid": "AllowThisBucketOnly", "Effect": "Allow", "Action": "s3:*", "Resource": [ "arn:aws:s3:::<your-restricted-bucket>/*", "arn:aws:s3:::<your-restricted-bucket>" ] } ] }
Example - Google Cloud Storage
Get your AccessKeyID and SecretAccessKey by following https://cloud.google.com/storage/docs/migrating?hl=en#keys
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Example - IBM Cloud Object Storage
See the complete guide for IBM instructions.
Test Your Setup
mc is pre-configured with [***] aliased as "play". It is a hosted MinIO server for testing and development purpose. To test Amazon S3, simply replace "play" with "s3" or the alias you used at the time of setup.
Example:
List all buckets from 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/
Make a bucket
mb command creates a new bucket.
Example:
mc mb play/mybucket Bucket created successfully `play/mybucket`.
Copy Objects
cp command copies data from one or more sources to a target.
Example:
mc cp myobject.txt play/mybucket myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Everyday Use
Shell aliases
You may add shell aliases to override your common Unix tools.
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 autocompletion
In case you are using bash, zsh or fish. Shell completion is embedded by default in mc, to install auto-completion use mc --autocompletion. Restart the shell, mc will auto-complete commands as shown below.
mc <TAB> admin config diff find ls mirror policy session sql update watch cat cp event head mb pipe rm share stat version
Explore Further
- https://min.io/docs/minio/linux/reference/minio-mc.html?ref=gh
- https://min.io/docs/minio/linux/index.html#quickstart-for-linux?ref=gh
- https://min.io/docs/minio/linux/index.html?ref=gh
Contribute to MinIO Project
Please follow MinIO https://github.com/minio/mc/blob/master/CONTRIBUTING.md
License
Use of mc is governed by the GNU AGPLv3 license that can be found in the https://github.com/minio/mc/blob/master/LICENSE file.
jumpserver 命名空间的其他可用镜像:
更多相关 Docker 镜像与资源
以下是 jumpserver/mc 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务