MinIO 新版本 Docker 部署指南：CLI 管理替代 Web 控制台

version: "3.8"
services:
  minio:
    # 如果本地构建镜像，用 build 指令替代 image
    # build:
    #   context: .
    #   dockerfile: Dockerfile
    image: minio:minio:RELEASE.2025-10-15T17-29-55Z
    container_name: minio
    networks:
      - srebro
    ports:
      - 9000:9000
      - 9001:9001
    volumes:
      - ./data:/data
      - ./mc-config:/tmp/.mc:rw
      - /etc/localtime:/etc/localtime:ro
      - /usr/share/zoneinfo:/usr/share/zoneinfo:ro
    environment:
      MINIO_ROOT_USER: <MINIO_ROOT_USER>
      MINIO_ROOT_PASSWORD: <MINIO_ROOT_PASSWORD>
      TZ: Asia/Shanghai
    command: server /data --console-address :9001
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
      interval: 10s
      timeout: 5s
      retries: 10
    restart: unless-stopped
  minio-init:
    image: minio:minio:RELEASE.2025-10-15T17-29-55Z
    container_name: minio-init
    depends_on:
      minio:
        condition: service_healthy
    networks:
      - srebro
    volumes:
      - ./mc-config:/tmp/.mc:rw
    entrypoint: >
      /bin/sh -c " /usr/bin/mc alias set minio http://minio:9000 <MINIO_ROOT_USER> '<MINIO_ROOT_PASSWORD>'; /usr/bin/mc mb minio/<BUCKET_NAME>; /usr/bin/mc ls minio; exit 0; "
networks:
  srebro:
    external: true

• 启动与查看：

docker compose up -d
docker compose ps
docker compose logs -f minio

五、Web 控制台阉割功能的替代：使用 mc 命令

上面的容器都内置了 mc 命令，使用一个 JSON 格式的配置文件来存储某些类型的信息，比如为每个配置的 S3 兼容服务设置的别名。mc 的配置文件也都持久化了，可直接使用，管理 minio

• 登陆容器，运行 mc 命令

docker exec -it minio bash
mc --version

• 查看 mc 配置

mc alias ls

• bucket 管理：

# mc mb minio/<BUCKET_NAME> # 创建 bucket
# mc ls minio # 列出 bucket
# mc rb minio/<BUCKET_NAME> --force # 强制删除 bucket，即使含有文件

• object 文件管理：

# echo "This is my test file!" > test.txt
# mc cp test.txt minio/<BUCKET_NAME>/test.txt # 上传测试文件
# mkdir testdir
# echo "This is my test02 file!" > testdir/test02.txt
# mc cp testdir minio/<BUCKET_NAME> --recursive # 上传测试目录，且递归上传该目录下的所有文件
# mc ls minio/<BUCKET_NAME> # 查看 minio 存储
# mkdir download
# mc cp minio/<BUCKET_NAME>/test01.txt download/ # 下载文件
# mc cp minio/<BUCKET_NAME>/testdir download/ --recursive # 下载目录，且递归下载
# mc rm minio/<BUCKET_NAME>/test01.txt # 删除文件
# mc rm minio/<BUCKET_NAME>/testdir --recursive --force # 删除目录，即使包含文件
# mc ls minio/<BUCKET_NAME> # 查看 minio 存储

• 桶匿名策略（公开/私有）：

mc anonymous set public minio/<BUCKET_NAME>
mc anonymous set private minio/<BUCKET_NAME>

• 创建 ACCESS_KEY 和 SECRET_KEY：

# 创建 ACCESS_KEY 和 SECRET_KEY
mc admin user add minio <ACCESS_KEY> <SECRET_KEY>
# 修改用户权限
mc admin policy attach minio readwrite --user <ACCESS_KEY>

六、MinIO 对象生命周期管理（ILM）配置说明

概念：

• MinIO 的对象生命周期管理（Object Lifecycle Management, ILM）是一项自动化策略引擎，用于根据用户定义的规则自动管理对象的存储状态，包括过期删除、存储类转换（降本）、版本清理等。其核心目标是简化数据全生命周期的成本控制和合规性管理，尤其适用于海量数据存储场景。
• 规则按桶与前缀匹配，控制对象过期与非当前版本（启用版本化后）的清理。

基础规则示例：

• 将 logs/ 前缀下对象在 30 天后过期

mc ilm rule add minio/<BUCKET_NAME> \
  --prefix "logs/" \
  --expiry-days 30

• 将 logs/ 前缀下对象在 30 天后过期，非当前版本 7 天清理：

mc ilm rule add minio/<BUCKET_NAME> \
  --prefix "logs/" \
  --expiry-days 30 \
  --noncurrent-expire-days 7

• 查看与删除规则：

mc ilm rule ls minio/<BUCKET_NAME>
mc ilm rule rm minio/<BUCKET_NAME> --id <rule-id>

• 按 JSON 导入（便于审计与版本管理）：

cat > ilm.json <<'EOF'
{
  "Rules": [
    {
      "ID": "expire-logs-30d",
      "Status": "Enabled",
      "Filter": { "Prefix": "logs/" },
      "Expiration": { "Days": 30 },
      "NoncurrentVersionExpiration": { "NoncurrentDays": 7 }
    }
  ]
}
EOF
mc ilm import minio/<BUCKET_NAME> ilm.json
mc ilm export minio/<BUCKET_NAME>

七、总结

• 新版本不再提供 Docker 镜像和预编译好的二进制文件，需要大家自行编译与封装镜像。
• Web 控制台功能阉割后，可用 mc 命令完成用户、策略、桶、版本化、ILM 等管理操作。
• 因 CVE-2025-62506，应尽快升级到 RELEASE.2025-10-15T17-29-55Z 或更高版本；通过 Dockerfile 多阶段构建与 Docker Compose 可快速落地与运维。

八、参考

• https://github.com/minio/minio/issues/21647
• https://docs.min.io/enterprise/aistor-object-store/