name: cos-upload description: Upload files to Tencent Cloud COS (Cloud Object Storage). Use when the user needs to upload images, documents, or any files to Tencent Cloud COS. Supports environment variables or command-line arguments for configuration. Automatically generates accessible URLs and signed URLs with 24-hour expiration.

COS Upload

Upload files to Tencent Cloud COS (腾讯云对象存储) with automatic URL generation.

Quick Start

Method 1: Using Environment Variables

Set these environment variables:

export TENCENT_SECRET_ID=your-secret-id
export TENCENT_SECRET_KEY=your-secret-key
export TENCENT_COS_BUCKET=your-bucket-name
export TENCENT_COS_REGION=ap-guangzhou
export TENCENT_COS_PATH=uploads/  # optional

Then upload:

node cos-upload.js /path/to/file.png

Method 2: Using Command Line Arguments

node cos-upload.js /path/to/file.png \
  --secret-id AKIDxxx \
  --secret-key xxx \
  --bucket my-bucket-1250000000 \
  --region ap-guangzhou \
  --path images/

Output

On successful upload, returns:

• Direct URL: https://{bucket}.cos.{region}.myqcloud.com/{key}
• Signed URL: Pre-signed URL with 24-hour expiration (for private buckets)
• COS Key: The object key in the bucket

Configuration Priority

1. Command line arguments (highest priority)
2. Environment variables
3. Default values

Environment Variables

Command Line Options

Notes

• Files are uploaded with auto-generated unique names: upload_{timestamp}_{random}.{ext}
• Supports all file types (images, documents, videos, etc.)
• Uses 5MB multipart upload threshold for large files
• Automatically generates both direct and pre-signed URLs