00 / 00

Cloudflare 资源管理

D1、R2、KV、Dashboard、Wrangler、Local Explorer 和桌面工具怎么搭配使用。

用 Cloudflare 做小产品,很快会遇到一个实际问题:D1、R2、KV 这些资源怎么管。

Dashboard 能看,Wrangler 能操作,但日常开发时你经常只是想确认一条数据、一个对象、一个 KV 值是不是写对了。工具选错,会让你在很小的事情上浪费很多时间。

先理解三类资源

资源适合存什么常见用途
D1结构化数据用户、订单、文章、配置记录
R2文件和对象图片、导出包、上传文件、下载资源
KV轻量键值缓存、短期状态、功能开关、临时 token

个人项目第一版通常 D1 + R2 就够了。KV 不要为了用而用。

工具怎么选

场景推荐工具说明
本地开发看数据Local Explorerwrangler dev 自带,适合看本地 D1/R2/KV
线上资源配置Cloudflare Dashboard权限、计费、绑定、域名等还是它最完整
自动化部署WranglerCI/CD、migration、脚本化操作
高频查远程 D1/R2cf-studio 或类似桌面工具适合每天要查数据的人
普通 SQL 数据库DbGate / DBeaver / TablePlusPostgreSQL、MySQL、SQLite 这类更适合专业数据库客户端

Local Explorer 最该先用

Local Explorer 是 Wrangler 本地开发时自带的数据查看器。

启动:

npx wrangler dev

终端里按 e,或者打开:

http://localhost:8787/cdn-cgi/explorer

它适合:

  • 检查 Worker 是否真的写入了 D1
  • 给本地 D1 插几条测试数据
  • 看 R2 本地 bucket 里有没有文件
  • 检查 KV JSON 格式

注意:Local Explorer 看的是本地模拟数据,不是线上数据。

Dashboard 管线上配置

线上资源不要完全绕开 Dashboard。

这些事情最好在 Dashboard 里确认:

  • D1 / R2 / KV 是否真的创建成功
  • Worker 绑定是否正确
  • 域名和 Route 是否生效
  • R2 是否配置了公开访问或自定义域名
  • 计费、权限、日志和告警

如果国内打开慢,可以把 Dashboard 安装成 PWA,至少切换起来更方便。

Wrangler 负责自动化

凡是需要可重复执行的动作,尽量写进命令或脚本。

比如 D1 migration:

npx wrangler d1 migrations apply DB --local
npx wrangler d1 migrations apply DB --remote

再比如查看远程 D1:

npx wrangler d1 execute DB --remote --command "select * from users limit 10"

Dashboard 适合人工确认,Wrangler 适合重复执行。

桌面工具适合高频查询

如果你每天都要看远程 D1 表、翻 R2 文件列表、下载对象,Dashboard 会显得太重。

这时可以考虑 cf-studio 或类似桌面工具。它们通常通过 Wrangler 登录信息或 Cloudflare API 访问远程资源。

适合:

  • 经常查生产数据
  • 经常上传下载 R2 文件
  • 不想每次都打开 Dashboard
  • 愿意承担第三方工具的安全评估

使用前要确认:

  • 它读取哪些本地凭据
  • 是否开源
  • 是否只调用 Cloudflare 官方 API
  • 是否会保存你的 token

不要做一个过大的管理器

如果你想自己做工具,不要一上来就做「Cloudflare 管理器」。

更好的切入点是一个具体痛点:

  • R2 图床,上传图片后返回 Markdown 链接
  • D1 本地/远程数据对比
  • KV JSON 搜索和批量编辑
  • 导出备份检查器
  • 生产数据只读浏览器

小工具比大而全更容易真的用起来。

继续阅读

这篇文档有问题?