hookdeck-cli
免费、永久的事件转发隧道,替代 ngrok,用于本地开发和测试。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:hookdeck-cli。 它的用途是:免费、永久的事件转发隧道,替代 ngrok,用于本地开发和测试。 完整的 Skill 内容见:https://321skill.com/skills/hookdeck-cli/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我需要测试一个接收 Stripe 支付 Webhook 的本地服务,帮我用 Hookdeck CLI 创建一个转发隧道。” 它会引导你安装 Hookdeck CLI,并通过 `hookdeck listen -p 3000` 命令生成一个公共 URL。你将这个 URL 配置到 Stripe 的 Webhook 设置中,所有支付事件就会安全地转发到你的本地 `localhost:3000` 服务端进行调试和验证。
介绍
Hookdeck CLI 是一款专为开发者设计的命令行工具,核心解决了在本地开发环境中接收和测试外部事件(如 Webhook)的难题。传统方法(如 ngrok)通常有会话限制或收费,而 Hookdeck CLI 提供了免费、永久的事件转发 URL,能将外部请求无缝转发到你的本地服务器。
使用非常简单,安装后通过 hookdeck listen 命令即可创建一个公开的 URL,并将其映射到你的本地服务端口。所有经过该 URL 的事件都会被记录在 Hookdeck 的事件历史中,支持查看、重放和团队协作,极大方便了 Webhook 集成、API 回调等场景的开发和调试。
它非常适合后端开发、全栈开发和运维工程师,尤其是在开发涉及支付回调、第三方服务通知、IoT 设备上报等需要接收外部请求的应用时。产品经理和测试工程师也可以利用它来模拟和验证外部事件流。
建议在开始前先通过 hookdeck login 登录账户以同步事件历史。对于需要跳过 SSL 验证或禁用健康检查的特殊本地环境,可以使用相应的标志。注意,虽然 CLI 本身免费,但部分高级功能(如生产环境下的高并发)属于其付费平台服务。
核心特点
与 ngrok 等工具相比,Hookdeck CLI 提供真正免费且永久的事件转发 URL,并完整保留了事件历史供团队查看和重放,同时原生集成了事件过滤、分发等生产级功能,便于从开发平滑过渡到上线。
注意事项
不适合需要极高网络吞吐量或超低延迟的生产环境实时流量转发。
常见问题
Hookdeck CLI 是免费的吗?
用于本地开发和测试是完全免费的,其付费部分主要针对生产环境的高阶功能和服务。
它和 ngrok 有什么区别?
核心区别在于提供永久免费的转发隧道、完整的事件历史管理,并集成了事件网关的管理能力,更适合团队协作和从开发到生产的流程。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/hookdeck-cli/raw/index.md 读取 hookdeck-cli 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/hookdeck-cli/raw/index.md(查看排版版本)