Python操作MinIO实战教程

想知道如何用 Python 轻松玩转 MinIO 对象存储？本文为你奉上详尽的实战指南！MinIO 作为高性能且兼容 S3 协议的存储方案，在私有云和本地文件存储中应用广泛。本文将一步步教你如何使用 Python 官方 SDK 操作 MinIO，包括安装 minio 库、初始化客户端连接（服务地址、Access Key、Secret Key 设置），以及 bucket 的创建与检查。你还将学会如何上传文件（包括大文件分片处理）、下载文件、删除文件，以及列出指定目录下的文件。更进一步，本文还介绍了如何生成带过期时间的临时下载链接，方便前端应用集成。掌握这些技巧，你就能轻松应对各种文件存储需求，提升 Python 开发效率！

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学习网公众号！