Files
reference/docs/minio.html
jaywcjlove 0af5e6100f doc: improve minio.md (add common admin commands and fix some issues) (#1019)
* doc: include recursive options for moving and copying folders

* doc: add  mc admin  commands 886d5d749b
2026-01-18 09:14:40 +00:00

481 lines
41 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en" data-color-mode="dark">
<head>
<meta charset="utf-8">
<title>MinIO 备忘清单
&#x26; minio cheatsheet &#x26; Quick Reference</title>
<meta content="width=device-width, initial-scale=1" name="viewport">
<meta description="这是 MinIO 语法的快速参考备忘单
MinIO 快速参考,为开发人员分享快速参考备忘单。">
<meta keywords="minio,reference,Quick,Reference,cheatsheet,cheat,sheet">
<meta name="author" content="jaywcjlove">
<meta name="license" content="MIT">
<meta name="funding" content="https://jaywcjlove.github.io/#/sponsor">
<meta rel="apple-touch-icon" href="../icons/touch-icon-iphone.png">
<meta rel="apple-touch-icon" sizes="152x152" href="../icons/touch-icon-ipad.png">
<meta rel="apple-touch-icon" sizes="180x180" href="../icons/touch-icon-iphone.png">
<meta rel="apple-touch-icon" sizes="167x167" href="../icons/touch-icon-ipad-retina.png">
<meta rel="apple-touch-icon" sizes="120x120" href="../icons/touch-icon-iphone-retina.png">
<link rel="icon" href="../icons/favicon.svg" type="image/svg+xml">
<link href="../style/style.css" rel="stylesheet">
<link href="../style/katex.css" rel="stylesheet">
</head>
<body><nav class="header-nav"><div class="max-container"><a href="../index.html" class="logo"><svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" height="1em" width="1em">
<path d="m21.66 10.44-.98 4.18c-.84 3.61-2.5 5.07-5.62 4.77-.5-.04-1.04-.13-1.62-.27l-1.68-.4c-4.17-.99-5.46-3.05-4.48-7.23l.98-4.19c.2-.85.44-1.59.74-2.2 1.17-2.42 3.16-3.07 6.5-2.28l1.67.39c4.19.98 5.47 3.05 4.49 7.23Z" fill="#c9d1d9"></path>
<path d="M15.06 19.39c-.62.42-1.4.77-2.35 1.08l-1.58.52c-3.97 1.28-6.06.21-7.35-3.76L2.5 13.28c-1.28-3.97-.22-6.07 3.75-7.35l1.58-.52c.41-.13.8-.24 1.17-.31-.3.61-.54 1.35-.74 2.2l-.98 4.19c-.98 4.18.31 6.24 4.48 7.23l1.68.4c.58.14 1.12.23 1.62.27Zm2.43-8.88c-.06 0-.12-.01-.19-.02l-4.85-1.23a.75.75 0 0 1 .37-1.45l4.85 1.23a.748.748 0 0 1-.18 1.47Z" fill="#228e6c"></path>
<path d="M14.56 13.89c-.06 0-.12-.01-.19-.02l-2.91-.74a.75.75 0 0 1 .37-1.45l2.91.74c.4.1.64.51.54.91-.08.34-.38.56-.72.56Z" fill="#228e6c"></path>
</svg>
<span class="title">Quick Reference</span></a><div class="menu"><a href="javascript:void(0);" class="searchbtn" id="searchbtn"><svg xmlns="http://www.w3.org/2000/svg" height="1em" width="1em" viewBox="0 0 18 18">
<path fill="currentColor" d="M17.71,16.29 L14.31,12.9 C15.4069846,11.5024547 16.0022094,9.77665502 16,8 C16,3.581722 12.418278,0 8,0 C3.581722,0 0,3.581722 0,8 C0,12.418278 3.581722,16 8,16 C9.77665502,16.0022094 11.5024547,15.4069846 12.9,14.31 L16.29,17.71 C16.4777666,17.8993127 16.7333625,18.0057983 17,18.0057983 C17.2666375,18.0057983 17.5222334,17.8993127 17.71,17.71 C17.8993127,17.5222334 18.0057983,17.2666375 18.0057983,17 C18.0057983,16.7333625 17.8993127,16.4777666 17.71,16.29 Z M2,8 C2,4.6862915 4.6862915,2 8,2 C11.3137085,2 14,4.6862915 14,8 C14,11.3137085 11.3137085,14 8,14 C4.6862915,14 2,11.3137085 2,8 Z"></path>
</svg><span>搜索</span><span>⌘K</span></a><a href="https://github.com/jaywcjlove/reference/blob/main/docs/minio.md" class="edit" target="__blank"><svg viewBox="0 0 36 36" fill="currentColor" height="1em" width="1em"><path d="m33 6.4-3.7-3.7a1.71 1.71 0 0 0-2.36 0L23.65 6H6a2 2 0 0 0-2 2v22a2 2 0 0 0 2 2h22a2 2 0 0 0 2-2V11.76l3-3a1.67 1.67 0 0 0 0-2.36ZM18.83 20.13l-4.19.93 1-4.15 9.55-9.57 3.23 3.23ZM29.5 9.43 26.27 6.2l1.85-1.85 3.23 3.23Z"></path><path fill="none" d="M0 0h36v36H0z"></path></svg><span>编辑</span></a><button id="darkMode" type="button"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" class="light" height="1em" width="1em">
<path d="M6.995 12c0 2.761 2.246 5.007 5.007 5.007s5.007-2.246 5.007-5.007-2.246-5.007-5.007-5.007S6.995 9.239 6.995 12zM11 19h2v3h-2zm0-17h2v3h-2zm-9 9h3v2H2zm17 0h3v2h-3zM5.637 19.778l-1.414-1.414 2.121-2.121 1.414 1.414zM16.242 6.344l2.122-2.122 1.414 1.414-2.122 2.122zM6.344 7.759 4.223 5.637l1.415-1.414 2.12 2.122zm13.434 10.605-1.414 1.414-2.122-2.122 1.414-1.414z"></path>
</svg>
<svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 24 24" class="dark" height="1em" width="1em">
<path d="M12 11.807A9.002 9.002 0 0 1 10.049 2a9.942 9.942 0 0 0-5.12 2.735c-3.905 3.905-3.905 10.237 0 14.142 3.906 3.906 10.237 3.905 14.143 0a9.946 9.946 0 0 0 2.735-5.119A9.003 9.003 0 0 1 12 11.807z"></path>
</svg>
</button><script src="../js/dark.js?v=1.11.1"></script><a href="https://github.com/jaywcjlove/reference" class="" target="__blank"><svg viewBox="0 0 16 16" fill="currentColor" height="1em" width="1em"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.012 8.012 0 0 0 16 8c0-4.42-3.58-8-8-8z"></path></svg></a></div></div></nav><div class="wrap h1body-exist max-container"><header class="wrap-header h1wrap"><h1 id="minio-备忘清单"><svg xmlns="http://www.w3.org/2000/svg" height="1em" viewBox="0 0 162.612 24.465" xmlns:v="https://vecta.io/nano">
<path d="M52.751.414h9.108v23.63h-9.108zM41.711.74l-18.488 9.92a.919.919 0 0 1-.856 0L3.879.74A2.808 2.808 0 0 0 2.558.414h-.023A2.4 2.4 0 0 0 0 2.641v21.376h9.1V13.842a.918.918 0 0 1 1.385-.682l10.361 5.568a3.634 3.634 0 0 0 3.336.028l10.933-5.634a.917.917 0 0 1 1.371.69v10.205h9.1V2.641A2.4 2.4 0 0 0 43.055.414h-.023a2.808 2.808 0 0 0-1.321.326zm65.564-.326h-9.237v10.755a.913.913 0 0 1-1.338.706L72.762.675a2.824 2.824 0 0 0-1.191-.261h-.016a2.4 2.4 0 0 0-2.535 2.227v21.377h9.163V13.275a.914.914 0 0 1 1.337-.707l24.032 11.2a2.813 2.813 0 0 0 1.188.26 2.4 2.4 0 0 0 2.535-2.227zm7.161 23.63V.414h4.191v23.63zm28.856.421c-11.274 0-19.272-4.7-19.272-12.232C124.02 4.741 132.066 0 143.292 0s19.32 4.7 19.32 12.233-7.902 12.232-19.32 12.232zm0-21.333c-8.383 0-14.84 3.217-14.84 9.1 0 5.926 6.457 9.1 14.84 9.1s14.887-3.174 14.887-9.1c0-5.883-6.504-9.1-14.887-9.1z" fill="#c72c48"></path>
</svg><a aria-hidden="true" tabindex="-1" href="#minio-备忘清单"><span class="icon icon-link"></span></a>MinIO 备忘清单</h1><div class="wrap-body">
<p>这是 MinIO 语法的快速参考备忘单</p>
</div></header><div class="menu-tocs"><div class="menu-btn"><svg aria-hidden="true" fill="currentColor" height="1em" width="1em" viewBox="0 0 16 16" version="1.1" data-view-component="true">
<path fill-rule="evenodd" d="M2 4a1 1 0 100-2 1 1 0 000 2zm3.75-1.5a.75.75 0 000 1.5h8.5a.75.75 0 000-1.5h-8.5zm0 5a.75.75 0 000 1.5h8.5a.75.75 0 000-1.5h-8.5zm0 5a.75.75 0 000 1.5h8.5a.75.75 0 000-1.5h-8.5zM3 8a1 1 0 11-2 0 1 1 0 012 0zm-1 6a1 1 0 100-2 1 1 0 000 2z"></path>
</svg></div><div class="menu-modal"><a aria-hidden="true" class="leve2 tocs-link" data-num="2" href="#minio-快速参考">MinIO 快速参考</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#基本概念">基本概念</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#安装minio">安装MinIO</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#启动minio服务">启动MinIO服务</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#访问minio">访问MinIO</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#minio-client-安装">minio client 安装</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#windows">windows</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#mac">mac</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#linux">linux</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#mc-连接服务操作">mc 连接服务操作</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#mc-桶操作">mc 桶操作</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#mc-文件操作">mc 文件操作</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#mc-文件夹操作">mc 文件夹操作</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#mc-其他操作">mc 其他操作</a><a aria-hidden="true" class="leve2 tocs-link" data-num="2" href="#admin-常用管理命令">Admin 常用管理命令</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#mc-admin-管理操作">mc admin 管理操作</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#常用全局参数mc-全局对-mc-admin-同样适用">常用全局参数mc 全局,对 mc admin 同样适用)</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#mc-admin-info节点集群信息">mc admin info节点/集群信息)</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#mc-admin-logs服务端日志">mc admin logs服务端日志</a><a aria-hidden="true" class="leve3 tocs-link" data-num="3" href="#mc-admin-accesskey访问密钥--service-account">mc admin accesskey访问密钥 / Service Account</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#create创建">create创建</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#edit编辑">edit编辑</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#info查看详情">info查看详情</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#ls列表">ls列表</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#enable--disable启用--禁用">enable / disable启用 / 禁用)</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#rm删除">rm删除</a><a aria-hidden="true" class="leve4 tocs-link" data-num="4" href="#sts-revoke撤销-sts-临时凭证">sts-revoke撤销 STS 临时凭证)</a><a aria-hidden="true" class="leve2 tocs-link" data-num="2" href="#另见">另见</a></div></div><div class="h1wrap-body"><div class="wrap h2body-exist"><div class="wrap-header h2wrap"><h2 id="minio-快速参考"><a aria-hidden="true" tabindex="-1" href="#minio-快速参考"><span class="icon icon-link"></span></a>MinIO 快速参考</h2><div class="wrap-body">
</div></div><div class="h2wrap-body"><div class="wrap h3body-not-exist"><div class="wrap-header h3wrap"><h3 id="基本概念"><a aria-hidden="true" tabindex="-1" href="#基本概念"><span class="icon icon-link"></span></a>基本概念</h3><div class="wrap-body">
<ul>
<li><strong>对象存储</strong>:存储非结构化数据,如图片、视频等。</li>
<li><strong>Bucket</strong>MinIO中存储对象的容器类似于文件夹。</li>
<li><strong>对象Object</strong>:桶中存储的具体数据。</li>
</ul>
</div></div></div><div class="wrap h3body-not-exist"><div class="wrap-header h3wrap"><h3 id="安装minio"><a aria-hidden="true" tabindex="-1" href="#安装minio"><span class="icon icon-link"></span></a>安装MinIO</h3><div class="wrap-body">
<ul>
<li><a href="https://min.io/download">MinIO官网</a>下载对应平台的MinIO服务器。</li>
<li>根据操作系统的指南进行安装。</li>
</ul>
</div></div></div><div class="wrap h3body-not-exist"><div class="wrap-header h3wrap"><h3 id="启动minio服务"><a aria-hidden="true" tabindex="-1" href="#启动minio服务"><span class="icon icon-link"></span></a>启动MinIO服务</h3><div class="wrap-body">
<ul>
<li>
<p>运行MinIO服务器通常使用以下命令</p>
<pre class="language-shell"><code class="language-shell code-highlight"><span class="code-line">minio server /export/data1 /export/data2 /export/data3 /export/data4
</span></code></pre>
</li>
<li>
<p>其中<code>/export/data1</code>等是存储数据的路径。</p>
</li>
</ul>
</div></div></div><div class="wrap h3body-not-exist"><div class="wrap-header h3wrap"><h3 id="访问minio"><a aria-hidden="true" tabindex="-1" href="#访问minio"><span class="icon icon-link"></span></a>访问MinIO</h3><div class="wrap-body">
<ul>
<li>使用Web界面访问MinIO通常是<code>http://127.0.0.1:9000</code></li>
<li>使用客户端工具,如<code>mc</code>命令行工具。</li>
</ul>
</div></div></div><div class="wrap h3body-exist row-span-2 col-span-2"><div class="wrap-header h3wrap"><h3 id="minio-client-安装"><a aria-hidden="true" tabindex="-1" href="#minio-client-安装"><span class="icon icon-link"></span></a>minio client 安装</h3><div class="wrap-body">
<!--rehype:wrap-class=row-span-2 col-span-2-->
<h4 id="windows"><a aria-hidden="true" tabindex="-1" href="#windows"><span class="icon icon-link"></span></a>windows</h4>
<p>下载</p>
<pre class="language-bash"><code class="language-bash code-highlight"><span class="code-line">https://dl.min.io/client/mc/release/windows-amd64/mc.exe
</span><span class="code-line"><span class="token punctuation">\</span>path<span class="token punctuation">\</span>to<span class="token punctuation">\</span>mc.exe <span class="token parameter variable">--help</span>
</span></code></pre>
<h4 id="mac"><a aria-hidden="true" tabindex="-1" href="#mac"><span class="icon icon-link"></span></a>mac</h4>
<p>安装</p>
<pre class="language-bash"><code class="language-bash code-highlight"><span class="code-line">brew <span class="token function">install</span> minio/stable/mc
</span><span class="code-line"><span class="token function">mc</span> <span class="token parameter variable">--help</span>
</span></code></pre>
<h4 id="linux"><a aria-hidden="true" tabindex="-1" href="#linux"><span class="icon icon-link"></span></a>linux</h4>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">curl</span> https://dl.min.io/client/mc/release/linux-amd64/mc <span class="token punctuation">\</span>
</span><span class="code-line">--create-dirs <span class="token punctuation">\</span>
</span><span class="code-line"><span class="token parameter variable">-o</span> <span class="token environment constant">$HOME</span>/minio-binaries/mc
</span><span class="code-line">
</span><span class="code-line"><span class="token function">chmod</span> +x <span class="token environment constant">$HOME</span>/minio-binaries/mc
</span><span class="code-line"><span class="token builtin class-name">export</span> <span class="token assign-left variable"><span class="token environment constant">PATH</span></span><span class="token operator">=</span><span class="token environment constant">$PATH</span><span class="token builtin class-name">:</span><span class="token environment constant">$HOME</span>/minio-binaries/
</span></code></pre>
<p>版本比较多,请去官网查找安装步骤</p>
</div></div></div><div class="wrap h3body-not-exist"><div class="wrap-header h3wrap"><h3 id="mc-连接服务操作"><a aria-hidden="true" tabindex="-1" href="#mc-连接服务操作"><span class="icon icon-link"></span></a>mc 连接服务操作</h3><div class="wrap-body">
<p>列出所有别名</p>
<pre class="language-bash"><code class="language-bash code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token builtin class-name">alias</span> list
</span></code></pre>
<p>添加服务别名</p>
<pre class="language-bash"><code class="language-bash code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token builtin class-name">alias</span> <span class="token builtin class-name">set</span> myminio https://myminio.example.net minioadminuser minioadminpassword
</span></code></pre>
<p>删除服务别名</p>
<pre class="language-bash"><code class="language-bash code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token builtin class-name">alias</span> <span class="token function">rm</span> myminio
</span></code></pre>
</div></div></div><div class="wrap h3body-not-exist"><div class="wrap-header h3wrap"><h3 id="mc-桶操作"><a aria-hidden="true" tabindex="-1" href="#mc-桶操作"><span class="icon icon-link"></span></a>mc 桶操作</h3><div class="wrap-body">
<p>创建桶</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> mb myminio/mybucket
</span></code></pre>
<p>删除桶</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> rb myminio/mybucket
</span></code></pre>
<p>设置桶策略</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> policy <span class="token builtin class-name">set</span> download myminio/mybucket
</span></code></pre>
<p>设置桶生命周期</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> ilm <span class="token function">import</span> myminio/mybucket
</span></code></pre>
</div></div></div><div class="wrap h3body-not-exist row-span-2"><div class="wrap-header h3wrap"><h3 id="mc-文件操作"><a aria-hidden="true" tabindex="-1" href="#mc-文件操作"><span class="icon icon-link"></span></a>mc 文件操作</h3><div class="wrap-body">
<!--rehype:wrap-class=row-span-2-->
<p>列出文件</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">ls</span> myminio/mybucket
</span></code></pre>
<p>上传文件</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">cp</span> /path/to/file myminio/mybucket/file
</span></code></pre>
<p>下载文件</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">cp</span> myminio/mybucket/file /path/to/destination
</span></code></pre>
<p>删除文件</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">rm</span> myminio/mybucket/file
</span></code></pre>
<p>移动文件</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">mv</span> myminio/mybucket/file myminio/mybucket/newfile
</span></code></pre>
<p>拷贝文件</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">cp</span> myminio/mybucket/file myminio/mybucket/newfile
</span></code></pre>
<p>查找文件</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">find</span> myminio/mydata <span class="token parameter variable">--name</span> <span class="token string">"*.jpg"</span>
</span></code></pre>
</div></div></div><div class="wrap h3body-not-exist row-span-2"><div class="wrap-header h3wrap"><h3 id="mc-文件夹操作"><a aria-hidden="true" tabindex="-1" href="#mc-文件夹操作"><span class="icon icon-link"></span></a>mc 文件夹操作</h3><div class="wrap-body">
<!--rehype:wrap-class=row-span-2-->
<p>列出文件夹</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">ls</span> myminio/mybucket/folder
</span></code></pre>
<p>创建文件夹</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> mb myminio/mybucket/folder
</span></code></pre>
<p>删除文件夹</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> rb myminio/mybucket/folder
</span></code></pre>
<p>移动文件夹</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">mv</span> <span class="token parameter variable">-r</span> myminio/mybucket/folder myminio/mybucket/newfolder
</span></code></pre>
<p>拷贝文件夹</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">cp</span> <span class="token parameter variable">-r</span> myminio/mybucket/folder myminio/mybucket/newfolder
</span></code></pre>
<p>删除文件夹中的所有文件</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">rm</span> <span class="token parameter variable">--recursive</span> myminio/mybucket/folder
</span></code></pre>
<p>列出文件夹中的所有文件</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">ls</span> <span class="token parameter variable">--recursive</span> myminio/mybucket/folder
</span></code></pre>
<p>列出文件夹中的所有文件,包括子文件夹</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">ls</span> <span class="token parameter variable">--recursive</span> --include-folders myminio/mybucket/folder
</span></code></pre>
</div></div></div><div class="wrap h3body-not-exist"><div class="wrap-header h3wrap"><h3 id="mc-其他操作"><a aria-hidden="true" tabindex="-1" href="#mc-其他操作"><span class="icon icon-link"></span></a>mc 其他操作</h3><div class="wrap-body">
<p>列出所有桶</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token function">ls</span> myminio
</span></code></pre>
<p>显示帮助信息</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> <span class="token builtin class-name">help</span>
</span></code></pre>
<p>版本信息</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> version
</span></code></pre>
</div></div></div></div></div><div class="wrap h2body-exist"><div class="wrap-header h2wrap"><h2 id="admin-常用管理命令"><a aria-hidden="true" tabindex="-1" href="#admin-常用管理命令"><span class="icon icon-link"></span></a>Admin 常用管理命令</h2><div class="wrap-body">
</div></div><div class="h2wrap-body"><div class="wrap h3body-exist col-span-3"><div class="wrap-header h3wrap"><h3 id="mc-admin-管理操作"><a aria-hidden="true" tabindex="-1" href="#mc-admin-管理操作"><span class="icon icon-link"></span></a>mc admin 管理操作</h3><div class="wrap-body">
<!--rehype:wrap-class=col-span-3-->
<p><code>mc admin</code> 用于管理 MinIO 服务端(需要具备相应管理权限的账号/策略)。</p>
<h4 id="常用全局参数mc-全局对-mc-admin-同样适用"><a aria-hidden="true" tabindex="-1" href="#常用全局参数mc-全局对-mc-admin-同样适用"><span class="icon icon-link"></span></a>常用全局参数(<code>mc</code> 全局,对 <code>mc admin</code> 同样适用)</h4>
<table class="show-header left-align"><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td><code>--json</code></td><td>输出 JSON便于脚本解析与自动化处理</td></tr><tr><td><code>--debug</code></td><td>打印调试信息(排查权限/网络/签名等问题)</td></tr><tr><td><code>--insecure</code></td><td>跳过 TLS 证书校验(自签名证书/测试环境常用)</td></tr><tr><td><code>-C, --config-dir &#x3C;DIR></code></td><td>指定 <code>mc</code> 配置目录(多环境隔离)</td></tr><tr><td><code>-q, --quiet</code></td><td>静默模式,减少非必要输出</td></tr><tr><td><code>--no-color</code></td><td>禁用彩色输出CI/日志更友好)</td></tr><tr><td><code>--dp, --disable-pager</code></td><td>禁用分页器(管道/重定向场景更稳定)</td></tr><tr><td><code>-H, --custom-header '&#x3C;key>:&#x3C;value>'</code></td><td>追加自定义 HTTP Header</td></tr></tbody></table>
<!--rehype:className=show-header left-align-->
</div></div></div><div class="wrap h3body-not-exist"><div class="wrap-header h3wrap"><h3 id="mc-admin-info节点集群信息"><a aria-hidden="true" tabindex="-1" href="#mc-admin-info节点集群信息"><span class="icon icon-link"></span></a>mc admin info节点/集群信息)</h3><div class="wrap-body">
<p>查看 MinIO 服务信息(集群/节点/版本等)。</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin info <span class="token punctuation">[</span>--offline<span class="token punctuation">]</span> TARGET
</span></code></pre>
<p>常用参数:</p>
<table class="show-header left-align"><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td><code>--offline</code></td><td>允许在部分节点离线的情况下返回可用信息(排障场景常用)</td></tr></tbody></table>
<!--rehype:className=show-header left-align-->
<p>示例:</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin info myminio
</span><span class="code-line"><span class="token function">mc</span> admin info <span class="token parameter variable">--offline</span> myminio
</span><span class="code-line"><span class="token function">mc</span> admin info <span class="token parameter variable">--json</span> myminio
</span></code></pre>
</div></div></div><div class="wrap h3body-not-exist col-span-2"><div class="wrap-header h3wrap"><h3 id="mc-admin-logs服务端日志"><a aria-hidden="true" tabindex="-1" href="#mc-admin-logs服务端日志"><span class="icon icon-link"></span></a>mc admin logs服务端日志</h3><div class="wrap-body">
<!--rehype:wrap-class=col-span-2-->
<p>按需拉取服务端日志输出(可指定节点)。</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin logs <span class="token punctuation">[</span>--last <span class="token operator">&#x3C;</span>N<span class="token operator">></span><span class="token punctuation">]</span> <span class="token punctuation">[</span>--type <span class="token operator">&#x3C;</span>TYPE<span class="token operator">></span><span class="token punctuation">]</span> TARGET <span class="token punctuation">[</span>NODE<span class="token punctuation">]</span>
</span></code></pre>
<p>常用参数:</p>
<table class="show-header left-align"><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td><code>-l, --last &#x3C;N></code></td><td>返回最近 N 条日志</td></tr><tr><td><code>-t, --type &#x3C;TYPE></code></td><td>指定服务类型(常见:<code>minio</code></td></tr></tbody></table>
<!--rehype:className=show-header left-align-->
<p>示例:</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin logs myminio
</span><span class="code-line"><span class="token function">mc</span> admin logs <span class="token parameter variable">--last</span> <span class="token number">100</span> myminio
</span><span class="code-line"><span class="token function">mc</span> admin logs <span class="token parameter variable">--type</span> minio myminio
</span><span class="code-line"><span class="token function">mc</span> admin logs <span class="token parameter variable">--json</span> <span class="token parameter variable">--last</span> <span class="token number">200</span> myminio
</span><span class="code-line"><span class="token function">mc</span> admin logs myminio http://minio-node-1:9000
</span></code></pre>
</div></div></div><div class="wrap h3body-exist col-span-3 row-span-2"><div class="wrap-header h3wrap"><h3 id="mc-admin-accesskey访问密钥--service-account"><a aria-hidden="true" tabindex="-1" href="#mc-admin-accesskey访问密钥--service-account"><span class="icon icon-link"></span></a>mc admin accesskey访问密钥 / Service Account</h3><div class="wrap-body">
<!--rehype:wrap-class=col-span-3 row-span-2-->
<p>用于创建与管理用户的访问密钥(常用于给应用/CI 生成可控权限的 Service Account</p>
<blockquote>
<p>注:从 <code>mc</code> <strong>2024-10-08</strong> 起开始提供 <code>mc admin accesskey</code>(旧版本可能使用 <code>mc admin user svcacct</code> 等命令族)。</p>
</blockquote>
<h4 id="create创建"><a aria-hidden="true" tabindex="-1" href="#create创建"><span class="icon icon-link"></span></a>create创建</h4>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token comment"># 用户名可忽略,默认为当前用户</span>
</span><span class="code-line"><span class="token function">mc</span> admin accesskey create <span class="token punctuation">[</span>FLAGS<span class="token punctuation">]</span> TARGET <span class="token punctuation">[</span>USERNAME<span class="token punctuation">]</span>
</span></code></pre>
<p>常用参数:</p>
<table class="show-header left-align"><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td><code>--access-key &#x3C;ACCESSKEY></code></td><td>指定 Access Key不指定则自动生成</td></tr><tr><td><code>--secret-key &#x3C;SECRETKEY></code></td><td>指定 Secret Key不指定则自动生成</td></tr><tr><td><code>--comment &#x3C;TEXT></code></td><td>为该密钥添加备注</td></tr><tr><td><code>--expiry &#x3C;DURATION></code></td><td>设置过期时间/有效期(不指定则为永久有效)</td></tr><tr><td><code>--policy &#x3C;JSON></code></td><td>直接传入策略 JSON为该密钥绑定权限</td></tr><tr><td><code>--policy-file &#x3C;FILE></code></td><td>从文件加载策略 JSON</td></tr><tr><td><code>--description &#x3C;TEXT></code></td><td>描述信息</td></tr></tbody></table>
<!--rehype:className=show-header left-align-->
<p>示例:</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey create myminio
</span><span class="code-line"><span class="token function">mc</span> admin accesskey create <span class="token parameter variable">--comment</span> <span class="token string">"ci"</span> --policy-file ./readonly.json myminio appuser
</span><span class="code-line"><span class="token function">mc</span> admin accesskey create --access-key <span class="token string">"<span class="token variable">$AK</span>"</span> --secret-key <span class="token string">"<span class="token variable">$SK</span>"</span> <span class="token parameter variable">--expiry</span> 168h myminio appuser
</span></code></pre>
<h4 id="edit编辑"><a aria-hidden="true" tabindex="-1" href="#edit编辑"><span class="icon icon-link"></span></a>edit编辑</h4>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey edit <span class="token punctuation">[</span>FLAGS<span class="token punctuation">]</span> TARGET ACCESSKEY
</span></code></pre>
<p>常用参数:</p>
<table class="show-header left-align"><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td><code>--comment &#x3C;TEXT></code></td><td>更新备注</td></tr><tr><td><code>--expiry &#x3C;DURATION></code></td><td>更新过期时间/有效期</td></tr><tr><td><code>--policy &#x3C;JSON></code></td><td>更新策略 JSON</td></tr><tr><td><code>--policy-file &#x3C;FILE></code></td><td>从文件更新策略 JSON</td></tr><tr><td><code>--description &#x3C;TEXT></code></td><td>更新描述信息</td></tr></tbody></table>
<!--rehype:className=show-header left-align-->
<p>示例:</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey edit <span class="token parameter variable">--comment</span> <span class="token string">"rotate-2026-01"</span> myminio <span class="token string">"<span class="token variable">$AK</span>"</span>
</span><span class="code-line"><span class="token function">mc</span> admin accesskey edit --policy-file ./writeonly.json myminio <span class="token string">"<span class="token variable">$AK</span>"</span>
</span></code></pre>
<h4 id="info查看详情"><a aria-hidden="true" tabindex="-1" href="#info查看详情"><span class="icon icon-link"></span></a>info查看详情</h4>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey info TARGET ACCESSKEY
</span></code></pre>
<p>示例:</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey info myminio <span class="token string">"<span class="token variable">$AK</span>"</span>
</span><span class="code-line"><span class="token function">mc</span> admin accesskey info <span class="token parameter variable">--json</span> myminio <span class="token string">"<span class="token variable">$AK</span>"</span>
</span></code></pre>
<h4 id="ls列表"><a aria-hidden="true" tabindex="-1" href="#ls列表"><span class="icon icon-link"></span></a>ls列表</h4>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey <span class="token function">ls</span> <span class="token punctuation">[</span>FLAGS<span class="token punctuation">]</span> TARGET <span class="token punctuation">[</span>USERNAME<span class="token punctuation">]</span>
</span></code></pre>
<p>常用参数:</p>
<table class="show-header left-align"><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td><code>--all</code></td><td>列出所有用户(含临时用户)</td></tr><tr><td><code>--self</code></td><td>仅列出当前用户</td></tr><tr><td><code>--svcacc-only</code></td><td>仅列出临时 STS Key</td></tr><tr><td><code>--temp-only</code></td><td>仅列出有 Access Key 的用户(只返回存在关联密钥的用户)</td></tr><tr><td><code>--users-only</code></td><td>仅列出用户(不含临时 Key</td></tr></tbody></table>
<!--rehype:className=show-header left-align-->
<p>示例:</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey <span class="token function">ls</span> myminio
</span><span class="code-line"><span class="token function">mc</span> admin accesskey <span class="token function">ls</span> myminio appuser
</span><span class="code-line"><span class="token function">mc</span> admin accesskey <span class="token function">ls</span> --users-only myminio
</span><span class="code-line"><span class="token function">mc</span> admin accesskey <span class="token function">ls</span> --svcacc-only myminio
</span></code></pre>
<h4 id="enable--disable启用--禁用"><a aria-hidden="true" tabindex="-1" href="#enable--disable启用--禁用"><span class="icon icon-link"></span></a>enable / disable启用 / 禁用)</h4>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey <span class="token builtin class-name">enable</span> TARGET ACCESSKEY
</span><span class="code-line"><span class="token function">mc</span> admin accesskey disable TARGET ACCESSKEY
</span></code></pre>
<p>示例:</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey disable myminio <span class="token string">"<span class="token variable">$AK</span>"</span>
</span><span class="code-line"><span class="token function">mc</span> admin accesskey <span class="token builtin class-name">enable</span> myminio <span class="token string">"<span class="token variable">$AK</span>"</span>
</span></code></pre>
<p><code>$AK</code> 替换为你的AccessKey</p>
<h4 id="rm删除"><a aria-hidden="true" tabindex="-1" href="#rm删除"><span class="icon icon-link"></span></a>rm删除</h4>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey <span class="token function">rm</span> TARGET ACCESSKEY
</span></code></pre>
<p>示例:</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey <span class="token function">rm</span> myminio <span class="token string">"<span class="token variable">$AK</span>"</span>
</span></code></pre>
<h4 id="sts-revoke撤销-sts-临时凭证"><a aria-hidden="true" tabindex="-1" href="#sts-revoke撤销-sts-临时凭证"><span class="icon icon-link"></span></a>sts-revoke撤销 STS 临时凭证)</h4>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey sts-revoke <span class="token punctuation">[</span>FLAGS<span class="token punctuation">]</span> TARGET <span class="token punctuation">[</span>STS-KEY <span class="token punctuation">..</span>.<span class="token punctuation">]</span>
</span></code></pre>
<p>常用参数:</p>
<table class="show-header left-align"><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td><code>--all</code></td><td>撤销全部 STS Key</td></tr><tr><td><code>--self</code></td><td>撤销当前用户的 STS Key</td></tr><tr><td><code>--token-type &#x3C;TYPE></code></td><td>仅撤销指定类型的 Token例如 <code>web</code><code>api</code></td></tr></tbody></table>
<!--rehype:className=show-header left-align-->
<p>示例:</p>
<pre class="language-sh"><code class="language-sh code-highlight"><span class="code-line"><span class="token function">mc</span> admin accesskey sts-revoke <span class="token parameter variable">--self</span> myminio
</span><span class="code-line"><span class="token function">mc</span> admin accesskey sts-revoke <span class="token parameter variable">--all</span> myminio
</span><span class="code-line"><span class="token function">mc</span> admin accesskey sts-revoke --token-type web myminio
</span><span class="code-line"><span class="token function">mc</span> admin accesskey sts-revoke myminio <span class="token string">"<span class="token variable">$STS_KEY</span>"</span>
</span></code></pre>
</div></div></div></div></div><div class="wrap h2body-not-exist"><div class="wrap-header h2wrap"><h2 id="另见"><a aria-hidden="true" tabindex="-1" href="#另见"><span class="icon icon-link"></span></a>另见</h2><div class="wrap-body">
<ul>
<li><a href="https://min.io/docs/minio/kubernetes/upstream/">MinIO官方文档</a> <em>(min.io)</em></li>
<li><a href="https://github.com/minio/minio">MinIO github 源码</a> <em>(github.com)</em></li>
</ul>
</div></div><div class="h2wrap-body"></div></div></div><script src="https://giscus.app/client.js" data-repo="jaywcjlove/reference" data-repo-id="R_kgDOID2-Mw" data-category="Q&#x26;A" data-category-id="DIC_kwDOID2-M84CS5wo" data-mapping="pathname" data-strict="0" data-reactions-enabled="1" data-emit-metadata="0" data-input-position="bottom" data-theme="dark" data-lang="zh-CN" crossorigin="anonymous" async></script><div class="giscus"></div></div><footer class="footer-wrap"><footer class="max-container">© 2022 <a href="https://wangchujiang.com/#/app" target="_blank">Kenny Wang</a>.</footer></footer><script async src="https://www.googletagmanager.com/gtag/js?id=G-9MWEWXSDQK"></script><script>window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-9MWEWXSDQK');</script><script src="../data.js?v=1.11.1" defer></script><script src="../js/fuse.min.js?v=1.11.1" defer></script><script src="../js/main.js?v=1.11.1" defer></script><div id="mysearch"><div class="mysearch-box"><div class="mysearch-input"><div><svg xmlns="http://www.w3.org/2000/svg" height="1em" width="1em" viewBox="0 0 18 18">
<path fill="currentColor" d="M17.71,16.29 L14.31,12.9 C15.4069846,11.5024547 16.0022094,9.77665502 16,8 C16,3.581722 12.418278,0 8,0 C3.581722,0 0,3.581722 0,8 C0,12.418278 3.581722,16 8,16 C9.77665502,16.0022094 11.5024547,15.4069846 12.9,14.31 L16.29,17.71 C16.4777666,17.8993127 16.7333625,18.0057983 17,18.0057983 C17.2666375,18.0057983 17.5222334,17.8993127 17.71,17.71 C17.8993127,17.5222334 18.0057983,17.2666375 18.0057983,17 C18.0057983,16.7333625 17.8993127,16.4777666 17.71,16.29 Z M2,8 C2,4.6862915 4.6862915,2 8,2 C11.3137085,2 14,4.6862915 14,8 C14,11.3137085 11.3137085,14 8,14 C4.6862915,14 2,11.3137085 2,8 Z"></path>
</svg><input id="mysearch-input" type="search" placeholder="搜索" autocomplete="off"><div class="mysearch-clear"></div></div><button id="mysearch-close" type="button">搜索</button></div><div class="mysearch-result"><div id="mysearch-menu"></div><div id="mysearch-content"></div></div></div></div></body>
</html>