jumpserver/minio

MinIO 快速启动指南

镜像概述

MinIO 是一款高性能对象存储，发布于 GNU Affero General Public License v3.0 许可下。它与 Amazon S3 云存储服务 API 兼容，可用于构建机器学习、分析和应用数据工作负载的高性能基础设施。本镜像提供了 MinIO 服务器的容器化部署方式，适用于早期开发和评估场景。对于 Kubernetes 环境，建议使用 https://github.com/minio/operator/blob/master/README.md%E3%80%82

核心功能与特性

• S3 API 兼容：完全兼容 Amazon S3 API，可无缝集成现有 S3 生态工具和应用
• 高性能：针对对象存储优化的架构，支持高吞吐量和低延迟操作
• 嵌入式控制台：内置 Web 界面（MinIO Console），用于管理存储桶、上传对象和浏览内容
• 灵活部署：支持单机模式（适合开发/评估）和分布式模式（带擦除编码，适合生产环境）
• 多平台支持：可在容器、macOS、GNU/Linux、Windows 等多种环境运行

使用场景与适用范围

• 早期开发与评估：单机模式适合开发阶段测试和功能验证
• 小规模数据存储：用于存储应用数据、日志、备份等非关键业务数据
• S3 兼容服务测试：作为本地 S3 服务替代品，验证应用与 S3 API 的兼容性

注意：版本控制、对象锁定、桶复制等高级功能需通过分布式部署并启用擦除编码实现，生产环境建议每台 MinIO 服务器至少配置 4 块驱动器。详见 MinIO 擦除编码概述。

使用方法与配置说明

Docker 快速启动

基本运行（临时存储）

使用以下命令运行最新稳定版 MinIO 容器，采用临时数据卷（容器重启后数据丢失）：

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

• 默认凭据：初始 root 凭据为 minioadmin:minioadmin
• 端口说明：9000 为 API 端口，9001 为控制台端口（通过 --console-address 指定）

持久化存储配置

要保留数据，需将主机目录映射到容器内的数据目录，使用 -v 参数：

bash
docker run -p 9000:9000 -p 9001:9001 \
  -v /mnt/data:/data \
  jumpserver/minio server /data --console-address ":9001"

其中 /mnt/data 是主机上的持久化目录，/data 是容器内的数据存储路径。

访问与测试

通过 MinIO 控制台访问

启动容器后，在浏览器中访问 http://127.0.0.1:9000，使用默认凭据 minioadmin:minioadmin 登录。通过控制台可创建存储桶、上传对象和管理存储服务。

通过 S3 工具访问

可使用任何 S3 兼容工具（如 MinIO Client mc）连接：

1. 安装 mc（参考 MinIO Client 快速启动指南）
2. 配置 MinIO 服务别名：

   bash
   mc alias set myminio http://127.0.0.1:9000 minioadmin minioadmin
   

3. 测试连接：

   bash
   mc ls myminio
   

高级配置

环境变量配置

示例（带环境变量的启动命令）：

bash
docker run -p 9000:9000 -p 9001:9001 \
  -v /mnt/data:/data \
  -e "MINIO_BROWSER_REDIRECT_URL=https://console.minio.example.net" \
  -e "MINIO_SERVER_URL=https://minio.example.net" \
  jumpserver/minio server /data --console-address ":9001"

防火墙配置

默认情况下，MinIO 使用 9000 端口（API）和 9001 端口（控制台），需确保这些端口在防火墙中开放：

• ufw（Debian 系）：

  bash
  ufw allow 9000:9001/tcp
  

• firewall-cmd（CentOS）：

  bash
  firewall-cmd --zone=public --add-port=9000-9001/tcp --permanent
  firewall-cmd --reload
  

• iptables：

  bash
  iptables -A INPUT -p tcp --dport 9000:9001 -j ACCEPT
  service iptables restart
  

升级 MinIO 容器

容器环境升级需拉取最新镜像并重启容器：

1. 拉取最新镜像：

   bash
   docker pull jumpserver/minio
   

2. 停止并删除旧容器（假设容器名为 minio）：

   bash
   docker stop minio && docker rm minio
   

3. 使用新镜像启动容器（保留持久化卷配置）：

   bash
   docker run -d --name minio -p 9000:9000 -p 9001:9001 -v /mnt/data:/data jumpserver/minio server /data --console-address ":9001"
   

探索更多

• MinIO 擦除编码概述
• MinIO Client (mc) 使用指南
• MinIO SDK 文档
• MinIO 官方文档

许可证

• MinIO 源代码采用 GNU AGPLv3 许可，详见 https://github.com/minio/minio/blob/master/LICENSE
• MinIO 文档采用 CC BY 4.0 许可