julialongtin/minio

MinIO 镜像文档

镜像概述

MinIO 是一个基于对象存储的开源服务，兼容 Amazon S3 API，提供高性能、可扩展的存储解决方案。minio/minio 镜像通过清单列表（manifest list）构建，支持多架构部署，可在不同硬件架构（如x86_64、ARM等）上运行，适用于构建私有云存储、数据备份和分布式存储系统。

核心功能与特性

• S3 API 兼容：完全兼容 Amazon S3 API，可无缝集成现有S3生态系统工具和应用
• 多架构支持：通过清单列表实现跨架构部署，支持x86_64、ARM等多种硬件架构
• 高性能：优化的存储引擎，支持高吞吐量和低延迟数据访问
• 可扩展性：支持单节点模式和分布式集群模式，轻松扩展存储容量和性能
• 数据安全：支持服务器端加密、访问控制列表（ACL）和签名URL等安全特性
• 轻量级：精简的镜像设计，资源占用低，部署便捷

使用场景与适用范围

• 私有云存储：搭建企业内部私有对象存储服务，管理非结构化数据（如文档、图片、视频等）
• 数据备份与归档：作为可靠的备份目标，存储备份数据并支持版本控制
• 开发与测试环境：快速部署S3兼容的存储服务，用于应用开发和测试
• 分布式存储集群：构建大规模分布式存储系统，满足高可用性和高容量需求
• 边缘计算存储：在边缘设备（如ARM架构设备）上部署，支持边缘数据存储和处理

使用方法与配置说明

基本部署（单节点模式）

使用以下命令快速启动MinIO单节点服务：

bash
docker run -p 9000:9000 -p 9001:9001 minio/minio server /data --console-address ":9001"

• -p 9000:9000：映射S3 API端口
• -p 9001:9001：映射Web控制台端口
• /data：容器内存储数据的目录
• --console-address ":9001"：指定Web控制台监听端口

持久化存储配置

为避免容器重启后数据丢失，建议挂载主机目录作为持久化存储：

bash
docker run -p 9000:9000 -p 9001:9001 \
  -v /path/to/local/data:/data \
  minio/minio server /data --console-address ":9001"

设置访问凭证

通过环境变量设置MinIO管理员凭证（推荐）：

bash
docker run -p 9000:9000 -p 9001:9001 \
  -e "MINIO_ROOT_USER=AKIAEXAMPLE" \
  -e "MINIO_ROOT_PASSWORD=examplepassword" \
  -v /path/to/local/data:/data \
  minio/minio server /data --console-address ":9001"

分布式模式部署

MinIO支持分布式部署以提高可用性和容错能力。以下是分布式部署示例（需至少4个节点）：

bash
docker run -p 9000:9000 -p 9001:9001 \
  -e "MINIO_ROOT_USER=AKIAEXAMPLE" \
  -e "MINIO_ROOT_PASSWORD=examplepassword" \
  -v /path/to/local/data:/data \
  minio/minio server \
  http://node1/data http://node2/data http://node3/data http://node4/data \
  --console-address ":9001"

环境变量配置

MinIO支持多种环境变量配置，常用参数如下：

访问Web控制台

部署成功部署后，通过http://localhost:9001访问MinIO Web控制台，使用配置的MINIO_ROOT_USER和MINIO_ROOT_PASSWORD登录，可进行桶管理、用户配置、数据上传等操作。