acceptex_read

`acceptex_read` 指令启用或禁用使用 AcceptEx 套接字选项来接受连接。 — NGINX Core

acceptex_read
events
语法acceptex_read on | off;
默认值off
上下文events
模块NGINX Core
参数flag

说明

`acceptex_read` 指令在 NGINX 的 `events` 上下文中使用,用于控制 NGINX 在接受传入连接时是否利用 AcceptEx 套接字函数。AcceptEx 是 Windows 专用的 API,允许服务器在接受连接后立即读取传入的数据,同时减少上下文切换并提高性能。当设置为 'on' 时,NGINX 将尝试在接受连接时使用此功能,因其在处理套接字连接方面的高效性,可能在高负载下带来更好的性能。然而,该功能仅适用于支持 AcceptEx 的 Windows 平台。 此指令的参数是一个标志,可以为 'on' 或 'off'。将其设置为 'on' 时,NGINX 在管理新连接时会使用 AcceptEx 功能。相反,设置为 'off' 则会使用常规的连接接收方法。需要注意的是,尽管利用 AcceptEx 可以提升性能,但可能会在某些网络配置下引入兼容性问题,从而影响应用行为。 评估服务器的负载、处理的流量类型以及底层基础设施,有助于决定是否启用此选项。应注意,此功能仅针对 Windows,并不会影响非 Windows 平台上的 NGINX 安装。在启用 AcceptEx 前应进行适当测试,以确保不会在环境中产生任何意外的副作用。

配置示例

events {
    acceptex_read on;
}

此指令仅适用于 Windows 操作系统,对 Unix/Linux 系统无任何影响。

启用 AcceptEx 可能会与某些网络配置产生兼容性问题;建议在启用后进行充分测试。