n8n 使用nginx 在公网上部署,现在进入工作流一直连接已丢失!如何解决?

n8n 工作流界面持续显示 "Connection lost" 的核心原因是 Nginx 未正确配置 WebSocket 支持或 Origin 头验证失败 ,尤其在公网部署且使用非标准端口(如非 443/80)时,n8n 1.87+ 版本对 Origin 头的校验更严格,需显式设置 不带端口号的 Origin 值。以下是具体解决方案:


一、关键问题定位

1. WebSocket 连接未启用

n8n 工作流编辑器依赖 WebSocket 实时通信(如调试日志流),若 Nginx 未透传相关协议头,会导致连接中断。
典型错误表现:

  • 浏览器控制台报错 WebSocket connection to 'wss://...' failed。
  • 网络请求中显示 Invalid origin! 错误(常见于 n8n 1.87+ 版本)。

2. Origin 头校验失败(高发原因)

当公网访问域名包含非标准端口 (如 https://your-domain.com:8443)时:

  • n8n 会校验请求头中的 Origin 是否与配置的域名完全匹配 (不含端口号)。
  • 若 Nginx 未显式设置 Origin 头,或动态使用 $host(含端口),则校验失败。

二、Nginx 配置修正步骤

1. 基础 WebSocket 支持配置

在 Nginx 的 location / 块中必须包含以下指令:

复制代码
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
  • 作用:启用 WebSocket 协议升级,确保实时通信正常。
  • 错误配置后果:前端无法建立长连接,持续触发 "Connection lost"。

2. 关键:修复 Origin 头校验问题

场景:使用非标准端口(如 8443)访问

需硬编码 Host 和 Origin 头 ,禁止使用 $host 动态变量:

复制代码
proxy_set_header Host your-domain.com;          # 不带端口号
proxy_set_header Origin https://your-domain.com; # 必须为 HTTPS 且不带端口号
  • 为什么必须硬编码?
    n8n 1.87+ 版本会严格比对 Origin 与内部配置的域名(通过 N8N_HOST 环境变量定义),若请求中的 Origin 包含端口号(如 https://your-domain.com:8443),而 n8n 配置的域名不含端口,则校验失败。
  • 错误示例 :
    proxy_set_header Origin $scheme://$host; → 会携带端口号,导致校验失败。
场景:标准 HTTPS 端口(443)

仍需显式设置:

复制代码
proxy_set_header Host your-domain.com;
proxy_set_header Origin https://your-domain.com; # 不带端口号

三、完整 Nginx 配置示例

复制代码
server {
    listen 443 ssl http2;
    server_name your-domain.com; # 替换为实际域名

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:5678; # 指向 n8n 容器/服务地址
        proxy_set_header Host your-domain.com;          # 硬编码域名(无端口)
        proxy_set_header Origin https://your-domain.com; # 硬编码 HTTPS 域名(无端口)
        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;

        # WebSocket 必备配置
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

重点检查项:

  • Host 和 Origin 头必须不带端口号,即使实际通过非标准端口访问。
  • Origin 值必须与 n8n 的 N8N_HOST 环境变量完全一致 (例如 N8N_HOST=your-domain.com)。

四、其他必要验证

1. n8n 环境变量检查

确保以下环境变量已正确设置:

  • N8N_HOST=your-domain.com (不带协议和端口)
  • N8N_PROTOCOL=https
  • WEBHOOK_URL=https://your-domain.com/ (结尾必须带斜杠)

2. 服务端日志排查

若问题仍存在,检查 n8n 日志中的关键错误:

复制代码
docker logs n8n-container-name | grep -i "origin\|websocket"
  • 若出现 Origin header does NOT match,说明 Origin 头配置错误。
  • 若出现 WebSocket connection closed,需复查 Nginx 的 WebSocket 头配置。

五、常见误区

  1. 仅配置 proxy_set_header Host $host 不够 :
    $host 会携带端口号(如 your-domain.com:8443),而 n8n 要求 Origin 必须无端口。
  2. 误用 X-Forwarded-Port 替代 Origin :
    X-Forwarded-Port 仅用于协议识别,不影响 Origin 校验。
  3. 忽略 n8n 版本差异 :
    1.87 以下版本可能无需显式设置 Origin,但 1.87+ 版本必须严格匹配。

按上述配置修正后,WebSocket 连接将正常建立,工作流编辑器的 "Connection lost" 错误会消失。若仍存在问题,请优先检查 Origin 头值是否与 N8N_HOST 完全一致。

相关推荐
玫瑰互动GEO8 小时前
把GeoReady九维当工程项做:储能管理官网的AI就绪度改造笔记
人工智能·ai·ai搜索·seo优化·豆包·deepseek·geo优化
紧跟先前的步伐9 小时前
Go AI Agent 实战 08|HTTP 模型 API 的工作原理与请求流程
人工智能·http·ai·golang
GlobalInfo9 小时前
全球人工智能数据中心保险市场动态、发展趋势及项目可行性研究报告2026-2032
数据库·人工智能·ai·数据中心
cc_瀚海知行10 小时前
工具调用 6|助手什么时候该停下来?
java·服务器·前端·人工智能·python·ai
重生之高冷汉堡包10 小时前
2026 ChatGPT广告投放实操教程:从Ads Manager搭建到高转化闭环
人工智能·安全·ai·chatgpt·内容运营
AI Workforce10 小时前
数据质量:4 层去重 + 黑名单机制——宁可漏杀,不可错杀
大数据·人工智能·ai·架构·prompt
进击的雷神10 小时前
怕 AI Agent 乱删文件?Tank-OS 把它锁进不可变系统
人工智能·ai·api·agent
周永恒11 小时前
CODESYS AI实践 - 单元测试
ai·开源·测试·plc·codesys
变量棱镜12 小时前
ChatGPT 遭到起诉,被控伤害儿童和其他脆弱用户
gpt·ai·openai
鸽芷咕12 小时前
从环境搭建到敬礼动作:启元 Q1 SDK 全流程实战与 8 个实测坑排查手册
数据库·ai·机器人·sdk·启元q1