Python连接MinIO的完整指南

docker run -p 9000:9000 -p 9090:9090 \
  -e "MINIO_ACCESS_KEY=admin" \
  -e "MINIO_SECRET_KEY=password123" \
  -e "MINIO_SERVER_URL=https://minio.example.com" \
  -v /data:/data \
  -v /certs:/root/.minio/certs \
  minio/minio server /data --console-address ":9090"

pip install minio

from minio import Minio
from minio.error import S3Error

# 域名直连方案（自动处理HTTPS/HTTP）
client = Minio(
    endpoint="minio.example.com",  # 纯域名无端口
    access_key="YOUR_ACCESS_KEY",
    secret_key="YOUR_SECRET_KEY",
    secure=True,  # 自动启用HTTPS
    region="us-east-1"
)

# 验证连接
buckets = client.list_buckets()
print(f"成功连接，存储桶列表：{buckets}")

# 上传文件（支持大文件分块）
client.put_object(
    "my-bucket",
    "large-file.zip",
    open("/path/to/file.zip", "rb"),
    length=os.path.getsize("/path/to/file.zip"),
    part_size=10*1024*1024  # 10MB分块
)

# 生成预签名URL
presigned_url = client.presigned_url(
    "GET",
    "my-bucket",
    "confidential.pdf",
    expires=3600  # 1小时有效期
)

# docker-compose.yml示例
services:
  minio-node1:
    image: minio/minio
    command: server http://minio{1...4}.example.com/data
    environment:
      MINIO_ACCESS_KEY: admin
      MINIO_SECRET_KEY: password123
    volumes:
      - /data/minio1:/data

  # 其余节点类似配置

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:GetObject"],
      "Resource": ["arn:aws:s3:::my-bucket/*"]
    }
  ]
}

# 错误示例
client = Minio("https://minio.example.com")  # ❌

# 正确示例
client = Minio("minio.example.com", secure=True)  # ✅

client = Minio(..., secure=False)  # 测试环境临时方案
# 生产环境应使用可信证书

from concurrent.futures import ThreadPoolExecutor

def upload_part(part_num, data):
    client.put_object(...)

with ThreadPoolExecutor() as executor:
    futures = [executor.submit(upload_part, i, data) for i in range(10)]