搜索结果: "websocket"

title: Nginx 实时推送生产实践全解：SSE 与 WebSocket 的原理、架构、工程化与生产级落地

tags: [nginx, websocket, sse, production]

sources: [raw/articles/raw_Nginx-实时推送生产实践全解SSE-与-WebSocket-的原理架构工程化与生产级落地.md]

# Nginx 实时推送生产实践全解：SSE 与 WebSocket 的原理、架构、工程化与生产级落地

> 本文系统讲解如何把 SSE / WebSocket 从 Demo 升级到可交付、可扩展、可治理的生产级体系，涵盖协议原理、Nginx 事件模型、实时网关分层架构、生产级 Go 代码、连接治理、消息总线、Kubernetes 部署、容量规划、观测告警与故障排查。

## [2026-05-22] ingest | Nginx 实时推送生产实践全解：SSE 与 WebSocket 的原理、架构、工程化与生产级落地

|- 本文系统讲解 SSE/WebSocket 实时推送从 Demo 到生产级的完整体系，涵盖协议原理、Nginx 事件模型、四层架构、Go 生产代码、连接治理、消息总线、K8s 部署、容量规划与故障排查

|- 新增标签：websocket, sse（已注册到 SCHEMA.md）

|- Created raw: raw/articles/raw_Nginx-实时推送生产实践全解SSE-与-WebSocket-的原理架构工程化与生产级落地.md

| WebSocket 连接断 | `proxy_read_timeout` 太短 | WS 上游响应时长 | `proxy_read_timeout` ≥ 心跳间隔 |

### WebSocket 反代

### 14. WebSocket 需要升级头

WebSocket 的存活时间还受客户端、上游和负载均衡器限制；用真实客户端验证 ping/pong。

- [[nginx-realtime-push-guide]] — Nginx 实时推送生产实践全解：SSE 与 WebSocket 原理、架构、工程化与生产级落地

- [[nginx-upstream-timeout-deep-dive]] — Nginx upstream 超时配置底层逻辑 — 502/504 排查与变更安全手册。四个超时阶段（建连/发送/读取/失败摘除）。31 步完整排查流程（版本确认→语法检查→日志区分→upstream 时间字段→端口连通性→upstream 配置→被动失败→connect failed→真实响应头→connect/send/read timeout 区分→大请求上限→缓冲策略→WebSocket→keepalive 配套→连接与 fd→worker 限制→上游排队→慢请求关联→数据库验证→备份替换→回滚→灰度→验证→状态码统计→Prometheus→延迟分位数→DNS 解析→故障证据包）。常见误配分析（超时变大≠容量变大）。独立 location 隔离长任务。客户端/负载均衡器/上游时限一致性。

- websocket: WebSocket 协议与代理

| [[nginx-realtime-push-guide]] | SSE/WebSocket 实时推送全链路排障 |

| HTTP/2 / gRPC / WebSocket | 长连接场景流量更难重新分配 |

| [[nginx-realtime-push-guide]] | SSE/WebSocket 实时推送 — 代理超时/断连排查参考 |

SSE 与 WebSocket 实时推送的 Nginx 生产配置与踩坑注意事项参见 [[nginx-realtime-push-guide]]（代理缓冲/协议升级/会话保持/连接治理）。

| [[nginx-realtime-push-guide]] | SSE/WebSocket 实时推送 — 上线前超时/缓冲/会话保持检查 |

- [[nginx-realtime-push-guide]] — SSE/WebSocket 推送，WSS 安全配置参考