R2 object storage API: upload,…

# D盘照片批量上传至R2方案

一、准备工作

• 确认已有 Cloudflare 账号，并创建好 R2 桶 my-photos（Dashboard → R2 → Create Bucket）
• 在 R2 页面生成 API Token（需 Object Read & Write 权限），记下 Access Key ID、Secret Access Key 和 Account ID（S3 兼容端点形如 https://<ACCOUNT_ID>.r2.cloudflarestorage.com）
• 推荐工具：rclone（对 multipart 和批量过滤支持最好），也可用 AWS CLI 或 Wrangler

二、配置 rclone

命令行执行 rclone config，新建 remote：

• type 选 Amazon S3 Compatible
• provider 选 Cloudflare，endpoint 填上面的 S3 兼容地址
• 粘贴 Access Key / Secret Key

三、筛选 2024 年照片并上传

300 张照片用 rclone 的日期过滤即可：

```bash

rclone copy D:\backup r2:my-photos/2024 ^

--include "*.{jpg,jpeg,png,heic,webp}" ^

--max-age 2024-01-01 --min-age 2025-01-01 ^

--transfers 8 --checkers 16 --progress

```

• 若文件时间戳不可靠，可先 rclone lsf --files-only 配合 PowerShell 按“修改时间在 2024 年”预筛到临时目录再上传
• 上传后校验：rclone check D:\backup r2:my-photos/2024 --include "..."

四、大视频 multipart 上传

超过 100MB 的视频无需手动分片，rclone 会自动走 S3 multipart，只需调优参数：

```bash

rclone copy D:\backup r2:my-photos/videos ^

--include "*.{mp4,mov,mkv,avi}" ^

--min-age 2025-01-01 --max-age 2024-01-01 ^

--s3-upload-concurrency 4 ^

--s3-chunk-size 32M ^

--transfers 2 --progress

```

• --s3-chunk-size：每片大小（R2 单片最小 5MB、上限约 5GB），大文件可调到 64M–128M 减少请求数
• --s3-upload-concurrency：并行分片数，视带宽 2–8
• 中断后重跑同命令会续传未完成的 multipart（rclone 默认支持 resume）

五、注意事项

• R2 免费额度含每月一定存储与 Class A/B 操作额度，大量小文件注意请求数
• 上传完成可用 rclone size r2:my-photos 核对总数与总大小
• 敏感照片建议配合开启桶的访问限制，不要设公共读取

遇到日期过滤不准时，先小批量 --dry-run 验证文件清单再正式上传。