mc admin update
描述
mc admin update 命令会调用 MinIO 兼容的服务端原地更新 API。客户端可传入可选的发布镜像 URL,由服务端把选定的二进制分发到所有节点。
运行该命令后,会显示确认更新的提示。 输入 y 并按 [ENTER],即可确认并继续更新。
用户 必须 对二进制安装目标位置具有 write 权限。
不要在 Silo 上使用默认更新路径
截至 2026-08-05,最新公开 Silo 服务端 RELEASE.2026-08-04T00-00-00Z 在省略 MIRROR_URL 时仍会解析到上游 dl.min.io 发布源,并保留上游 MinIO 签名密钥。对已启用更新的 Silo 服务端运行 mc admin update ALIAS,因此可能会把 Silo 替换成上游 MinIO 二进制。
请在 Silo 服务端设置 MINIO_UPDATE=off,并通过下载与安装、可信软件仓库或手工校验的 Silo 制品升级。本页保留命令契约是为了兼容,并不表示这是推荐的 Silo 升级流程。
仅在 Silo 或兼容的 MinIO 部署上使用 mc admin
mc admin 使用 MinIO 专用管理 API。仅仅兼容通用 S3 API,并不意味着其他对象存储支持这些命令。
注意事项
协调重启
mc admin update 会更新二进制并同时重启部署中的所有服务器。应用应预期短暂不可用,并重试失败或中断的请求;对象操作的原子性并不能让全量集群重启对应用不可见。
请使用协调一致的升级与重启流程。除非发布说明明确声明支持混合版本,否则不要逐节点滚动替换二进制。
权限
执行该命令的用户 必须 对 MinIO 服务端二进制安装目标路径具有 write 权限。
示例
下面的继承形式仅用于说明命令契约。不要对 Silo 执行它,因为省略 MIRROR_URL 会选择上游 MinIO 更新源:
运行该命令后,在提示中输入 yes 以确认并执行更新。
语法
mc admin update 语法如下:
mc admin update 支持以下参数:
ALIAS
mc-cmd
要更新的 MinIO 部署的 alias。
如果指定的 ALIAS 对应的是分布式 MinIO 部署,mc admin update 会同时更新该部署中的 所有 MinIO 服务器。
使用 mc alias list 查看已配置的别名及其对应的 MinIO 部署端点。
MIRROR_URL
mc-cmd
目标服务端用于定位 minio 二进制的发布清单 URL。仅仅提供 URL 并不能使制品自动可信;使用这条兼容路径前必须核验完整的更新与签名契约。Silo 运维应优先使用文档化的软件包或手工升级流程。
--yes, -y
mc-cmd
Optional
传入此标志以确认更新,并跳过确认提示。
行为
二进制压缩
变更: RELEASE.2024-01-28T22-35-53Z
mc admin update 会先压缩二进制,再发送到部署中的所有节点。
此功能不适用于 systemctl managed deployments。