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

Variable	Required	Description
TENCENT_SECRET_ID	Yes	Tencent Cloud API Secret ID
TENCENT_SECRET_KEY	Yes	Tencent Cloud API Secret Key
TENCENT_COS_BUCKET	Yes	COS bucket name (e.g., my-bucket-1250000000)
TENCENT_COS_REGION	Yes	COS region (e.g., ap-guangzhou, ap-nanjing)
TENCENT_COS_PATH	No	Upload path prefix (default: uploads/)

Command Line Options

Option	Description
--secret-id	Tencent Cloud API Secret ID
--secret-key	Tencent Cloud API Secret Key
--bucket	COS bucket name
--region	COS region
--path	Upload path prefix

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