配置 proxy_set_header connection "" 的核心目的是让 nginx 不向后端透传 connection 头，交由 http/1.1 默认行为决定连接复用，但必须配合 upstream keepalive 和 proxy_http_version 1.1 才生效。
配置 proxy_set_header Connection "" 的核心目的，是让 Nginx 不向后端透传任何 Connection 指令（比如 close 或 keep-alive），从而交由 HTTP/1.1 协议默认行为决定是否复用连接。但它不是孤立生效的指令——必须配合 upstream keepalive 和 HTTP 版本设置，否则无效甚至起反作用。
区分场景：普通长连接 vs WebSocket
同一个 Connection 头，在不同场景下含义完全不同，不能混用：
-
普通 HTTP 长连接（如 API 接口）：需要清空 Connection 头，即
proxy_set_header Connection ""，避免客户端带Connection: close干扰后端； -
WebSocket 连接：绝不能清空，而要设为
upgrade，且必须搭配Upgrade头和map动态判断，否则握手失败（返回 200 或 502，而非 101）。
普通长连接：三要素必须同时存在
仅写 proxy_set_header Connection "" 没用，它只是其中一环。真正启用上游连接池，需以下三项缺一不可：
- upstream 块中声明
keepalive N;（例如keepalive 32;），表示每个 worker 缓存最多 N 个空闲连接； - location 中启用
proxy_http_version 1.1;，HTTP/1.0 不支持长连接语义； - location 中清除干扰头：
proxy_set_header Connection "";（注意是空字符串，不是"close"或"keep-alive"）。
典型配置示例：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
upstream backend {
server 10.0.1.10:8080;
keepalive 64;
}
server {
location /api/ {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
WebSocket 场景：严禁清空 Connection
WebSocket 升级依赖请求头中明确包含 Connection: upgrade 和 Upgrade: websocket。若写成 proxy_set_header Connection ""，Nginx 会删掉该头，后端收不到升级指令，直接拒绝或降级为普通 HTTP。
正确做法是用 map 动态设置：
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
location /ws/ {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_read_timeout 86400;
proxy_send_timeout 86400;
proxy_buffering off;
}
}
这样：有 Upgrade: websocket 时传 Connection: upgrade；没有时传 Connection: close，避免普通请求被误判。
验证是否生效的实用方法
别只看配置有没有写，要从实际流量和系统状态确认：
- 对普通长连接：用
ss -tan | grep :8080 | grep ESTABLISHED查看连接数是否稳定在keepalive × 后端节点数附近，而不是随请求暴涨； - 对 WebSocket：浏览器开发者工具里检查请求头是否有
Upgrade: websocket和Connection: upgrade，响应状态码是否为101 Switching Protocols； - 统一检查点：curl -v 访问接口，确认发出的请求中不包含
Connection头（普通场景）或包含正确值（WebSocket 场景）。
