Tencent COS 上传器

概述

使用 Tencent COS Python SDK 上传本地文件，并返回用于浏览器预览和文件下载的预签名 URL（presigned URL）。

前提条件

1. 安装依赖：

pip install cos-python-sdk-v5

2. 准备 COS 凭据（推荐通过环境变量配置）：

• COS_SECRET_ID
• COS_SECRET_KEY
• COS_REGION
• COS_BUCKET
• COS_SESSION_TOKEN（可选，适用于临时凭据）

工作流程

1. 确认必需输入项：
   • region（来自 --region 参数或环境变量）
   • bucket（来自 --bucket 参数或环境变量）
   • --file：本地文件路径
   • --key：对象在存储桶中的键名（默认为文件名）
2. 运行脚本：

python3 scripts/cos_upload_and_presign.py 
  --region ap-guangzhou 
  --bucket my-bucket-1250000000 
  --file /absolute/path/to/file.pdf 
  --key reports/2026/file.pdf 
  --expires 3600

3. 返回 JSON 输出，包含以下字段：
   • view_url：用于浏览器查看的 GET 预签名 URL
   • download_url：带 attachment 响应头的预签名 URL（触发下载）
   • upload_result：SDK 上传操作的原始响应结果

脚本参数

• --region：COS 区域，若已设置 COS_REGION 环境变量则为可选
• --bucket：带 AppID 后缀的存储桶名称，若已设置 COS_BUCKET 环境变量则为可选
• --file：待上传的本地文件路径，必需
• --key：对象在存储桶中的键名，可选
• --expires：URL 过期时间（单位：秒），默认为 3600
• --secret-id：若已设置 COS_SECRET_ID 环境变量则为可选
• --secret-key：若已设置 COS_SECRET_KEY 环境变量则为可选
• --session-token：若已设置 COS_SESSION_TOKEN 环境变量则为可选
• --scheme：URL 协议，可选值为 https 或 http，默认为 https
• --download-filename：自定义下载时提示保存的文件名（可选）

注意事项

• 请将 expires 设置为实际所需的最短时间，以降低预签名 URL 泄露风险。
• download_url 由 get_presigned_download_url 方法生成；view_url 由 get_presigned_url(Method='GET') 方法生成。
• 若未指定 --key，脚本将自动使用源文件名作为对象键名。