问题：keepalive include在Nginx中如何正确配置？

Question

在使用 Nginx 作为反向代理时，如何正确配置 `keepalive` 和 `include` 指令以提升后端连接性能？ `keepalive` 参数用于控制与上游服务器的持久连接数量，常与 `upstream` 块配合使用，而 `include` 通常用于引入外部配置文件。但在某些配置结构中，开发者可能会错误地试图在 `include` 中嵌套 `keepalive` 或将其作用域混淆，导致配置失效或语法错误。 常见的误区包括：将 `keepalive` 指令错误放置在 `http` 或 `server` 块中，而非 `upstream` 块内；或在使用 `include` 引入配置片段时未正确保留作用域结构。 如何正确使用 `include` 引入包含 `keepalive` 配置的文件，并确保其生效？同时，如何验证配置是否真正提升了连接复用效率？

Answer 1

一、理解 Nginx 中 keepalive 和 include 的作用域与用途

Nginx 是一个高性能的反向代理服务器，广泛用于 Web 服务架构中。在配置反向代理时，keepalive 和 include 是两个非常关键的指令。

• keepalive：用于控制与上游服务器之间的持久连接数量，通常用于 upstream 块中，以提升连接复用率，减少 TCP 握手开销。
• include：用于将外部配置文件引入当前配置文件，有助于模块化管理配置，提高可维护性。

若配置不当，例如将 keepalive 放置在错误的作用域中，或使用 include 时破坏了配置结构，将导致配置失效甚至语法错误。

二、keepalive 的正确配置方式

keepalive 指令必须放置在 upstream 块内，用于指定与上游服务器保持的空闲连接的最大数量。以下是一个标准配置示例：

upstream backend {
    server 127.0.0.1:8080;
    keepalive 32;
}
  

上述配置中，Nginx 将维护最多 32 个空闲连接到上游服务器，从而避免每次请求都重新建立连接。

三、include 的使用与注意事项

include 指令常用于将多个配置片段集中管理。例如，我们可以将 upstream 配置单独保存在 conf.d/backend.conf 文件中：

# conf.d/backend.conf
upstream backend {
    server 127.0.0.1:8080;
    keepalive 32;
}
  

然后在主配置文件中通过 include 引入：

include conf.d/backend.conf;
  

注意：引入的文件必须保持其原有的作用域结构，不能将 keepalive 指令放置在 http 或 server 块中。

四、常见误区与解决方案

误区	问题描述	解决方案
keepalive 放置在错误位置	如放在 http 或 server 块中	确保 keepalive 仅出现在 upstream 块中
include 引入的文件结构混乱	文件内容未保留原作用域结构	保持引入文件中配置块的完整性，避免拆分结构

五、配置验证与性能测试

为了验证 keepalive 是否生效，可以使用如下方式：

1. 查看 Nginx 的连接状态日志，确认是否有连接复用行为。
2. 使用 netstat 或 ss 命令观察 Nginx 到后端的连接数量。
3. 通过 ab（Apache Benchmark）或 wrk 进行压力测试，对比启用 keepalive 前后的性能差异。

例如使用 ab 命令进行测试：

ab -n 1000 -c 100 http://localhost/
  

观察响应时间与每秒请求数（RPS），验证连接复用带来的性能提升。

六、配置结构的可视化流程图

graph TD
    A[Main Nginx Conf] --> B(include upstream conf)
    B --> C[upstream block]
    C --> D[keepalive directive]
    D --> E[Max idle connections]
    A --> F[server block]
    F --> G[proxy_pass to upstream]