Public Webhook Relay(公共Webhook中继)

该工作流通过公用Webhook接收接口,实现外部POST请求的自动转发到本地流程。它定时轮询检测新请求,自动管理授权令牌和请求状态,确保数据可靠传递。用户无需搭建公网服务器,即可在本地环境中安全接收和处理Webhook通知,适用于开发、测试和数据转发等多种场景,显著提高工作效率并降低技术门槛。

流程图
Public Webhook Relay(公共Webhook中继) 工作流程图

工作流名称

Public Webhook Relay(公共Webhook中继)

主要功能和亮点

该工作流通过 webhook.site 提供的公用Webhook接收接口,实现将外部POST请求自动转发到本地n8n工作流,支持定时轮询检查新请求,自动管理访问令牌和请求状态,确保请求数据可靠传递。

  • 自动获取并存储授权令牌
  • 定时(默认每10秒)轮询检测新Webhook请求
  • 过滤未处理的POST请求,避免重复处理
  • 将请求内容原封不动转发至本地指定Webhook地址
  • 支持本地持久化存储(基于社区Key-Value存储节点)
  • 完整的流程可视化,便于调试和扩展

解决的核心问题

解决本地环境难以直接暴露公网Webhook接口的问题,通过利用 webhook.site 作为公网入口,实现外部请求的安全中继和转发,免去复杂的公网服务器部署和安全配置,提升开发和测试效率。

应用场景

  • 本地开发环境或私有内网中,需要接收外部Webhook通知的场景
  • 测试第三方服务发送的Webhook数据,无需搭建公网服务器
  • 快速搭建Webhook中继服务,集成到现有n8n自动化流程
  • 企业内网系统对外接口调试及数据转发

主要流程步骤

  1. Schedule Trigger 定时触发,默认每10秒启动一次流程
  2. 读取本地存储的授权令牌,判断是否存在
  3. 若无令牌,调用 webhook.site 接口获取新令牌并存储
  4. 使用令牌查询 webhook.site 上的最新请求数据
  5. 过滤出未处理的POST请求(根据时间戳和请求方法筛选)
  6. 将筛选的请求数据合并处理
  7. 记录最新处理的请求时间用于下次过滤
  8. 通过HTTP POST方式,将请求内容转发到本地设置的Webhook地址
  9. 完成数据中继,等待下一轮轮询

涉及的系统或服务

  • webhook.site:作为公网Webhook接收和存储服务
  • n8n社区Key-Value存储节点(@horka.tv/n8n-nodes-storage-kv):用于本地持久化存储授权令牌和最后处理时间
  • n8n HTTP Request节点:实现对webhook.site接口调用及请求转发
  • 本地n8n工作流Webhook接口

适用人群或使用价值

  • 自动化开发者和测试工程师:无需公网环境即可接收和测试外部Webhook请求
  • 企业内部开发团队:安全可靠地实现内网Webhook数据转发,减少公网暴露风险
  • 需要快速搭建Webhook中继的用户:通过本工作流快速完成配置,降低技术门槛
  • 想要整合外部Webhook数据到本地n8n流程的使用者

此工作流以简洁高效的方式解决了本地环境Webhook接收的难题,利用 webhook.site 实现安全中继,配合本地存储确保数据准确管理,适合多种自动化和测试场景,极大提升工作效率。