mexiaow/minio repository overview

⁠MinIO 对象存储（mexiaow/minio）

• 上游来源：minio/minio
• 当前默认版本（latest 指向）：RELEASE.2025-04-22T22-12-26Z
• 指纹标签（推荐用于生产）：RELEASE.2025-04-22T22-12-26Z-sha-a1ea29fa2835
• 多架构：linux/amd64、linux/arm64、linux/ppc64le

⁠支持的标签

• RELEASE.2025-04-22T22-12-26Z
• RELEASE.2025-04-22T22-12-26Z-sha-a1ea29fa2835（与上面指向同一清单，便于版本固定与追溯）
• latest（当前指向 RELEASE.2025-04-22T22-12-26Z，后续可能更新）

⁠快速开始（单机）

# 创建数据与配置目录（宿主机）
mkdir -p /opt/minio/data
mkdir -p /opt/minio/config

# 启动（9000 为 S3 API，9001 为控制台）
docker run -d \
  --name minio \
  -p 9000:9000 \
  -p 9001:9001 \
  -e "MINIO_ROOT_USER=youradmin" \
  -e "MINIO_ROOT_PASSWORD=your-strong-password" \
  -v /opt/minio/data:/data \
  -v /opt/minio/config:/root/.minio \
  --restart unless-stopped \
  mexiaow/minio:latest server /data --console-address ":9001"

• 访问控制台：http://<主机IP或域名>:9001
• 登录账号：MINIO_ROOT_USER / MINIO_ROOT_PASSWORD

⁠Docker Compose 示例

version: '3.8'
services:
  minio:
    image: mexiaow/minio:latest
    container_name: minio
    restart: unless-stopped
    ports:
      - "9000:9000"   # S3 API
      - "9001:9001"   # Web Console
    environment:
      MINIO_ROOT_USER: youradmin
      MINIO_ROOT_PASSWORD: your-strong-password
    command: server /data --console-address ":9001"
    volumes:
      - /opt/minio/data:/data
      - /opt/minio/config:/root/.minio

启动：

docker compose up -d

⁠常用环境变量

• MINIO_ROOT_USER：初始管理员用户名
• MINIO_ROOT_PASSWORD：初始管理员密码
• MINIO_SERVER_URL：外部访问的 S3 Endpoint（如有反向代理/TLS，建议设置）
• MINIO_BROWSER_REDIRECT_URL：控制台外部地址（如通过独立域名访问控制台）

⁠升级与回滚

• 升级：修改镜像标签 → docker pull → docker stop && docker rm → 重新启动容器/Compose
• 回滚：切回旧的指纹标签或摘要即可（数据目录保持不变）
• 生产推荐固定版本：
  • 指纹标签：mexiaow/minio:RELEASE.2025-04-22T22-12-26Z-sha-a1ea29fa2835
  • 或用清单摘要：mexiaow/minio@sha256:a1ea29fa28355559ef137d71fc570e508a214ec84ff8083e39bc5428980b015e

⁠数据持久化与备份

• 数据目录：/data（请务必持久化到宿主机或外部存储）
• 配置目录：/root/.minio（建议随数据目录一并备份）
• 备份建议：
  • 定期备份 /opt/minio/data 与 /opt/minio/config
  • 或在对象级别使用版本化/跨区域复制等策略

⁠常见问题

• 端口冲突：调整 -p 9000:9000 -p 9001:9001 的宿主机端口
• 权限异常：确保 Docker 对挂载目录有读写权限（必要时 chown/chmod）
• 登录失败：检查环境变量与引号；包含 ! 等字符建议使用单引号