minio/minio

MinIO 快速入门指南

简介

MinIO 是一款高性能对象存储，基于 GNU Affero 通用公共许可证 v3.0 发布，兼容 Amazon S3 云存储服务 API。适用于构建机器学习、数据分析及应用数据负载的高性能基础设施。

安装指南

说明

以下安装步骤均为独立模式（Standalone），适合早期开发和评估。版本控制、对象锁定、桶复制等功能需通过纠删码分布式部署实现。生产环境或扩展开发建议启用纠删码，需至少 4 块硬盘/节点，详见 MinIO 纠删码快速入门。

容器安装（推荐）

使用以下命令运行独立 MinIO 容器（需 podman）：

sh
podman 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（推荐）

1. 安装 MinIO：
   CODE_TOKEN_1

   若之前通过 brew install minio 安装，需先卸载重装：
   CODE_TOKEN_2

2. 启动服务（替换 /data 为实际存储路径）：
   CODE_TOKEN_3

二进制下载

1. 下载并授权：
   CODE_TOKEN_4

2. 启动服务（替换 /data 为实际存储路径）：
   CODE_TOKEN_5

GNU/Linux 安装

根据架构下载对应二进制文件，替换 /data 为存储路径：

64位 Intel/AMD（默认）

CODE_TOKEN_6

其他架构

Microsoft Windows 安装

1. 下载可执行文件：
   [***]

2. 启动服务（替换 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 Client mc mc是 MinIO 命令行工具，支持文件系统和 S3 兼容存储操作（如ls、cp、mirror`）。详见 MinIO Client 快速入门。

升级 MinIO

MinIO 升级支持零停机，建议所有节点同时升级。

不同部署方式的升级步骤

手动安装（二进制）

CODE_TOKEN_12

离线环境（无外网）

1. 从 [***] 下载对应版本二进制文件；
2. 替换现有二进制（如 /opt/bin/minio），赋予执行权限：
   CODE_TOKEN_13
3. 重启服务：
   CODE_TOKEN_14

Systemd 服务（RPM/DEB 包）

• 并行升级所有节点的 RPM/DEB 包；或替换二进制后重启服务：
  CODE_TOKEN_15

升级检查清单

1. 先在测试环境（DEV/QA/UAT）验证升级；
2. 升级前阅读 Release Notes；
3. mc admin update 需 MinIO 进程对二进制目录有写权限；
4. 容器环境需通过更新镜像升级，不支持 mc admin update；
5. 禁止逐个节点升级，需所有节点同时升级。

进一步探索

• MinIO 纠删码快速入门
• 使用 aws-cli 访问 MinIO
• 使用 s3cmd 访问 MinIO
• MinIO SDKs（支持多语言）
• MinIO 文档中心

贡献与许可证

• 贡献指南：参见 MinIO Contributor's Guide。
• 许可证：
  • 源码：GNU AGPLv3（详见 LICENSE）。
  • 文档：CC BY 4.0（详见 文档许可证）。
  • 合规性：参见 License Compliance。