本地资源浏览器是一个基于浏览器的界面,用于在开发期间查看和编辑本地绑定中的数据。它可在本地开发服务器的 /cdn-cgi/explorer 路径访问。
无需运行 CLI 命令或编写临时代码来检查本地状态,您可以在浏览器中打开本地资源浏览器并直接操作数据。这在需要填充测试数据、验证 Worker 写入的内容、调试 Workflow 运行,或对本地 D1 数据库运行临时 SQL 查询时很有用。
本地资源浏览器同时支持 Wrangler 和 Cloudflare Vite 插件。
- Wrangler 4.82.1 或更高版本,或最新 Cloudflare Vite 插件(1.32.0+)
- 启动本地开发会话:
npx wrangler devyarn wrangler devpnpm wrangler dev- 在终端中按
e在浏览器中打开本地资源浏览器。您也可以直接导航到 Worker 路由和端口上的/cdn-cgi/explorer。
本地资源浏览器默认可用,并会自动检测 Wrangler 配置 中定义的绑定。
本地资源浏览器支持以下绑定类型:
| 绑定 | 查看 | 编辑 |
|---|---|---|
| KV | 浏览键、查看值和元数据 | 创建、更新和删除键值对 |
| R2 | 列出对象、查看元数据 | 上传和删除对象 |
| D1 | 浏览表和行、运行 SQL 查询 | 通过 SQL 插入、更新和删除行 |
| Durable Objects (SQLite storage) | 浏览 SQLite 表和行、运行 SQL 查询 | 通过 SQL 插入、更新和删除行 |
| Workflows | 列出实例、查看状态和步骤历史 | 触发新运行、重试失败的实例 |
对于 D1 数据库和使用 SQLite storage API 的 Durable Objects,本地资源浏览器包含 SQL studio。这与 Cloudflare 仪表板中为已部署 D1 数据库提供的体验相同。它提供可视化表浏览器(支持内联编辑)和 SQL 查询编辑器,可运行任意查询。
本地资源浏览器在 /cdn-cgi/explorer/api 暴露 API,以编程方式提供与浏览器界面相同的操作。该 API 提供 OpenAPI 规范 ↗,描述所有可用端点、参数和响应格式。
获取 OpenAPI 规范:
curl http://localhost:8787/cdn-cgi/explorer/api/cdn-cgi/explorer/api 上的 OpenAPI 规范允许 AI 编码代理和其他工具以编程方式发现并交互您的本地绑定。代理可以获取规范、了解有哪些可用资源,并调用 API 读取或修改本地数据,而无需手动设置。
当您希望代理执行以下操作时,这可以作为 CLI 的替代方案:
- 在本地 KV 命名空间或 D1 数据库中填充测试数据
- 在调试期间检查 Durable Object 的状态
- 使用不同输入数据触发或重试 Workflow 运行
- 将测试文件上传到本地 R2 存储桶