cloud-r2pan 文档

Appearance

界面部署 ​

通过 Cloudflare 控制台点选创建资源，本地只需执行少量命令。全程约 10 分钟。

1. 安装依赖 & 登录 ​

bash
cd cloud-r2pan
npm install
npx wrangler login

浏览器会弹出 Cloudflare 授权页面，点击确认完成登录。

2. 在 Cloudflare 控制台创建资源 ​

打开 dash.cloudflare.com，确保已登录。

2.1 创建 R2 存储桶 ​

左侧菜单 → R2 → Create bucket

  • Bucket name：cloud-r2pan
  • Region：任意（离你近的）
  • 点击 Create bucket

2.2 创建 D1 数据库 ​

左侧菜单 → D1 → Create database

  • Database name：cloud-r2pan
  • Region：任意
  • 点击 Create database

注意

创建完会跳转到数据库详情页，复制页面顶部的 Database ID（UUID 格式），后面绑定要用。

2.3 创建 Worker ​

左侧菜单 → Workers & Pages → Create → Worker

  • Name：cloud-r2pan
  • 点击 Deploy

说明

此时 Worker 里还没有资源绑定，首次部署报 500 是正常的，绑完资源再发布一次即可。

3. 在 Worker 里绑定资源（核心步骤） ​

进入 Worker 详情页 → Settings → 左侧 Bindings → Add binding

3.1 绑定 R2 Bucket ​

  • Variable name：r2（固定值，代码里就叫这个，不要改）
  • Bucket：选择 cloud-r2pan

3.2 绑定 D1 Database ​

  • Variable name：db（固定值，不要改）
  • Database：选择 cloud-r2pan（或直接粘贴第 2.2 步的 Database ID）

4. 设置 Secret ​

同一 Worker → Settings → 左侧 Variables and Secrets → Add → 类型选 Secret

Variable nameValue必填
admin自定的管理后台初始登录密码（如 MyStr0ng!Pass），同时用作加密主密钥✅ 必须
totp_recovery任意字符串，2FA 万能恢复码（忘记验证码时救回账号）❌ 可选
turnstile_sitekey从 Cloudflare Turnstile 控制台申请，见 Turnstile❌ 可选
turnstile_secret从 Cloudflare Turnstile 控制台申请❌ 可选（不配则 Turnstile 整体不生效）

每添加一个 Secret 点击一次 Save。

登录密码与主密钥已分离

部署后建议进 管理后台 → 设置 → 🔑 登录密码 设置自己的面板密码。之后登录只认面板密码，admin 退化为纯加密主密钥，平时无需再动。

万一忘记面板密码：在 D1 控制台执行 DELETE FROM settings WHERE key = 'admin_password_hash'; 即可回退用 admin 登录。

5. 正式部署 ​

bash
npm run deploy

输出会显示上传进度和最终地址：

https://cloud-r2pan.<你的账号>.workers.dev

部署完成后，数据库会在首次访问时自动建表，不需要手动执行 SQL。

6. 验证 ​

浏览器打开：

https://cloud-r2pan.<你的账号>.workers.dev/admin

用第 4 步设置的 admin 密码登录，能进入管理后台即部署成功。

7. 本地开发（可选） ​

bash
echo 'admin=本地测试密码' > .dev.vars
npm run dev

访问 http://localhost:8787/admin。本地 R2 / D1 由 Miniflare 模拟，不会写入真实数据。