Nginx AIO不是简单启用即可生效的功能，需严格匹配内核版本（≥4.18）、编译选项（--with-file-aio）、系统库（libaio）及文件系统（XFS/ext4），并按场景选择真AIO（大文件+directio）或线程池模拟AIO（中小文件+sendfile），二者互斥不可混用。

Nginx 的异步文件 I/O（AIO）不是简单加一行 aio on; 就能生效的功能，它本质是让磁盘读不阻塞 worker 进程，但必须和底层系统能力、文件访问模式、配置组合严格匹配。配错不仅没加速，反而降低性能甚至导致启动失败。

核心原则：AIO 不是通用加速开关，而是按场景选路径——大文件走 AIO + directio，小文件靠 sendfile + page cache，二者互斥，不能混用。

---

先确认你的环境是否支持

• 内核版本：

  • 真 AIO（aio on）推荐 ≥ 4.18（最低需 ≥ 2.6.22，但旧内核只支持模拟）
  • 执行 uname -r 查看；再运行 zcat /proc/config.gz | grep CONFIG_AIO 确认 CONFIG_AIO=y

• Nginx 编译选项：

  • 必须含 --with-file-aio（主流发行版包如 nginx.org 官方版、Ubuntu nginx-full 通常已启用）
  • 检查命令：nginx -V 2>&1 | grep -o with-file-aio

• 系统库与文件系统：

  • 安装 libaio（yum install libaio 或 apt-get install libaio1）
  • 文件系统建议 XFS（首选）或 ext4（≥5.8 内核 + DAX 支持更稳）
  • 普通挂载无需特殊参数，但避免 noatime,nobarrier 与 directio 冲突

---

两种可用模式：选一个，别混搭

✅ 方式一：真内核 AIO（适合视频、ISO、大文件分发）

仅对 ≥ directio 阈值的大文件 生效，绕过页缓存，走 io_submit，要求严格：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

• 必须在 location 块内配置（不能写在 http 或 server 顶层）
• 必须搭配 directio（否则静默退化为同步读，或启动报错 "aio is not supported"）
• 必须关闭 sendfile（二者互斥）

典型配置：

location /dl/ {
    alias /data/downloads/;
    aio on;
    directio 4m;               # ≥4MB 文件才启用 directio + AIO
    directio_alignment 4k;     # XFS 下建议设为 4k，文件需按此对齐
    output_buffers 1 128k;
    sendfile off;
    tcp_nopush on;
}

⚠️ 注意：

• 文件未按 directio_alignment 对齐（如普通 cp 复制的 MP4），AIO 会自动回退同步读
• 小于 4MB 的 HTML/JS/CSS 启用此配置反而更慢（上下文切换开销 > 收益）

---

✅ 方式二：线程池模拟 AIO（aio threads，兼容性优先）

不依赖内核 AIO，也不绕过页缓存，适合中小文件混合场景（如网站静态资源），可与 sendfile on 共存：

• 需 Nginx 编译时含 --with-threads
• 全局定义线程池（放在 events 块外或 http 块顶部）
• location 中启用 aio threads=xxx，无需 directio，也不必关 sendfile

典型配置：

# 全局定义（一次即可）
thread_pool io_pool threads=32 max_queue=65536;

location /static/ {
    alias /data/static/;
    aio threads=io_pool;
    sendfile on;          # 可开启，线程池负责读取，sendfile 负责零拷贝发送
    tcp_nopush on;
}

✅ 优势：适配老旧内核、任意文件大小、无需对齐、不破坏 page cache
❌ 缺点：CPU 开销略高（线程调度），吞吐上限低于真 AIO

---

常见错误与避坑清单

• ❌ aio_write on; —— 不存在该指令，Nginx 启动直接报错 unknown directive "aio_write"
• ❌ aio on; 单独写在 http 块里 —— 不生效，可能静默 fallback 或启动失败
• ❌ aio on; + sendfile on; —— 配置冲突，Nginx 会拒绝加载或行为异常
• ❌ 对小文件（<1MB）全局启用 aio on —— 性能下降，因失去页缓存局部性优势
• ❌ 忽略 output_buffers 设置 —— 默认缓冲区太小（仅 32k），大文件易触发多次系统调用
• ❌ 未验证是否真正生效 —— 建议压测时用 perf record -e 'syscalls:sys_enter_io_submit' 或检查错误日志是否有 "aio is not supported"

不复杂但容易忽略。