发送我的文件 —— 使用短期有效的签名 URL 上传至 R2

将文件上传至 Cloudflare R2 或任意兼容 S3 的存储服务，并生成预签名下载链接。

功能特性

• 向 R2/S3 存储桶上传文件
• 生成预签名下载 URL（可配置过期时间）
• 支持任意兼容 S3 的存储服务（R2、AWS S3、MinIO 等）
• 支持多个存储桶配置
• 自动检测 Content-Type

配置

创建 ~/.r2-upload.yml 配置文件（或设置环境变量 R2_UPLOAD_CONFIG）：

# 默认存储桶（未指定存储桶时使用）
default: my-bucket

# 存储桶配置
buckets:
  my-bucket:
    endpoint: https://abc123.r2.cloudflarestorage.com
    access_key_id: your_access_key
    secret_access_key: your_secret_key
    bucket_name: my-bucket
    public_url: https://files.example.com  # 可选：自定义域名
    region: auto  # 对于 R2，请使用 "auto"
    
  # 其他存储桶
  personal:
    endpoint: https://xyz789.r2.cloudflarestorage.com
    access_key_id: ...
    secret_access_key: ...
    bucket_name: personal-files
    region: auto

Cloudflare R2 设置步骤

1. 进入 Cloudflare 控制台 → R2
2. 创建一个存储桶
3. 前往 R2 API Tokens 页面：https://dash.cloudflare.com//r2/api-tokens
4. 创建新的 API Token
   • 重要：请限定作用范围为特定存储桶（选择你的存储桶）
   • 权限：Object Read & Write
5. 复制 Access Key ID 和 Secret Access Key
6. Endpoint 格式为：https://.r2.cloudflarestorage.com
7. 设置 region: auto

AWS S3 设置示例

aws-bucket:
  endpoint: https://s3.us-east-1.amazonaws.com
  access_key_id: ...
  secret_access_key: ...
  bucket_name: my-aws-bucket
  region: us-east-1

使用方法

上传单个文件

r2-upload /path/to/file.pdf
# 返回：https://files.example.com/abc123/file.pdf?signature=...

指定自定义路径上传

r2-upload /path/to/file.pdf --key uploads/2026/file.pdf

上传至指定存储桶

r2-upload /path/to/file.pdf --bucket personal

自定义过期时间（默认：5 分钟）

r2-upload /path/to/file.pdf --expires 24h
r2-upload /path/to/file.pdf --expires 1d
r2-upload /path/to/file.pdf --expires 300  # 单位：秒

生成公开 URL（不带签名）

r2-upload /path/to/file.pdf --public

工具命令

• r2_upload — 上传文件并获取预签名 URL
• r2_list — 列出最近上传的文件
• r2_delete — 删除指定文件

环境变量

• R2_UPLOAD_CONFIG — 配置文件路径（默认：~/.r2-upload.yml）
• R2_DEFAULT_BUCKET — 覆盖默认存储桶名称
• R2_DEFAULT_EXPIRES — 默认过期时间（单位：秒，默认值：300，即 5 分钟）

注意事项

• 除非通过 --key 显式指定路径，否则文件将使用原始文件名存储
• 系统会自动添加 UUID 前缀以避免命名冲突（例如：abc123/file.pdf）
• Content-Type 将根据文件扩展名自动检测
• 预签名 URL 在配置的过期时间后失效