Python 和 MinIO

如何使用 Python 和 MinIO 上传文件并返回文件地址

MinIO 是一个高性能对象存储系统，兼容 Amazon S3 API。这篇博客将详细介绍如何在 Python 中使用 MinIO 上传文件并返回文件地址。本文将涵盖以下内容：

• 安装 MinIO 客户端库
• 连接到 MinIO 服务器
• 上传文件到 MinIO
• 获取上传文件的 URL

安装 MinIO 客户端库

在开始之前，我们需要安装 MinIO 客户端库。这可以通过 pip 命令来完成。如果你尚未安装，请运行以下命令：

pip install minio

连接到 MinIO 服务器

在 Python 中，可以使用 minio 库创建一个 MinIO 客户端实例，连接到 MinIO 服务器。下面的代码展示了如何进行配置：

from minio import Minio

# 使用 Minio 类创建 MinIO 客户端实例
minio_client = Minio(
    "MinIO 服务器地址",  # 替换为你的 MinIO 服务器地址
    access_key="Access Key",  # 替换为你的 Access Key
    secret_key="Secret Key",  # 替换为你的 Secret Key
    secure=True  # 如果 MinIO 服务器使用 SSL/TLS, 此处设置为 True
)

上传文件到 MinIO

接下来，编写一个函数来上传文件到 MinIO，并返回上传文件的 URL。该函数会检查指定的存储桶是否存在，如果不存在，则创建新的存储桶。上传完成后，生成一个预签名的 URL，允许访问上传的文件。

from minio.error import S3Error
import os
from datetime import timedelta

def upload_file_to_minio(minio_client, bucket_name, file_path, object_name):
    try:
        # 检查 bucket 是否存在
        if not minio_client.bucket_exists(bucket_name):
            minio_client.make_bucket(bucket_name)
        else:
            print("Bucket 已经存在.")

        # 上传文件
        minio_client.fput_object(bucket_name, object_name, file_path)
        print(f"文件 `{file_path}` 成功上传为 `{object_name}` 到 bucket `{bucket_name}`.")

        # 生成预签名的 URL (例如：有效期为1天)
        url = minio_client.presigned_get_object(bucket_name, object_name, expires=timedelta(days=1))
        return url

    except S3Error as err:
        print(f"S3Error: {err}")
        return None

示例：上传文件并获取 URL

以下是一个完整的示例，展示如何使用上述函数来上传文件，并获取其访问 URL。

if __name__ == "__main__":
    bucket_name = "my-bucket"  # 替换为你的 bucket 名字
    file_path = "path/to/your/file.txt"  # 替换为你要上传的文件路径
    object_name = os.path.basename(file_path)
    
    file_url = upload_file_to_minio(minio_client, bucket_name, file_path, object_name)
    if file_url:
        print(f"文件 URL: {file_url}")

通过运行上述代码，你将能够将文件上传到 MinIO，并获取该文件的访问地址。访问地址是一个预签名的 URL，允许在规定时间内访问该文件。

希望这篇博客对你有所帮助！如果有任何问题或建议，请在评论中告知我。