A simple, zero-config CLI tool to upload files or directories to Alibaba Cloud OSS.

• Upload entire directories or individual files
• Support glob patterns to filter uploads
• Configure via environment variables or CLI flags
• Adjustable timeout for large uploads

• Installation
• Configuration
• Usage
• Options
• Examples
• Environment Variables
• License

Install as a dev-dependency:

npm install --save-dev ali-oss-upload-cli

Or install globally:

npm install -g ali-oss-upload-cli

Create a .env file in your project root (and add it to .gitignore):

OSS_REGION=oss-cn-hangzhou
OSS_BUCKET=lesscap
OSS_KEY=your-access-key-id
OSS_SECRET=your-access-key-secret

oss-upload <local-path> -o <remote-prefix> [options]

• <local-path>: File or directory to upload.
• -o, --output <remote-prefix>: Required. Remote folder (prefix) in your bucket.

Upload the entire dist/ directory to /static:

oss-upload dist -o /static

Upload only JavaScript files:

oss-upload dist -o /static --filter "**/*.js"

Upload to bucket root (/) with a longer timeout:

oss-upload dist -o / --timeout 120000

Provide credentials inline (ideal for CI):

oss-upload dist -o / \
  --region oss-cn-hangzhou \
  --bucket lesscap \
  --key your-access-key-id \
  --secret your-access-key-secret

Use a custom env file:

oss-upload dist -o /static --envfile .env.test

MIT