桶建好了、文件也传上去了,然后呢?
入门篇解决的是从零到一:开通、建桶、拿凭据、传上第一个文件。但真正把 R2 用进日常之后,冒出来的全是另一类问题,随便数数就有四个:
- 备份桶是私有的,里面有个大文件要临时发给别人下载。把桶改公开不合适,把自己的访问密钥发过去更离谱,有没有只给这一个文件、还带过期时间的办法?
- 服务器每天凌晨都会打出新的备份包,难道每次都要手动登录、手动上传?能不能让它自己同步上去,传完不用管?
- 博客的图片想直接放桶里当图床,怎么公开读最省事?控制台里那个 r2.dev 开关一键就能开,和绑自己的域名有什么区别?
- 备份一天一份往上堆,三个月后桶里躺着九十份全量包。旧的能不能自动删,别让它无声无息一直占着容量计费?
这四个问题,分别对应 R2 的四件进阶工具:预签名链接、rclone 同步、自定义域名公开桶、生命周期规则。下面逐个解。
官方文档:https://developers.cloudflare.com/r2/
一、先回顾:端点长什么样
R2 对外提供的是 S3 兼容 API,所有程序化访问都打到同一个端点上,格式固定:
https://<account_id>.r2.cloudflarestorage.com其中 <account_id> 是 Cloudflare 账户 ID,在控制台右侧栏和 R2 总览页都能找到。桶名不出现在域名里,而是作为请求参数或路径的一部分传过去;区域(region)在 SDK 里填 auto,由 Cloudflare 自己就近调度。本篇所有代码用的都是这个端点加一对 R2 API Token 换来的 Access Key ID 与 Secret Access Key,凭据怎么创建在第六节统一讲,先把四件事办了。
二、预签名链接:私有文件的临时通行证
预签名链接(Presigned URL)解决第一个问题。它的原理是:服务端用密钥在本地算出一个签名,把签名、允许的操作、目标对象、过期时间一起拼进 URL 里。拿到链接的人不需要任何密钥,点开就能执行被授权的那一个动作——比如下载某个文件,或者往某个键上传一个文件——到期自动作废。整个生成过程纯粹是本地签名计算,不需要真的向 R2 发请求。
有效期最短 1 秒、最长 7 天(604800 秒)。但先把丑话说前面:预签名链接是无记名通行证,谁拿到谁就能用,在过期之前可以被任意转发、重复使用。它等同于一张临时密码,只适合走私密渠道点对点发送,不要贴到公开页面、群聊或日志里。
生成下载与上传链接
Node.js 环境装两个官方包:
npm install @aws-sdk/client-s3 @aws-sdk/s3-request-presigner一段代码同时生成下载和上传两种链接:
import { S3Client, GetObjectCommand, PutObjectCommand } from "@aws-sdk/client-s3";import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
const S3 = new S3Client({ region: "auto", endpoint: `https://${process.env.R2_ACCOUNT_ID}.r2.cloudflarestorage.com`, credentials: { accessKeyId: process.env.R2_ACCESS_KEY_ID, secretAccessKey: process.env.R2_SECRET_ACCESS_KEY, },});
// 临时下载链接:允许在 1 小时内下载这一个文件const downloadUrl = await getSignedUrl( S3, new GetObjectCommand({ Bucket: "anexns-backup", Key: "reports/2026-report.pdf" }), { expiresIn: 3600 });console.log("下载链接:", downloadUrl);
// 临时上传链接:允许在 10 分钟内往这个键上传一个 mp4 文件const uploadUrl = await getSignedUrl( S3, new PutObjectCommand({ Bucket: "anexns-backup", Key: "uploads/big-video.mp4", ContentType: "video/mp4", }), { expiresIn: 600 });console.log("上传链接:", uploadUrl);对方拿到链接后不需要装任何工具,浏览器打开下载链接即可下载;上传链接用 curl 就能推文件:
curl -X PUT --upload-file ./big-video.mp4 \ -H "Content-Type: video/mp4" \ "<上面生成的上传链接>"如果只是临时给一个下载链接、不想专门写代码,AWS CLI 也能直接生成(需要先配好指向 R2 的凭据与端点):
aws s3 presign s3://anexns-backup/reports/2026-report.pdf \ --endpoint-url https://<account_id>.r2.cloudflarestorage.com \ --expires-in 3600注意 CLI 的 presign 只支持生成下载(GET)链接,上传链接还得走 SDK——这也符合实际分工:下载分享是临时起意,上传入口通常是程序功能的一部分。
三个使用要点
- 只能用 S3 API 端点。 预签名链接只认
r2.cloudflarestorage.com这个域名,绑在桶上的自定义域名不能用来拼预签名链接,这是排障一节里最常见的一个坑。 - 上传时 Content-Type 必须对上。 生成链接时如果指定了
ContentType,对方上传时请求头里必须带一模一样的值,否则签名校验不过。反过来这也是个优点:可以借它把上传限制在指定文件类型。 - 有效期按场景给,别图省事拉满。 发给人下载给 1 小时、网页直传给 10 分钟,足够用了;7 天那种长度只适合极少数内部场景。
三、rclone 同步备份:从手动上传到定时任务
第二个问题交给 rclone。它是命令行界的「云存储瑞士军刀」,对 R2 这种 S3 兼容存储,配置一次远程(remote),之后服务器备份就能靠脚本和定时任务全自动跑。
写配置文件
交互式向导 rclone config 一步步问也能配,但手写配置文件更直观、好备份。编辑 ~/.config/rclone/rclone.conf:
[r2]type = s3provider = Cloudflareaccess_key_id = 你的AccessKeyIDsecret_access_key = 你的SecretAccessKeyregion = autoendpoint = https://<account_id>.r2.cloudflarestorage.comacl = privateno_check_bucket = true最后一项 no_check_bucket = true 值得单独说:如果你的 Token 只给了某个桶的对象读写权限(第六节推荐的最小权限配法),rclone 默认在操作前会尝试探测、甚至创建桶,权限不够就会报错。加上这一项,它跳过桶级探测,直接按对象操作,正好和桶级授权的 Token 严丝合缝。
配完先验证连通性:
rclone lsd r2: # 列出账户下能看到的桶rclone ls r2:anexns-backup # 列出桶内对象(带大小)copy 与 sync 的分工
日常命令就两个,分工必须分清:
# copy:把本地目录里的新文件、改过的文件补传上去,目标端多出来的文件不动rclone copy /data/backup r2:anexns-backup/server-a --progress
# sync:让目标端和本地保持完全一致,本地没有的,目标端也会删掉rclone sync /data/backup r2:anexns-backup/server-a --progress区别一句话:copy 只增改、不删除;sync 是镜像,目标以本地为准。备份场景多数时候用 copy 就够了,配合第五节的生命周期规则在桶端统一清理过期文件。如果要用 sync,sync 会删掉目标端本地没有的文件,第一次跑务必先加 —dry-run 空跑一遍,确认删除清单符合预期再去掉。路径写反、把空目录 sync 到桶上,是这类工具最经典的事故,没有之一。
定时备份脚本
把打包和上传串成一个脚本,交给 cron 每天凌晨执行:
#!/usr/bin/env bashset -euo pipefail
BACKUP_DIR="/data/backup"REMOTE="r2:anexns-backup/server-a"STAMP="$(date +%F)"
# 打包站点文件与数据库导出tar -czf "${BACKUP_DIR}/site-${STAMP}.tar.gz" -C /var/www sitemysqldump --single-transaction appdb | gzip > "${BACKUP_DIR}/db-${STAMP}.sql.gz"
# 只上传,不删除桶端已有文件;旧备份的清理由生命周期规则负责rclone copy "${BACKUP_DIR}/" "${REMOTE}/${STAMP}/" \ --transfers 4 \ --log-file /var/log/rclone-backup.log --log-level INFO
# 本地只留最近 7 天find "${BACKUP_DIR}" -type f -mtime +7 -delete挂到定时任务里,每天凌晨 3 点跑:
chmod +x /usr/local/bin/backup-to-r2.shcrontab -e# 加入一行:# 0 3 * * * /usr/local/bin/backup-to-r2.sh同步类任务最怕「命令没报错,但文件其实没传全」。rclone 自带校验命令,拿不准时跑一次,它会逐个比对两端文件的大小与哈希,给出差异清单,定时任务里也可以接在 copy 后面当验收环节:
rclone check /data/backup r2:anexns-backup/server-a这套组合跑起来之后,服务器本地留 7 天热备份,R2 上留更久的历史版本,两边互不依赖。哪天要恢复,从 R2 用 rclone copy 把对应日期的包拉回来即可,R2 出口流量不收费,恢复大备份时不用心疼流量账单。
四、给博客当图床:公开读的三种方式怎么选
第三个问题的本质是「怎么让桶里的对象被公开访问」。R2 一共有三条路,先看对比表再做决定:
| 方式 | 公开范围 | 走 Cloudflare 缓存 | 限速与管控 | 适合场景 |
|---|---|---|---|---|
| 自定义域名 | 整个桶(或指定域名路径)全公开 | 支持,可配缓存规则 | 无额外限速,可叠加 WAF、缓存规则 | 正式图床、静态资源分发 |
| r2.dev 子域名 | 整个桶全公开 | 不支持自定义缓存策略 | 有限速,仅适合开发调试 | 临时预览、功能联调 |
| 预签名链接 | 单个对象、限时 | 不走自定义域名 | 到期自动失效 | 私有文件的临时分享 |
结论很直接:正式图床只推荐自定义域名这一条路。它走的是你自己域名下的子域名(比如 img.example.com),能吃满 Cloudflare 的边缘缓存,图片被反复访问时大部分请求由缓存直接响应,回源次数少、速度也稳;缓存多久、哪些路径缓存,可以再用缓存规则细调。
绑定步骤:进入桶的设置页,在「自定义域名」(Custom Domains)里添加一个子域名,域名必须是已经接入同一 Cloudflare 账户的 zone。Cloudflare 会自动创建对应的 DNS 记录并签发证书,状态从「正在初始化」变成「已启用」后,用 https://img.example.com/图片键名 就能访问桶里的对象,全程不用自己碰证书和回源配置。
WARNINGr2.dev 只适合开发调试,别拿它当正式图床。它是 Cloudflare 提供的共享子域名,官方明确定位为开发用途:有限速、不支持自定义缓存规则,也享受不到 WAF 等安全策略。联调时开一下没问题,博客上线前务必切到自定义域名。
还有一条安全边界:桶一旦公开,等于里面的每个对象全世界可读,任何人拿到键名就能访问。所以图床桶里只能放本来就打算公开的图片,备份、私有文件永远不要往公开桶里放——这也是入门篇强调图床桶与备份桶从第一天就分开建的原因。
五、生命周期规则:让旧备份自己消失
第四个问题不用写脚本删,R2 自带对象生命周期规则(Object Lifecycle Rules):在控制台按桶配置,满足条件的对象由平台自动处理。入口在桶的设置页「对象生命周期规则」,常用动作有三个:
- 到期删除:对象存满指定天数后自动删除。比如给备份桶加一条「前缀
server-a/、存满 30 天删除」,第三节脚本每天往上同步的新备份就不用操心清理,30 天前的自动消失。 - 转入低频访问类别:对象存满指定天数后,从标准存储转到 Infrequent Access(低频访问)类别,存储单价更低,代价是取回时要收费。适合「必须留着、但几乎不会打开」的长期归档,比如季度全量备份。
- 清理未完成的分片上传:大文件分片上传中断会留下残片,残片同样占容量。加一条「中止并清理超过 7 天未完成的分片上传」,避免这类隐形占用越攒越多。
一个实用的组合是:备份桶前缀按服务器分,统一 30 天删除;其中每月第一份全量包打到单独的 archive/ 前缀下,7 天后转低频、保留一年。热数据自动滚动、冷数据低价长存,桶的容量曲线自己会收敛,不需要任何外部清理脚本。
六、访问密钥管理:Token 的权限边界
前面所有操作都建立在一对 Access Key 上,最后把凭据本身管好。在控制台 R2 页面进入「管理 R2 API 令牌」(Manage R2 API Tokens)创建 Token 时,有三个维度可以收紧:
- 权限级别:分对象只读、对象读写、管理员读写三档。备份脚本只需要对象读写,图床的发布工具同理;只在确实要程序化建桶删桶时才用管理员档。
- 作用范围:可以指定 Token 只对某几个桶生效。给服务器 A 的备份 Token 就只授权
anexns-backup一个桶,它泄漏了也碰不到图床桶和其他数据。 - 有效期:Token 可以设置到期时间,短期调试用的凭据别给永久。
创建完成后页面会给出 Access Key ID 与 Secret Access Key,其中Secret Access Key 只显示一次,关掉页面就再也看不到,当场存进密码管理器。Token 的日常管理原则和普通 API Token 一样:一台服务器一把、一个用途一把,绝不共用;怀疑泄漏时先新建一把替换上线,再删旧的,轮换不断档;每隔一段时间去列表里清掉已经没人用的僵尸 Token。
排障
预签名链接打开报签名错误(SignatureDoesNotMatch)或 403。 按顺序查四点:生成链接的机器系统时间是否准确,签名对时钟偏差很敏感,服务器先对时;链接是不是拼在了自定义域名上——预签名只认 S3 API 端点;上传链接的 Content-Type 与实际请求头是否一致;用的密钥是否已被删除或轮换。
rclone 报 403 AccessDenied,连桶都列不出来。 多半是 Token 的作用范围不含这个桶,或者桶级授权下 rclone 在做桶探测——确认配置里有 no_check_bucket = true。如果连 rclone lsd r2: 都失败,先核对 endpoint 里的 account_id 和密钥有没有抄错、Token 是否选了对象读写以上权限。
自定义域名绑定后打不开,或证书报错。 先看桶设置里该域名的状态,没变成「已启用」之前访问不通是正常的,初始化通常要几分钟。再确认这个域名确实在同一个 Cloudflare 账户的 zone 里,跨账户的域名绑不上。状态正常仍报错的,检查有没有给这个子域名单独套过重定向或访问策略互相打架。
图明明换了,访客看到的还是旧图。 这是缓存的正常表现:同名覆盖上传后,边缘节点还存着旧版本。两个解法:发布流程里主动去控制台清一次该 URL 的缓存,或者更省心——图片文件名带版本号或哈希(如 cover-a1b2c3.jpg),每次更新换新名,天然绕开缓存。博客图床推荐后者。
r2.dev 访问偶尔 429。 限速触发了,这正是它不适合正式用途的信号,按第四节切自定义域名即可根治。
小结
回到开头四个问题,现在都有了落点:临时分享私有文件用预签名链接,有效期自己定、到期自动作废;服务器备份用 rclone 加定时脚本自动同步,桶端交给生命周期规则滚动清理;博客图床绑自定义域名公开读,吃缓存、不限速,r2.dev 只留给调试;所有凭据按桶、按用途拆分 Token,最小权限发放。
R2 的进阶用法,核心就是给每种数据选对访问方式:私有的用签名链接限时放行,要公开的用自定义域名大大方方分发,要长久留存的用生命周期规则自动归档。方式选对了,剩下的都是体力活,而体力活已经全部交给脚本和平台了。