指令参考

aio_write

aio_write 指令允许异步写入文件以提高性能。 — NGINX HTTP Core

aio_write
httpserverlocation
语法aio_write on | off;
默认值off
上下文http, server, location
模块NGINX HTTP Core
参数flag

说明

NGINX 中的 `aio_write` 指令启用异步文件写入，使服务器能够在不阻塞其他请求处理的情况下执行写操作。启用后，文件写入可以以非阻塞方式处理，从而释放资源并提高整体吞吐量。这在 I/O 操作可能成为瓶颈的高负载环境中尤其有利。该指令以一个标志作为参数，可设置为 'on' 或 'off'。设置为 'on' 时，服务器会利用内核级的异步写入支持。 要使用该指令，可在 http、server 或 location 块的上下文中指定它。根据底层操作系统的能力和配置，该指令可以利用各种异步机制（例如 Linux 的 AIO）来增强文件处理。但是，必须确保支持库和内核功能已正确配置，以实现预期的性能提升。启用 aio 后，应与其他 NGINX 配置结合使用，以最大化效率并确保其适用于当前的使用场景。

配置示例

server {
    listen 80;
    location /logs {
        aio_write on;
        root /var/log/nginx;
    }
}
⚠

确保底层文件系统支持异步 I/O 操作。并非所有文件系统都会按预期工作。

⚠

在某些场景中使用 aio_write 可能无法带来性能提升；最好在应用前后进行基准测试。

⚠

异步写入可能会引入错误处理方面的复杂性，而这些复杂性在同步操作中可能不存在。

相关指令

aiosendfiledirectio