SuperAPI AI 工具集

n8n-impl-webhooks

部署与运维

查看项目

更新于 10-26 08:07

技能介绍

n8n Webhook 实现技能用于在 n8n 工作流中配置 Webhook 端点,核心是避免在生产环境中误用测试 URL。

用途 该技能面向 n8n 工作流的 Webhook 触发配置、测试与生产部署,以及对外部服务集成时的 URL、认证和响应处理进行规范。

主要能力

  • 区分测试 URL(<base>/webhook-test/<path>)与生产 URL(<base>/webhook/<path>),说明各自激活条件、结果显示位置与适用场景。
  • 提醒在反向代理后设置 WEBHOOK_URL,避免生成外部不可达的内部主机名地址。
  • 提供响应模式的决策树:Immediately、When Last Node Finishes、Streaming、Using 'Respond to Webhook' Node,并列出 Last Node 的响应数据选项。
  • 提供认证方式选择:None、Basic Auth、Header Auth、JWT Auth,按调用方类型选择。
  • 说明路径配置使用小写连字符和 :param 动态参数语法,以及后续节点中访问参数的方式。
  • 列出 HTTP 方法适用场景,并建议接收负载数据时使用 POST,敏感数据避免使用 GET。
  • 列出附加选项:Binary Data、IP Whitelist、CORS、Ignore Bots、Raw Body、Response Headers、Response Code。
  • 说明 Respond to Webhook 节点的 8 种响应类型、配置要求与关键行为规则(如仅执行一次、多个节点只有第一个执行、被跳过时返回 200、执行前错误返回 500、v1.103.0 起 HTML 响应包在 sandbox iframe 中)。
  • 描述 Webhook 生命周期:创建、配置、测试、激活、停用,以及用 curl -I 验证注册。
  • 列出 Webhook 相关环境变量及默认值,包括 N8N_ENDPOINT_WEBHOOK、N8N_ENDPOINT_WEBHOOK_TEST、N8N_ENDPOINT_WEBHOOK_WAIT、N8N_PAYLOAD_SIZE_MAX(默认 16MB)、N8N_FORMDATA_FILE_SIZE_MAX、N8N_DISABLE_PRODUCTION_MAIN_PROCESS。
  • 说明二进制数据接收需启用 Binary Data,并通过 $binary 访问。
  • 说明 CORS 默认 *,生产应限制域名;IP 白名单为逗号分隔,未列入返回 403。
  • 说明队列模式下主实例接收 Webhook、Worker 执行工作流,高流量可使用专用 webhook 处理器。

使用方式 在 Claude 或相关 AI 助手环境中加载该技能包后,配置 n8n Webhook 节点时按其指引选择路径、HTTP 方法、认证与响应模式,并参考附带的 methods.md、examples.md、anti-patterns.md 文件。

适用场景 适用于 n8n 工作流的 Webhook 开发、测试、生产部署、反向代理配置、外部服务集成、文件上传接收及多实例队列部署。

限制 资料未提供该技能的安装命令、具体价格或平台要求,暂未提供。