Server-Sent Events（SSE）是一种轻量级的服务器向客户端实时推送数据的技术，广泛应用于消息通知、实时日志、状态更新等场景。很多开发者在使用Nginx Proxy Manager（以下简称NPM）反向代理SSE服务时，会遇到事件延迟、推送中断甚至完全不推送的问题。

这并非NPM不支持SSE，而是其默认开启的缓冲（buffering）机制与SSE的实时性需求冲突，只需手动调整Nginx配置，即可完美解决该问题。

本文将从原理出发，一步步教你完成NPM的SSE支持配置，同时补充后端需配合的设置，确保SSE服务稳定、实时推送。

一、为什么默认配置SSE无效？

要解决问题，首先要明白问题根源。SSE的正常运行依赖三个核心条件，而NPM的默认配置恰好会破坏这些条件：

  1. 依赖HTTP/1.1长连接：SSE是基于单条HTTP长连接实现的，客户端与服务器建立连接后会持续保持，服务器有数据时直接通过该连接推送，无需客户端反复请求；而HTTP/1.0不支持长连接，会导致连接频繁断开。

  2. 数据需实时发送：SSE的核心价值是“实时性”，服务器产生数据后需立即推送给客户端，不能有延迟。

  3. 禁止缓存和缓冲：这是最关键的一点，NPM默认开启缓冲（buffering）和缓存（cache）机制，会先将服务器返回的数据积累在缓冲区，等缓冲区满了才一次性推送给客户端，这就彻底破坏了SSE的实时性，导致事件延迟甚至不推送。

简单来说：NPM的默认配置是为“普通HTTP请求”优化的（追求传输效率），而SSE需要“无缓冲、长连接、实时推送”的特殊配置，因此需要我们手动调整。

二、在NPM中配置SSE支持

以下是完整的配置流程，适用于所有基于NPM反向代理的SSE服务（如Node.js、Python、Java等后端实现的SSE）。

步骤1：进入NPM的自定义Nginx配置页面

  1. 登录Nginx Proxy Manager后台

  2. 在菜单栏找到「Proxy Hosts」

  3. 点击该代理主机右侧的「Edit」（编辑）按钮； 编辑入口

  4. 在弹出的编辑窗口中，切换到「Custom Nginx Configuration」（自定义nginx）选项卡入口； 配置nginx入口

  5. 找到「Custom Nginx Configuration」（自定义Nginx配置）输入框，拷贝下面的配置代码，粘贴进去即可。

proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_buffering off;
proxy_cache off;
chunked_transfer_encoding off;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
add_header X-Accel-Buffering no;

步骤3：保存配置并生效

粘贴完成后，点击编辑窗口底部的「Save」（保存）按钮，NPM会自动重载Nginx配置，无需手动重启Nginx服务。

至此，NPM的SSE支持配置已完成！

三、后端服务需配合设置响应头

NPM配置完成后，必须确保你的后端SSE服务返回以下3个响应头，否则SSE仍可能无法正常工作（这是很多开发者容易忽略的点）。

后端需返回的核心响应头：

Content-Type: text/event-stream
Cache-Control: no-cache
Connection: keep-alive

各响应头作用说明

  1. Content-Type: text/event-stream：告诉客户端，当前连接是SSE连接，客户端会按照SSE协议解析数据（这是SSE的标志性响应头，缺少则客户端无法识别）；
  2. Cache-Control: no-cache：禁止客户端缓存SSE数据，确保每次收到的都是实时数据；
  3. Connection: keep-alive：明确告诉客户端和NPM，保持该HTTP长连接，不要主动断开。

后端示例（以Node.js为例）

如果你的后端是Node.js（Express框架），实现SSE时添加响应头的示例代码如下：

app.get('/sse', (req, res) => {
  // 必须设置的3个响应头
  res.setHeader('Content-Type', 'text/event-stream');
  res.setHeader('Cache-Control', 'no-cache');
  res.setHeader('Connection', 'keep-alive');
  // SSE推送逻辑（示例：每秒推送一次当前时间）
  setInterval(() => {
    // 按照SSE协议格式发送数据（data: 开头，两个换行结尾）
    res.write(`data: ${new Date().toLocaleString()}\n\n`);
  }, 1000);
});

最后可以在浏览器的开发者工具中查看网络请求，确认响应头是否正确返回，并观察SSE事件是否实时推送。

eventstream验证

四、总结

Nginx Proxy Manager支持SSE服务的核心，关闭缓冲、开启长连接、禁止缓存，只需在自定义Nginx配置中添加8行核心代码，再配合后端设置3个响应头，就能实现SSE的实时、稳定推送。