Web 服务器与网关 / 系统课时

复用上游连接

复用上游连接

本节解决 Nginx 反向代理场景中频繁创建上游 TCP 连接的问题,通过 upstream keepalive 让 Nginx 与后端服务复用连接,降低握手开销并提升高并发请求下的稳定性。

学习目标

  • 理解 upstream keepalive 的工作机制和适用场景。
  • 掌握代理 HTTP 版本与请求头配置对连接复用的影响。
  • 能够验证连接复用效果并定位配置错误。

理解上游连接复用机制

默认情况下,Nginx 作为代理访问上游服务时,请求完成后可能关闭与后端的连接。高流量场景中,大量短连接会增加 TCP 建立和释放成本,也可能造成后端服务连接压力。

upstream keepalive 会维护一组空闲上游连接池,当后续请求访问同一个后端节点时,可以直接复用已有连接。但它复用的是 Nginx 到 upstream 的连接,不影响客户端到 Nginx 的连接。

Nginx 到上游服务连接复用关系示意图

配置 upstream keepalive

upstream keepalive 需要与代理请求的 HTTP 版本和连接头配合使用。HTTP/1.1 默认支持持久连接,而 HTTP/1.0 需要显式开启 keep-alive,因此代理层必须正确设置版本。

示例配置如下,假设后端服务监听 <PORT>,实际端口需要根据部署环境替换。

nginx
upstream app_backend {
    server 127.0.0.1:<PORT>;

    # 保留空闲上游连接数量,不是最大连接总数
    keepalive 32;
}

server {
    listen 80;

    location / {
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_pass http://app_backend;
    }
}

预期结果

text
Nginx 配置加载成功。
客户端连续请求同一后端服务时,Nginx 可以复用已有上游连接。

keepalive 参数表示连接池中最多保存多少个空闲连接。如果请求量超过连接池容量,超出的连接仍会按正常生命周期创建和关闭。

验证连接是否复用

验证时不能只观察 HTTP 返回结果,需要结合 Nginx 日志、后端连接状态或抓包工具确认连接数量变化。可以先检查配置是否生效:

bash
nginx -t && nginx -s reload

预期输出

text
nginx: configuration file <PATH> test is successful

持续发送请求后,如果后端看到 TCP 新建连接数量明显下降,说明连接复用正在工作。

排查复用失败原因

连接复用失败通常不是 keepalive 参数本身错误,而是代理链路中的连接策略冲突。常见问题包括:

  • 使用 proxy_http_version 1.0 导致持久连接能力不足。
  • 设置 Connection: close 强制关闭后端连接。
  • 上游服务主动关闭空闲连接。
  • keepalive 数量过小,无法覆盖高峰请求。

排查时应先确认 Nginx 生效配置,再检查请求头和后端服务日志,不要只调整 keepalive 数值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

复用上游连接

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通