### Python 中使用 MinIO 生成 PDF 下载的预签名 URL 在 Python 中利用 MinIO 客户端库可以轻松实现生成对象（如 PDF 文件）的预签名下载链接功能。这允许用户无需直接访问存储桶即可安全地获取文件资源。以下是具体的操作说明与代码示例。 #### 创建 MinIO 客户端连接 首先需初始化一个 MinIO 客户端实例，通过指定服务器地址、访问密钥 (Access Key) 和秘密密钥 (Secret Key)，建立到 MinIO 存储服务的有效会话。 ```python from datetime import timedelta from minio import Minio client = Minio( "your-minio-endpoint", # 替换为您的 MinIO 服务地址 access_key="your-access-key", secret_key="your-secret-key", secure=True # 是否启用 HTTPS，默认 True ) ``` #### 准备存储环境 确认目标 Bucket 已存在，如果不存在则创建之。这里假设我们要在一个叫作 `documents` 的 Bucket 上托管 PDF 资源。 ```python bucket_name = 'documents' found = client.bucket_exists(bucket_name) if not found: client.make_bucket(bucket_name) else: print(f"Bucket '{bucket_name}' already exists.") ``` #### 上传 PDF 文件至 MinIO 将本地磁盘上的 PDF 文档上传至前述准备好的 Bucket 中作为对象保存起来。 ```python local_pdf_path = '/path/to/local/file.pdf' # 替换为您实际的 PDF 文件路径 object_name = 'example_report.pdf' try: result = client.fput_object( bucket_name=bucket_name, object_name=object_name, file_path=local_pdf_path ) print(f"'{local_pdf_path}' is successfully uploaded as " f"object '{result.object_name}' to bucket '{bucket_name}'.") except Exception as e: print(f"Error during upload: {e}") ``` #### 构造预签名 GET 请求 URL 调用 `presigned_get_object()` 方法基于设定的时间期限返回可供外部访问的对象下载链接。 ```python def get_presigned_download_url(bucket_name, object_name, expiration_days=7): """ Generate a pre-signed URL allowing temporary public read-only access. :param bucket_name: Name of the storage container. :param object_name: Targeted item inside specified bucket. :param expiration_days: Validity period in days before link becomes invalid. :return: A string representing generated downloadable URL. """ try: expires_in = timedelta(days=expiration_days) url = client.presigned_get_object(bucket_name, object_name, expires=expires_in) return url except Exception as error: raise RuntimeError(f"Could not create signed URL due to unexpected issue: {error}") download_link = get_presigned_download_url('documents', 'example_report.pdf') print(f"Generated Pre-Signed Download Link: {download_link}")[^1] ``` --- #### 注意事项 - **安全性考量**：尽管预签名 URL 提供了一定程度的安全保障机制，但仍建议合理控制有效期长度以降低泄露风险[^2]。 - **跨平台兼容性**：对于 Windows 平台产生的数据迁移至 Linux 类型主机运行时，请特别留意目录结构差异可能导致的问题，比如特殊字符转义处理不当等情况[^3]。