NGINX代理Docker部署的NodeJS应用时随机断开连接的问题

核心问题分析 #

直接访问Docker应用端口流式传输MP3正常，但经Nginx代理后随机断开，说明问题出在Nginx代理配置或全链路超时参数不匹配，无法支撑3小时级别的长流式连接。

调整Nginx代理配置 #

在现有配置基础上，补充/调整关键参数，确保全链路超时覆盖：

server {
    listen 80;
    server_name DOMAIN.COM;

    # 客户端侧超时，避免Nginx因等待客户端数据提前终止连接
    client_header_timeout 10800s;
    client_body_timeout 10800s;
    send_timeout 10800s;

    location / {
        client_max_body_size 4g;
        proxy_pass http://localhost:3888;
        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;

        proxy_buffering off;
        proxy_connect_timeout 10800s; # 统一调整为3小时
        proxy_send_timeout 10800s;    # 原配置为2小时，需与read_timeout匹配
        proxy_read_timeout 10800s;

        # 启用HTTP/1.1长连接，避免频繁建联导致中断
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_ignore_client_abort on; # 忽略客户端中断，保障流式传输完成
    }
}

参数说明 #

• client_header_timeout/client_body_timeout：设置Nginx等待客户端发送请求头/体的超时时间，避免客户端侧延迟触发连接断开
• send_timeout：Nginx向客户端发送响应的超时时间，确保长流式传输不会被中途终止
• proxy_http_version 1.1 + proxy_set_header Connection ""：启用HTTP/1.1并复用长连接，减少连接重建带来的中断风险
• proxy_ignore_client_abort on：即使客户端中途断开，Nginx仍会继续从后端获取数据，适配流式场景需求
• 所有超时参数统一设为10800s（3小时），确保全链路超时逻辑一致

Node.js/Express端配套调整 #

确保Express应用也配置足够长的超时，并正确设置流式响应头：

const express = require('express');
const app = express();

// 设置服务器超时为3小时
const server = app.listen(3888, () => {
  console.log('Server running on port 3888');
});
server.timeout = 10800000; // 10800秒，即3小时

// 流式音频接口示例
app.get('/stream-audio', (req, res) => {
  // 配置流式响应头
  res.setHeader('Content-Type', 'audio/mpeg');
  res.setHeader('Transfer-Encoding', 'chunked');
  res.setHeader('Cache-Control', 'no-cache'); // 禁用缓存，保障实时流式传输

  // 从GCS获取流并转发到响应（替换为你的实际GCS流式逻辑）
  const gcsStream = getGcsAudioStream();
  gcsStream.pipe(res);
});

额外排查点 #

1. 服务器防火墙/安全组：检查AWS Security Groups或服务器本地防火墙是否有TCP连接超时限制，确保允许3小时长连接
2. CDN/中间层（若有）：如果使用了CloudFront等CDN服务，需同步调整CDN的超时配置，避免中间层提前终止连接
3. Docker网络：确认Docker容器与Nginx之间的网络连接无额外超时限制，可检查Docker daemon相关配置

内容的提问来源于stack exchange，提问作者RUSSELL HARROWER