ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

minio命令行详解

2026/9/19 5:26:28 拓冰建站 浏览量
minio命令行详解

客户端命令–mc

NAME:mc - MinIO Client for object storage and filesystems.USAGE:mc [FLAGS] COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]COMMANDS:alias      manage server credentials in configuration filels         list buckets and objectsmb         make a bucketrb         remove a bucketcp         copy objectsmv         move objectsrm         remove object(s)mirror     synchronize object(s) to a remote sitecat        display object contentshead       display first 'n' lines of an objectpipe       stream STDIN to an objectfind       search for objectssql        run sql queries on objectsstat       show object metadatatree       list buckets and objects in a tree formatdu         summarize disk usage recursivelyretention  set retention for object(s)legalhold  manage legal hold for object(s)support    support related commandslicense    license related commandsshare      generate URL for temporary access to an objectversion    manage bucket versioningilm        manage bucket lifecycleencrypt    manage bucket encryption configevent      manage object notificationswatch      listen for object notification eventsundo       undo PUT/DELETE operationsanonymous  manage anonymous access to buckets and objectstag        manage tags for bucket and object(s)diff       list differences in object name, size, and date between two bucketsreplicate  configure server side bucket replicationadmin      manage MinIO serversupdate     update mc to latest releaseready      checks if the cluster is ready or notping       perform liveness checkod         measure single stream upload and downloadbatch      manage batch jobsGLOBAL FLAGS:--autocompletion              install auto-completion for your shell--config-dir value, -C value  path to configuration folder (default: "/root/.mc")--quiet, -q                   disable progress bar display--no-color                    disable color theme--json                        enable JSON lines formatted output--debug                       enable debug output--insecure                    disable SSL certificate verification--help, -h                    show help--version, -v                 print the version  

bucket子命令

ls

NAME:mc ls - list buckets and objectsUSAGE:mc ls [FLAGS] TARGET [TARGET ...]FLAGS:--rewind value                     list all object versions no later than specified date--versions                         list all versions--recursive, -r                    list recursively--incomplete, -I                   list incomplete uploads--summarize                        display summary information (number of objects, total size)--storage-class value, --sc value  filter to specified storage class--zip                              list files inside zip archive (MinIO servers only)--config-dir value, -C value       path to configuration folder (default: "/root/.mc")--quiet, -q                        disable progress bar display--no-color                         disable color theme--json                             enable JSON lines formatted output--debug                            enable debug output--insecure                         disable SSL certificate verification

mb

NAME:mc mb - make a bucketUSAGE:mc mb [FLAGS] TARGET [TARGET...]FLAGS:--region value                specify bucket region; defaults to 'us-east-1' (default: "us-east-1")--ignore-existing, -p         ignore if bucket/directory already exists--with-lock, -l               enable object lock--with-versioning             enable versioned bucket--config-dir value, -C value  path to configuration folder (default: "/root/.mc")--quiet, -q                   disable progress bar display--no-color                    disable color theme--json                        enable JSON lines formatted output--debug                       enable debug output--insecure                    disable SSL certificate verification--help, -h                    show help

rb

NAME:mc rb - remove a bucketUSAGE:mc rb [FLAGS] TARGET [TARGET...]FLAGS:--force                       force a recursive remove operation on all object versions--dangerous                   allow site-wide removal of objects--config-dir value, -C value  path to configuration folder (default: "/root/.mc")--quiet, -q                   disable progress bar display--no-color                    disable color theme--json                        enable JSON lines formatted output--debug                       enable debug output--insecure                    disable SSL certificate verification--help, -h                    show help

object子命令

cp

拷贝本地文件到minio服务器 ,或者从minio服务器拷贝文件到本地。

NAME:mc cp - copy objectsUSAGE:mc cp [FLAGS] SOURCE [SOURCE...] TARGETFLAGS:--rewind value                     roll back object(s) to current version at specified time--version-id value, --vid value    select an object version to copy--recursive, -r                    copy recursively--older-than value                 copy objects older than value in duration string (e.g. 7d10h31s)--newer-than value                 copy objects newer than value in duration string (e.g. 7d10h31s)--storage-class value, --sc value  set storage class for new object(s) on target--encrypt value                    encrypt/decrypt objects (using server-side encryption with server managed keys)--attr value                       add custom metadata for the object--continue, -c                     create or resume copy session--preserve, -a                     preserve filesystem attributes (mode, ownership, timestamps)--disable-multipart                disable multipart upload feature--md5                              force all upload(s) to calculate md5sum checksum--tags value                       apply one or more tags to the uploaded objects--retention-mode value             retention mode to be applied on the object (governance, compliance)--retention-duration value         retention duration for the object in d days or y years--legal-hold value                 apply legal hold to the copied object (on, off)--zip                              Extract from remote zip file (MinIO server source only)--encrypt-key value                encrypt/decrypt objects (using server-side encryption with customer provided keys)--config-dir value, -C value       path to configuration folder (default: "/root/.mc")--quiet, -q                        disable progress bar display--no-color                         disable color theme--json                             enable JSON lines formatted output--debug                            enable debug output--insecure                         disable SSL certificate verification--help, -h                         show helpENVIRONMENT VARIABLES:MC_ENCRYPT:      list of comma delimited prefixesMC_ENCRYPT_KEY:  list of comma delimited prefix=secret values

配置子命令

config

NAME:mc config - configure MinIO clientUSAGE:mc config COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]COMMANDS:host  add, remove and list hosts in configuration fileFLAGS:--config-dir value, -C value  path to configuration folder (default: "/root/.mc")--quiet, -q                   disable progress bar display--no-color                    disable color theme--json                        enable JSON lines formatted output--debug                       enable debug output--insecure                    disable SSL certificate verification--help, -h                    show help

alias

管理服务器凭据。

  mc alias - manage server credentials in configuration fileUSAGE:mc alias COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]COMMANDS:set, s      set a new alias to configuration filelist, ls    list aliases in configuration fileremove, rm  remove an alias from configuration fileimport, i   import configuration info to configuration file from a JSON formatted string FLAGS:--config-dir value, -C value  path to configuration folder (default: "/home/jurassic/.mc")--quiet, -q                   disable progress bar display--no-color                    disable color theme--json                        enable JSON lines formatted output--debug                       enable debug output--insecure                    disable SSL certificate verification--help, -h                    show help

示例

配置minio客户端

#查看配置的host列表
mc config host list
#增加minio服务器端配置
mc config host add <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> [--api API-SIGNATURE]

操作minio服务器端

#格式
mc ls   <ALIAS> /<BUCKET>/<OBJECT>
mc ls prod/cloud-quality/

上传文件到minio

mc cp <localFile>  <objectName>

下载文件到本地

mc cp  <objectName>  <localFile>
mc cp prod/cloud-quality/mc.txt ./

附录

参考

版本:c version RELEASE.2022-10-09T21-10-59Z (commit-id=27322636ae33611cf193a0fe4b5de18f3b096549)