3987 字
20 分钟
R2 进阶应用:预签名链接、rclone 与博客图床

桶建好了、文件也传上去了,然后呢?

入门篇解决的是从零到一:开通、建桶、拿凭据、传上第一个文件。但真正把 R2 用进日常之后,冒出来的全是另一类问题,随便数数就有四个:

  1. 备份桶是私有的,里面有个大文件要临时发给别人下载。把桶改公开不合适,把自己的访问密钥发过去更离谱,有没有只给这一个文件、还带过期时间的办法?
  2. 服务器每天凌晨都会打出新的备份包,难道每次都要手动登录、手动上传?能不能让它自己同步上去,传完不用管?
  3. 博客的图片想直接放桶里当图床,怎么公开读最省事?控制台里那个 r2.dev 开关一键就能开,和绑自己的域名有什么区别?
  4. 备份一天一份往上堆,三个月后桶里躺着九十份全量包。旧的能不能自动删,别让它无声无息一直占着容量计费?

这四个问题,分别对应 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 环境装两个官方包:

Terminal window
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 就能推文件:

Terminal window
curl -X PUT --upload-file ./big-video.mp4 \
-H "Content-Type: video/mp4" \
"<上面生成的上传链接>"

如果只是临时给一个下载链接、不想专门写代码,AWS CLI 也能直接生成(需要先配好指向 R2 的凭据与端点):

Terminal window
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 = s3
provider = Cloudflare
access_key_id = 你的AccessKeyID
secret_access_key = 你的SecretAccessKey
region = auto
endpoint = https://<account_id>.r2.cloudflarestorage.com
acl = private
no_check_bucket = true

最后一项 no_check_bucket = true 值得单独说:如果你的 Token 只给了某个桶的对象读写权限(第六节推荐的最小权限配法),rclone 默认在操作前会尝试探测、甚至创建桶,权限不够就会报错。加上这一项,它跳过桶级探测,直接按对象操作,正好和桶级授权的 Token 严丝合缝。

配完先验证连通性:

Terminal window
rclone lsd r2: # 列出账户下能看到的桶
rclone ls r2:anexns-backup # 列出桶内对象(带大小)

copy 与 sync 的分工#

日常命令就两个,分工必须分清:

Terminal window
# 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 bash
set -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 site
mysqldump --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 点跑:

Terminal window
chmod +x /usr/local/bin/backup-to-r2.sh
crontab -e
# 加入一行:
# 0 3 * * * /usr/local/bin/backup-to-r2.sh

同步类任务最怕「命令没报错,但文件其实没传全」。rclone 自带校验命令,拿不准时跑一次,它会逐个比对两端文件的大小与哈希,给出差异清单,定时任务里也可以接在 copy 后面当验收环节:

Terminal window
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/图片键名 就能访问桶里的对象,全程不用自己碰证书和回源配置。

WARNING

r2.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 的进阶用法,核心就是给每种数据选对访问方式:私有的用签名链接限时放行,要公开的用自定义域名大大方方分发,要长久留存的用生命周期规则自动归档。方式选对了,剩下的都是体力活,而体力活已经全部交给脚本和平台了。

R2 进阶应用:预签名链接、rclone 与博客图床
https://www.anexns.cloudns.org/posts/cloudflare-r2-advanced/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0