Localflare：适用于 Cloudflare Workers 的实用本地仪表盘

是否厌倦了在没有可视界面的情况下调试 Cloudflare Workers？Localflare 通过为您提供 实时、零配置仪表盘，解决了这一痛点，让您无论是 D1 数据库、KV 命名空间还是 R2 桶，一切皆可在 Workers 内实时可视，同时代码保持不变。

Localflare 是什么？

Localflare 是一款 CLI 工具，它会在本地启动一个 Worker，并配合轻量级的 API Worker。该 API 通过 studio.localflare.dev 公开一个直观的 React 仪表盘。当您的 Worker 在 http://localhost:8787 上运行时，仪表盘会自动发现您的 wrangler.toml，在 __localflare/* 上生成 API，并提供一键式交互：

• D1 数据库工作室 – 完整的 SQL 编辑器、行内编辑、大批量操作、虚拟数据生成。
• KV 浏览器 – 查看、编辑、删除键值对。
• R2 文件管理器 – 上传、下载并管理文件。
• 队列检查器 – 发送测试消息并查看队列状态。
• Durable Objects – 检查实例状态并发送请求。
• 服务绑定 – 自动代理。

无需 SDK，也不需要修改代码——只需在项目文件夹中运行 localflare。

快速入门指南

1. 前往您的 Workers 项目：

   cd /path/to/your-worker
   

2. 全局安装 Localflare（也可直接使用 npx）：

   npm i -g localflare
   # or
   pnpm add -g localflare
   

3. 运行 Localflare：

   localflare
   

   Localflare 将：
4. 读取您的 wrangler.toml
5. 在 http://localhost:8787 启动您的 worker
6. 打开仪表盘 https://studio.localflare.dev

如果您只想使用命令行（不自动打开浏览器），请使用：

localflare --no-open

自定义端口

localflare --port 9000

直接传递 Wrangler 选项

想在特定环境下运行或设置环境变量？可以使用 -- 将参数转发：

localflare -- --env staging
localflare -- --var API_KEY:secret

localflare --port 9000 -- --env production --remote

连接模式——适用于 Next.js、Remix 或其他框架

当您的开发堆栈启动一个独立服务器（例如 pnpm dev）时，Localflare 可以 attach 到该进程，保持绑定共享。

1. 终端 1 – 运行您的开发服务器

   pnpm dev   # or opennext dev, nuxt dev, etc.
   

2. 终端 2 – 启动 Localflare API

   localflare attach
   

API 将在 http://localhost:8788 监听。您也可以更改 API 端口：

localflare attach --port 9000

浏览器排障

现代浏览器有时会阻止 studio.localflare.dev 与 localhost:8787 的连接。以下是解除阻止的方法：

Chrome / Chromium – 在网站信息对话框中启用 本地网络访问，然后刷新。

Safari / Brave – 安装 mkcert，生成本地 CA，重启浏览器。

Brave 的替代方案 – 为 studio.localflare.dev 关闭 Shields。

支持的绑定一览

上述所有功能均开箱即用，无需任何配置。

为什么选择 Localflare？

• 零配置 – 自动读取 wrangler.toml。
• 真实绑定 – 无需模拟，数据来自真实开发环境。
• 跨框架 – 兼容 Next.js、Remix、Nuxt、Astro、SvelteKit 以及纯 Workers。
• 开发者友好 – 行内编辑、虚拟数据生成、SQL 编辑器、拖拽上传。
• 开源 – MIT 许可证，由社区驱动。考虑赞助以维系项目。

获取帮助与贡献

• 文档：https://github.com/rohanprasadofficial/localflare
• GitHub 问题：提交错误或功能请求。
• 赞助：https://buy.stripe.com/9AQ8e7l6f2aG4g6gII（可选但受欢迎）

结论

Localflare 消除了 Workers 开发中的主要阻力：您现在可以在本地运行代码的同时，检查、编辑并测试所有绑定资源。它搭建快速、功能丰富，非常适合所有搭建 Cloudflare Workers 的开发者。

准备尝试吗？克隆仓库，安装 CLI，观看本地仪表盘在几秒内生效。祝编码愉快！