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 Explorer | wrangler dev 自带,适合看本地 D1/R2/KV |
| 线上资源配置 | Cloudflare Dashboard | 权限、计费、绑定、域名等还是它最完整 |
| 自动化部署 | Wrangler | CI/CD、migration、脚本化操作 |
| 高频查远程 D1/R2 | cf-studio 或类似桌面工具 | 适合每天要查数据的人 |
| 普通 SQL 数据库 | DbGate / DBeaver / TablePlus | PostgreSQL、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 搜索和批量编辑
- 导出备份检查器
- 生产数据只读浏览器
小工具比大而全更容易真的用起来。
继续阅读
这篇文档有问题?