用途:在 S3 兼容对象存储上执行文件操作,支持 AWS S3、Cloudflare R2 和 MinIO。
主要能力:列出对象、上传文件、下载文件。
环境变量:AWS_ACCESS_KEY_ID(访问密钥)、AWS_SECRET_ACCESS_KEY(密钥)、AWS_DEFAULT_REGION(区域,默认 us-east-1)、S3_ENDPOINT(R2/MinIO 自定义端点,可选)、S3_BUCKET(默认存储桶名)。
安装:pip3 install boto3 2>/dev/null
用法:列出对象时用 boto3.client('s3', endpoint_url=os.environ.get('S3_ENDPOINT'), region_name=os.environ.get('AWS_DEFAULT_REGION', 'us-east-1')) 调用 list_objects_v2,传入 Bucket 与 MaxKeys;上传用 upload_file(本地路径, 桶名, 远端路径);下载用 download_file(桶名, 远端路径, 本地路径)。
限制与说明:R2 需设置 S3_ENDPOINT=https://<account-id>.r2.cloudflarestorage.com;boto3 会自动从环境变量读取 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。其余细节暂未提供。