diff --git a/docs/minio.md b/docs/minio.md index 4741506d..37006ba5 100644 --- a/docs/minio.md +++ b/docs/minio.md @@ -181,13 +181,13 @@ mc rb myminio/mybucket/folder 移动文件夹 ```sh -mc mv myminio/mybucket/folder myminio/mybucket/newfolder +mc mv -r myminio/mybucket/folder myminio/mybucket/newfolder ``` 拷贝文件夹 ```sh -mc cp myminio/mybucket/folder myminio/mybucket/newfolder +mc cp -r myminio/mybucket/folder myminio/mybucket/newfolder ``` 删除文件夹中的所有文件 @@ -228,6 +228,228 @@ mc help mc version ``` +Admin 常用管理命令 +--- + +### mc admin 管理操作 + + +`mc admin` 用于管理 MinIO 服务端(需要具备相应管理权限的账号/策略)。 + +#### 常用全局参数(`mc` 全局,对 `mc admin` 同样适用) + +参数 | 说明 +---- | ---- +`--json` | 输出 JSON,便于脚本解析与自动化处理 +`--debug` | 打印调试信息(排查权限/网络/签名等问题) +`--insecure` | 跳过 TLS 证书校验(自签名证书/测试环境常用) +`-C, --config-dir ` | 指定 `mc` 配置目录(多环境隔离) +`-q, --quiet` | 静默模式,减少非必要输出 +`--no-color` | 禁用彩色输出(CI/日志更友好) +`--dp, --disable-pager` | 禁用分页器(管道/重定向场景更稳定) +`-H, --custom-header ':'` | 追加自定义 HTTP Header + + +### mc admin info(节点/集群信息) + +查看 MinIO 服务信息(集群/节点/版本等)。 + +```sh +mc admin info [--offline] TARGET +``` + +常用参数: + +参数 | 说明 +---- | ---- +`--offline` | 允许在部分节点离线的情况下返回可用信息(排障场景常用) + + +示例: + +```sh +mc admin info myminio +mc admin info --offline myminio +mc admin info --json myminio +``` + +### mc admin logs(服务端日志) + + +按需拉取服务端日志输出(可指定节点)。 + +```sh +mc admin logs [--last ] [--type ] TARGET [NODE] +``` + +常用参数: + +参数 | 说明 +---- | ---- +`-l, --last ` | 返回最近 N 条日志 +`-t, --type ` | 指定服务类型(常见:`minio`) + + +示例: + +```sh +mc admin logs myminio +mc admin logs --last 100 myminio +mc admin logs --type minio myminio +mc admin logs --json --last 200 myminio +mc admin logs myminio http://minio-node-1:9000 +``` + +### mc admin accesskey(访问密钥 / Service Account) + + +用于创建与管理用户的访问密钥(常用于给应用/CI 生成可控权限的 Service Account)。 + +> 注:从 `mc` **2024-10-08** 起开始提供 `mc admin accesskey`(旧版本可能使用 `mc admin user svcacct` 等命令族)。 + +#### create(创建) + +```sh +# 用户名可忽略,默认为当前用户 +mc admin accesskey create [FLAGS] TARGET [USERNAME] +``` + +常用参数: + +参数 | 说明 +---- | ---- +`--access-key ` | 指定 Access Key(不指定则自动生成) +`--secret-key ` | 指定 Secret Key(不指定则自动生成) +`--comment ` | 为该密钥添加备注 +`--expiry ` | 设置过期时间/有效期(不指定则为永久有效) +`--policy ` | 直接传入策略 JSON(为该密钥绑定权限) +`--policy-file ` | 从文件加载策略 JSON +`--description ` | 描述信息 + + +示例: + +```sh +mc admin accesskey create myminio +mc admin accesskey create --comment "ci" --policy-file ./readonly.json myminio appuser +mc admin accesskey create --access-key "$AK" --secret-key "$SK" --expiry 168h myminio appuser +``` + +#### edit(编辑) + +```sh +mc admin accesskey edit [FLAGS] TARGET ACCESSKEY +``` + +常用参数: + +参数 | 说明 +---- | ---- +`--comment ` | 更新备注 +`--expiry ` | 更新过期时间/有效期 +`--policy ` | 更新策略 JSON +`--policy-file ` | 从文件更新策略 JSON +`--description ` | 更新描述信息 + + +示例: + +```sh +mc admin accesskey edit --comment "rotate-2026-01" myminio "$AK" +mc admin accesskey edit --policy-file ./writeonly.json myminio "$AK" +``` + +#### info(查看详情) + +```sh +mc admin accesskey info TARGET ACCESSKEY +``` + +示例: + +```sh +mc admin accesskey info myminio "$AK" +mc admin accesskey info --json myminio "$AK" +``` + +#### ls(列表) + +```sh +mc admin accesskey ls [FLAGS] TARGET [USERNAME] +``` + +常用参数: + +参数 | 说明 +---- | ---- +`--all` | 列出所有用户(含临时用户) +`--self` | 仅列出当前用户 +`--svcacc-only` | 仅列出临时 STS Key +`--temp-only` | 仅列出有 Access Key 的用户(只返回存在关联密钥的用户) +`--users-only` | 仅列出用户(不含临时 Key) + + +示例: + +```sh +mc admin accesskey ls myminio +mc admin accesskey ls myminio appuser +mc admin accesskey ls --users-only myminio +mc admin accesskey ls --svcacc-only myminio +``` + +#### enable / disable(启用 / 禁用) + +```sh +mc admin accesskey enable TARGET ACCESSKEY +mc admin accesskey disable TARGET ACCESSKEY +``` + +示例: + +```sh +mc admin accesskey disable myminio "$AK" +mc admin accesskey enable myminio "$AK" +``` + +`$AK` 替换为你的AccessKey + +#### rm(删除) + +```sh +mc admin accesskey rm TARGET ACCESSKEY +``` + +示例: + +```sh +mc admin accesskey rm myminio "$AK" +``` + +#### sts-revoke(撤销 STS 临时凭证) + +```sh +mc admin accesskey sts-revoke [FLAGS] TARGET [STS-KEY ...] +``` + +常用参数: + +参数 | 说明 +---- | ---- +`--all` | 撤销全部 STS Key +`--self` | 撤销当前用户的 STS Key +`--token-type ` | 仅撤销指定类型的 Token(例如 `web`、`api`) + + +示例: + +```sh +mc admin accesskey sts-revoke --self myminio +mc admin accesskey sts-revoke --all myminio +mc admin accesskey sts-revoke --token-type web myminio +mc admin accesskey sts-revoke myminio "$STS_KEY" +``` + 另见 ---