n8n中如何设置自定义WEBHOOK_URL以触发工作流？

Question

在使用n8n时，如何设置自定义WEBHOOK_URL以触发工作流是一个常见的技术问题。默认情况下，n8n会为每个启用了Webhook的节点生成一个唯一的URL。但有时我们希望使用自定义域名或路径来接收外部请求。例如，将Webhook URL设置为`https://mydomain.com/webhook`，以便更好地集成到现有系统或满足安全要求。实现这一需求时，可能会遇到以下问题：如何正确配置n8n的反向代理（如Nginx或Apache）？如何确保自定义URL与n8n内部Webhook地址正确映射？此外，如果使用的是云部署环境，还需要注意负载均衡器和防火墙的设置。这些问题若处理不当，可能导致Webhook无法正常触发工作流。

Answer 1

1. 理解n8n默认Webhook机制

在n8n中，默认情况下，每个启用了Webhook的节点会生成一个唯一的URL。这个URL通常是基于n8n服务器的基础地址（如`http://localhost:5678/webhook/...`）。然而，在实际生产环境中，我们可能希望使用自定义域名或路径来接收外部请求。

• 默认Webhook URL格式：`http://:/webhook//`。
• 问题：如何将`https://mydomain.com/webhook`映射到n8n内部地址？

为了解决这一问题，我们需要引入反向代理配置，并确保自定义URL与n8n内部地址正确映射。

2. 配置反向代理（Nginx/Apache）

通过反向代理工具（如Nginx或Apache），我们可以将外部请求转发到n8n的内部Webhook地址。

2.1 使用Nginx配置自定义Webhook URL

server {
    listen 443 ssl;
    server_name mydomain.com;

    location /webhook {
        proxy_pass http://localhost:5678/webhook/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
    

上述配置将所有发送到`https://mydomain.com/webhook`的请求转发到`http://localhost:5678/webhook`。

2.2 使用Apache配置自定义Webhook URL

    ServerName mydomain.com

    ProxyPass /webhook http://localhost:5678/webhook
    ProxyPassReverse /webhook http://localhost:5678/webhook

    

Apache的配置方式类似，但需要启用`mod_proxy`模块。

3. 确保URL映射正确

在完成反向代理配置后，需要验证自定义URL是否能够正确触发n8n的工作流。

1. 启动n8n服务并检查其运行状态。
2. 在n8n中创建一个带有Webhook节点的工作流，并记录生成的Webhook URL。
3. 测试自定义URL（如`https://mydomain.com/webhook`）是否能触发工作流。

如果无法触发，请检查Nginx或Apache的日志文件，确认是否有错误信息。

4. 云部署环境的注意事项

在云环境中，除了反向代理配置外，还需要注意以下几点：

问题	解决方案
负载均衡器设置	确保负载均衡器将HTTPS流量转发到n8n实例的端口（如5678）。
防火墙规则	开放必要的端口（如80、443和5678），并限制非授权访问。

此外，还需检查DNS解析是否正确指向云服务器的IP地址。

5. 流程图：实现自定义Webhook URL的步骤

graph TD
            A[开始] --> B[配置反向代理(Nginx/Apache)]
            B --> C[验证反向代理是否生效]
            C --> D[确保n8n服务正常运行]
            D --> E[创建带Webhook节点的工作流]
            E --> F[测试自定义URL触发工作流]
            F --> G[检查云环境负载均衡和防火墙]
            G --> H[结束]