Python操作MinIO实战教程

本文是一份实战指南，旨在帮助开发者掌握如何使用 Python 操作 MinIO 对象存储系统。MinIO 作为高性能且兼容 S3 协议的存储方案，在私有云和本地文件存储中应用广泛。通过 MinIO 官方提供的 Python SDK，开发者可以轻松实现文件的上传、下载和管理。教程详细介绍了如何安装 `minio` 库，初始化客户端连接，创建 Bucket，以及利用 `upload_file` 上传文件，`fget_object` 下载文件，`remove_object` 删除文件。此外，还讲解了如何使用 `list_objects` 列出指定目录下的文件，并生成带有过期时间的临时下载链接（`presigned_get_object`）。掌握这些关键步骤，即可满足大部分业务场景下的文件操作需求。

Python 操作 MinIO 需先安装官方 SDK。1. 安装 minio 库并初始化客户端连接，需提供服务地址、Access Key、Secret Key 及 HTTPS 设置；2. 创建 bucket 前应检查其是否存在；3. 使用 upload_file 方法上传文件，注意路径正确性与大文件分片处理；4. 用 fget_object 下载文件，remove_object 删除文件；5. list_objects 可列出指定目录文件；6. presigned_get_object 生成带过期时间的临时下载链接。以上步骤覆盖了常见文件操作，适用于大多数业务场景。

MinIO 是一个高性能、兼容 S3 协议的对象存储系统，非常适合用来做私有云或本地部署的文件存储。如果你用 Python 做后端开发或者数据处理，很多时候会需要上传、下载、管理这些对象文件。那 Python 怎么操作 MinIO 呢？其实挺简单的，只要用官方提供的 SDK 就行。

安装和初始化连接

第一步是安装 MinIO 的 Python 客户端库：

pip install minio

然后你需要准备几个参数：MinIO 服务地址、访问密钥（Access Key）、秘密密钥（Secret Key），以及是否使用 HTTPS。接着就可以初始化客户端了：

from minio import Minio

client = Minio(
    "play.min.io",  # 替换为你自己的地址
    access_key="YOUR_ACCESS_KEY",
    secret_key="YOUR_SECRET_KEY",
    secure=True  # 是否启用 HTTPS
)

这一步如果报错，多半是网络不通或者密钥不对，检查一下防火墙设置和密钥信息就行。

创建 Bucket 并上传文件

MinIO 里的 bucket 相当于一个文件夹容器。你可以先判断 bucket 是否存在，不存在就创建它：

bucket_name = "my-photos"

if not client.bucket_exists(bucket_name):
    client.make_bucket(bucket_name)

上传文件也很直接，使用 upload_object 方法即可：

client.upload_file(
    bucket_name,
    "2024/photo.jpg",  # 对象名称，可以带路径
    "local_photo.jpg"  # 本地文件路径
)

注意两点：

• 文件路径要写对，否则会提示找不到；
• 如果你上传的是大文件，建议分片上传（用 fput_object 或者流式上传）。

下载和删除文件

下载文件可以用 fget_object 方法，把远程文件保存到本地：

client.fget_object(
    bucket_name,
    "2024/photo.jpg",  # 远程路径
    "downloaded_photo.jpg"  # 本地保存路径
)

删除的话就更简单了：

client.remove_object(bucket_name, "2024/photo.jpg")

如果你要批量删除，可以循环调用这个方法，或者用 list_objects 列出一批再删。

列出文件和生成临时链接

有时候你想看看某个目录下有哪些文件，可以用 list_objects：

objects = client.list_objects(bucket_name, prefix="2024/", recursive=False)
for obj in objects:
    print(obj.object_name)

prefix 参数相当于限定目录，recursive 控制是否递归查找子目录。

另外，如果你希望生成一个临时可访问的 URL（比如给前端下载用），可以用：

url = client.presigned_get_object(
    bucket_name,
    "2024/photo.jpg",
    expires=timedelta(hours=1)  # 链接有效期
)

这个 URL 默认是 GET 请求可用，也可以生成 PUT 的链接用于上传。

基本上就这些。Python 操作 MinIO 其实不复杂，但要注意权限控制和网络问题。有些功能比如分片上传、事件通知等稍微复杂点，但在大多数业务场景下，上面这些操作已经够用了。

到这里，我们也就讲完了《Python操作MinIO实战教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于Python,sdk,对象存储,文件操作,MinIO的知识点！