User Guide
Storage Service Configuration
Configure file storage providers
TinyShip provides a unified storage layer across major object storage vendors.
Supported Providers
| Provider | Advantage | Recommended Use |
|---|---|---|
| Aliyun OSS | Fast in China, Alibaba ecosystem | China-focused apps |
| AWS S3 | Global ecosystem and maturity | International apps |
| Cloudflare R2 | No egress fee, cost-efficient | Cost-sensitive apps |
| Tencent COS | Strong CN cloud ecosystem | China-focused apps |
Environment Variables
STORAGE_PROVIDER=oss
OSS_REGION=oss-cn-shanghai
OSS_ACCESS_KEY_ID=your_access_key_id
OSS_ACCESS_KEY_SECRET=your_access_key_secret
OSS_BUCKET=your-bucket-name
S3_REGION=us-east-1
S3_ACCESS_KEY_ID=your_access_key_id
S3_ACCESS_KEY_SECRET=your_secret_access_key
S3_BUCKET=your-bucket-name
CLOUDFLARE_ACCOUNT_ID=your_cloudflare_account_id
R2_ACCESS_KEY_ID=your_r2_access_key_id
R2_ACCESS_KEY_SECRET=your_r2_access_key_secret
R2_BUCKET=your-bucket-name
COS_REGION=ap-guangzhou
COS_SECRET_ID=your_secret_id
COS_SECRET_KEY=your_secret_key
COS_BUCKET=your-bucket-name-appidR2 now recommends CLOUDFLARE_ACCOUNT_ID; R2_ACCOUNT_ID is kept only as backward-compatible fallback.