嘿，朋友，我是 N8N大学 的首席主编。如果你正在盯着 n8n 那个红色的报错提示，看着 connection refused 这几个字眼发愁，别慌，这几乎是每个玩 n8n 自定义 Webhook 的兄弟都会遇到的“入门坎”。
今天，笔者就不整那些虚头巴脑的理论，直接带你从网络底层到 n8n 配置，把这个问题彻底盘明白。读完这篇，你不仅能解决当前的问题，以后遇到类似情况也能一眼看穿。
问题复现：你是在哪一步被“拒之门外”的？
通常，当你在 n8n 工作流中配置好 Webhook 节点，兴冲冲地用 Postman 或者浏览器发起请求时，如果看到以下几种情况之一：
- 浏览器显示
ERR_CONNECTION_REFUSED - Postman 报错
Error: connect ECONNREFUSED - n8n 后台日志里没有任何请求记录
这就说明，你的请求根本就没进到 n8n 的“大门”。在 n8n 的世界里，Webhook 节点就像是一个守在门口的接待员。如果 connection refused 出现，意味着你的请求在敲门之前，门就已经锁死了，或者你敲错了门。
原因分析：为什么会被拒绝？
用大白话说，connection refused 的本质是“TCP 连接拒绝”。这通常不是 n8n 软件本身的 Bug，而是网络层面的“路障”。主要有以下三个核心原因：
- 端口没开/没监听： n8n 默认运行在 5678 端口。如果你的 Docker 容器没映射这个端口，或者云服务器的安全组/防火墙把 5678 挡住了，请求自然会被拒绝。
- IP 地址搞错了： 这是最常见的坑。如果你在 Docker 里运行 n8n，却用
localhost或127.0.0.1去请求，那是在请求容器内部，而不是宿主机。 - URL 路径不匹配： n8n 的 Webhook 节点生成的 URL 是唯一的。如果你请求的路径少了一个字符，n8n 直接忽略，看起来就像连接被拒绝一样（虽然严格来说是 404，但在某些配置下会表现为连接失败）。
解决方案：三步排查法，从简到繁
别急着改代码，跟着 N8N大学 的步骤一步步来。
第一步：检查网络连通性（基础网络排查）
首先，我们要确认网络通不通。假设你的 n8n 运行在 IP 为 192.168.1.100 的机器上，端口是 5678。
在你的电脑终端（CMD 或 Terminal）运行：
telnet 192.168.1.100 5678或者使用更现代的工具：
nc -zv 192.168.1.100 5678- 如果连接成功： 你会看到
Connected to ...或succeeded!。这说明网络没问题，问题在 n8n 配置或 URL 上。 - 如果连接失败： 提示
Connection refused或超时。请继续往下看。
第二步：解决 Docker 环境下的“内外不通”
这是大多数新手的痛点。如果你的 n8n 跑在 Docker 里，必须确保端口正确映射。
检查你的 docker run 命令或 docker-compose.yml 文件：
docker run -it --rm
--name n8n
-p 5678:5678
docker.n8n.io/n8nio/n8n注意这里的 -p 5678:5678。前面的 5678 是宿主机端口，后面的是容器内端口。如果没写这个映射，容器内部虽然运行着 n8n，但宿主机外部无法访问。
云服务器特别提醒： 如果你在阿里云、腾讯云、AWS 等云服务器上部署，除了 Docker 映射，还必须在安全组（Security Group）中放行 5678 入站规则。否则，云厂商的防火墙会在你的 Docker 防火墙之前就把请求拦截了。
第三步：修正 n8n Webhook 节点的配置
网络通了，接下来就是 n8n 内部的事了。在 n8n 编辑器中：
- 选中你的 Webhook 节点。
- 查看右侧的 Webhook URL。它通常长这样：
http://localhost:5678/webhook/你的路径。 - 关键点： 如果 n8n 部署在远程服务器，
localhost必须换成服务器的公网 IP 或域名。
修改后的 URL 应该是：http://192.168.1.100:5678/webhook/你的路径。
笔者建议：在 n8n 的 Settings -> Public URL 中设置好你的公网地址，这样生成的 Webhook URL 才是正确的。
避坑指南：那些容易忽略的细节
解决了基础连接问题，这里还有两个“隐形杀手”：
1. 路径的严格匹配
n8n 的 Webhook 节点对路径非常敏感。如果你的 Webhook 节点设置的是 /webhook/test，而你请求的 URL 是 /webhook/test/（多了一个斜杠）或者 /webhook/test1，n8n 都会拒绝处理。
技巧： 直接点击 n8n Webhook 节点上的 Copy Webhook URL 按钮，不要手动输入。
2. 本地调试的“回环”陷阱
如果你在本地电脑运行 n8n（非 Docker），用 Postman 调用 http://localhost:5678/webhook/xxx 没问题。但如果你把 n8n 扔到服务器上，还在本机用 localhost 去请求，那肯定不通。
更隐蔽的是：如果你在 n8n 的 HTTP Request 节点里去请求同一个 n8n 实例的 Webhook，绝对不能用 localhost！必须用容器内网 IP（如 Docker 的网桥 IP）或宿主机 IP。
FAQ 问答
Q1: 为什么我用浏览器打开 Webhook URL 会显示 "Method Not Allowed"？
A: 这通常不是 connection refused，而是 HTTP 方法错误。Webhook 默认接收 POST 请求。如果你用浏览器直接访问（GET 请求），n8n 会返回 405 或 404。请使用 Postman 或 curl 发送 POST 请求测试。
Q2: Docker 容器内部端口是 80，映射出来是 5678，怎么配？
A: n8n 官方镜像默认内部端口是 5678。如果你修改了内部端口（通过环境变量 N8N_PORT），请确保映射一致。例如内部是 80，映射 -p 5678:80，此时外部访问仍用 5678 端口。
Q3: 我配置了 HTTPS，但 Webhook 还是报错，怎么办？
A: 如果你使用了反向代理（如 Nginx）配置 HTTPS，确保 n8n 的 Public URL 设置为 https://...。同时检查反向代理是否正确将请求转发到了 n8n 的 5678 端口。如果反向代理配置错误，也会导致连接拒绝。
总结与资源
遇到 n8n webhook 报 connection refused，核心思路就是：**检查 IP -> 检查端口 -> 检查路径**。90% 的问题都出在 Docker 端口映射和云服务器安全组设置上。
在 N8N大学，我们坚持认为：自动化不仅仅是连接工具，更是连接思维。搞懂了底层的网络逻辑，你才能在复杂的业务场景中游刃有余。
如果你还有其他 n8n 的疑难杂症，欢迎在 N8N大学 (n8ndx.com) 查找更多实战教程，或者在评论区留言，笔者会亲自解答。
