cloud-r2pan 文档

Appearance

命令部署 ​

全程使用 Wrangler CLI 完成，适合熟悉终端的用户。命令部署与界面部署效果完全一致。

1. 准备工作 ​

bash
# 登录 Cloudflare
npx wrangler login

# 安装项目依赖
cd cloud-r2pan
npm install

2. 创建基础资源 ​

2.1 创建 D1 数据库 ​

bash
npx wrangler d1 create cloud-r2pan

输出会包含 database_id（UUID 格式），复制它，填进 wrangler.jsonc 的 d1_databases 配置块。

2.2 创建 R2 存储桶 ​

bash
npx wrangler r2 bucket create cloud-r2pan

TIP

如果打算改用 S3 兼容存储或 WebDAV（见对象存储），这一步可以跳过。

3. 设置 Secret ​

bash
# 必须：管理后台初始密码 + 加密主密钥
npx wrangler secret put admin

# 可选：2FA 万能恢复码
npx wrangler secret put totp_recovery

# 可选：Turnstile 凭证
npx wrangler secret put turnstile_sitekey
npx wrangler secret put turnstile_secret

每条命令执行后按提示输入对应值。各 Secret 的用途详见变量与密钥。

4. 正式部署 ​

bash
npm run deploy

首次部署

首次部署时 Worker 尚未绑定资源，可能出现 500 报错，属于正常现象。确认 wrangler.jsonc 中的资源绑定无误后重新执行 npm run deploy 即可。

部署成功后：

  • D1 自动建表：首次访问时由程序幂等创建全部数据表并完成迁移，无需手动 SQL
  • Analytics Engine 自动创建：wrangler.jsonc 中声明的 r2pan_downloads 数据集会在首次写入时自动建立

5. 验证 ​

bash
# 实时查看线上日志，排查报错用
npm run tail

浏览器打开 https://cloud-r2pan.<你的账号>.workers.dev/admin，用 admin 密码登录。

6. 本地开发 ​

bash
echo 'admin=本地测试密码' > .dev.vars
npm run dev
  • wrangler dev 会自动创建本地 D1 和 R2 模拟实例
  • 本地默认使用 R2 模式（Miniflare 模拟），不写真实数据
  • 访问 http://localhost:8787/admin