r2 ☁️

使用rclone管理Cloudflare R2存储。

安装

bash
curl -fsSL https://rclone.org/install.sh | sudo bash

所需凭证

在仪表盘中以以下JSON格式设置R2_CONFIG：

json
{
accesskeyid: YOURACCESSKEY_ID,
secretaccesskey: YOURSECRETACCESS_KEY,
endpoint: https://YOURACCOUNTID.r2.cloudflarestorage.com,
bucket: your-bucket-name
}

从Cloudflare获取凭证：

1. 1. 访问 https://dash.cloudflare.com → R2
2. 创建具有对象读取/写入/列表权限的API令牌
3. 复制账户ID（来自R2仪表盘URL）
4. 端点格式：https://.r2.cloudflarestorage.com

设置

bash

快速设置

或交互式运行：
bash
./skills/r2/scripts/setup.sh

命令

上传

bash
r2-upload /path/to/file.txt # 上传单个文件
r2-upload /path/to/folder/ # 上传文件夹内容
r2-upload /path/to/file.txt --bucket other-bucket # 上传到指定存储桶

下载

bash
r2-download file.txt /local/path/ # 下载单个文件
r2-download folder/ /local/ # 下载文件夹
r2-download file.txt # 下载到当前目录

列出

bash
r2-ls # 列出存储桶内容
r2-ls my-bucket # 列出指定存储桶
r2-ls --long # 长格式显示（含大小）

同步（单向）

bash
r2-sync /local/folder/ r2:bucket/ # 本地 → R2
r2-sync r2:bucket/ /local/folder/ # R2 → 本地
r2-sync /local/ r2:bucket/ --delete # 镜像（删除目标端多余文件）

删除

bash
r2-rm file.txt # 删除单个文件
r2-rm folder/ # 删除文件夹内容
r2-purge my-bucket # 删除存储桶中所有文件

显示凭证

bash
./skills/r2/scripts/show-creds.sh # 人类可读格式
./skills/r2/scripts/show-creds.sh --raw # JSON格式（供UI使用）

直接rclone命令

bash

复制文件

同步并显示进度

检查磁盘使用情况

配置位置

• - 环境配置：~/.config/r2/config.json（或仪表盘中的R2_CONFIG）
• rclone配置：~/.config/rclone/rclone.conf
• 命名远程：r2

故障排除

403访问被拒绝

• - 对象读取 ✅
• 对象写入 ✅
• 对象列表 ✅

存储桶未找到