minio/minio
多云对象存储是一种能跨多个云服务提供商（如AWS、Azure、Google Cloud等）统一管理数据的解决方案，以对象形式（含数据、元数据及唯一标识符）存储大量非结构化数据，具备灵活的数据分发、跨云容灾备份能力，可按需弹性扩展存储资源，有效避免单一云厂商锁定，提升数据管理效率与安全性。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
MinIO 快速入门指南
简介
MinIO 是一款高性能对象存储，基于 GNU Affero 通用公共许可证 v3.0 发布，兼容 Amazon S3 云存储服务 API。适用于构建机器学习、数据分析及应用数据负载的高性能基础设施。
安装指南
说明
以下安装步骤均为独立模式（Standalone），适合早期开发和评估。版本控制、对象锁定、桶复制等功能需通过纠删码分布式部署实现。生产环境或扩展开发建议启用纠删码，需至少 4 块硬盘/节点，详见 [MinIO 纠删码快速入门] 。
容器安装（推荐）
使用以下命令运行独立 MinIO 容器（需 podman）：
shpodman run -p 9000:9000 -p 9001:9001 \ quay.io/minio/minio server /data --console-address ":9001"
- 默认凭据：
minioadmin:minioadmin - 访问 Console：浏览器访问 `[]
- 持久化存储：通过
-v参数映射主机目录至容器，例如-v /mnt/data:/data将主机/mnt/data映射为容器数据目录。 - 客户端工具：支持 S3 兼容工具（如 MinIO Client
mc），详见 使用mc测试连接。
macOS 安装
Homebrew（推荐）
-
安装 MinIO：
CODE_TOKEN_1若之前通过
brew install minio安装，需先卸载重装：
CODE_TOKEN_2 -
启动服务（替换
/data为实际存储路径）：
CODE_TOKEN_3
二进制下载
-
下载并授权：
CODE_TOKEN_4 -
启动服务（替换
/data为实际存储路径）：
CODE_TOKEN_5
GNU/Linux 安装
根据架构下载对应二进制文件，替换 /data 为存储路径：
64位 Intel/AMD（默认）
CODE_TOKEN_6
其他架构
| 架构 | 下载链接 |
|---|---|
| 64位 ARM | <[]> |
| 64位 PowerPC LE (ppc64le) | <[]> |
| IBM Z-Series (s390x) | <[]> |
Microsoft Windows 安装
-
下载可执行文件：
[[]] -
启动服务（替换
D:\为存储路径，需在minio.exe目录执行或添加至系统PATH）：
CODE_TOKEN_7
源码安装（仅开发者）
需 Go 1.17+ 环境，适合开发测试，不建议生产使用：
CODE_TOKEN_8
部署建议
防火墙端口开放
MinIO 默认使用 9000 端口，需确保防火墙允许该端口访问：
ufw（Debian 系）
CODE_TOKEN_9
firewall-cmd（CentOS）
CODE_TOKEN_10
iptables（RHEL/CentOS）
CODE_TOKEN_11
测试连接
通过 MinIO Console 测试
- 访问地址：`[]
- 默认凭据：
minioadmin:minioadmin - 功能：创建桶、上传文件、浏览存储内容。
自定义 Console 端口：启动时添加
--console-address ":端口号"（如--console-address ":9001"）。
反向代理场景：设置MINIO_BROWSER_REDIRECT_URL环境变量指定外部访问地址（如[] 测试使用 MinIO Clientmcmc是 MinIO 命令行工具，支持文件系统和 S3 兼容存储操作（如ls、cp、mirror`）。详见 [MinIO Client 快速入门] 。
升级 MinIO
MinIO 升级支持零停机，建议所有节点同时升级。
不同部署方式的升级步骤
手动安装（二进制）
CODE_TOKEN_12
离线环境（无外网）
- 从 [[]] 下载对应版本二进制文件；
- 替换现有二进制（如
/opt/bin/minio），赋予执行权限：
CODE_TOKEN_13 - 重启服务：
CODE_TOKEN_14
Systemd 服务（RPM/DEB 包）
- 并行升级所有节点的 RPM/DEB 包；或替换二进制后重启服务：
CODE_TOKEN_15
升级检查清单
- 先在测试环境（DEV/QA/UAT）验证升级；
- 升级前阅读 [Release Notes] ；
mc admin update需 MinIO 进程对二进制目录有写权限；- 容器环境需通过更新镜像升级，不支持
mc admin update； - 禁止逐个节点升级，需所有节点同时升级。
进一步探索
- [MinIO 纠删码快速入门]
- [使用
aws-cli访问 MinIO] - [使用
s3cmd访问 MinIO] - [MinIO SDKs] （支持多语言）
- [MinIO 文档中心]
贡献与许可证
- 贡献指南：参见 [MinIO Contributor's Guide] 。
- 许可证：
- 源码：GNU AGPLv3（详见 [LICENSE] ）。
- 文档：CC BY 4.0（详见 [文档许可证] ）。
- 合规性：参见 [License Compliance] 。
更多相关 Docker 镜像与资源
以下是 minio/minio 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- bitnami/minio Docker 镜像说明（MinIO 对象存储，Bitnami 企业级配置，适合云原生存储）
- bitnamicharts/minio Docker 镜像说明（MinIO 对象存储服务，Bitnami Charts 版本）
- bitnamilegacy/minio Docker 镜像说明（Bitnami Legacy 打包的 MinIO 对象存储，适合兼容既有 Bitnami 目录与运维习惯的存量环境）
- rook/minio Docker 镜像说明（Rook 编排场景下的 MinIO 对象存储，适合 Kubernetes 上的 S3 兼容存储）
- alpine/minio Docker 镜像说明（基于 Alpine 的轻量 MinIO 镜像，适合边缘或小 footprint 对象存储）
minio/minio 国内 Docker 镜像拉取说明
在国内网络环境下，直接使用 docker pull 访问 Docker Hub 官方仓库时，较常遇到连接超时、TLS 握手失败或 registry 响应缓慢等情况。这类问题多与跨境链路质量、运营商策略及客户端 DNS 解析有关，并非单个镜像本身异常。
轩辕镜像提供两种常用加速方式：一是使用公共加速域名 docker.xuanyuan.run 拉取（可参考 登录认证方式）；二是在控制台配置 专属域名拉取，将拉取命令中的 registry 前缀替换为分配的专属域名，通常能提升成功率与稳定性。
以 minio/minio 为例，加速拉取命令格式为 docker pull docker.xuanyuan.run/minio/minio:<标签>，请将 <标签> 替换为具体版本。下方「镜像拉取方式」区块提供与本文一致的命令示例，可直接复制使用。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"