如何利用directio优化全局块中超大文件读取性能-Nginx-PHP中文网

directio 仅在匹配静态文件的 location 块中生效，需满足文件系统支持、块对齐、aio 配套、文件大小达标四前提，并须关闭 sendfile/gzip、开启 aio、设置 content-length 等配套参数。

如何利用directio优化全局块中超大文件读取性能

directio 不能用于“优化全局块”，它根本不在 http 块或 server 块顶层生效。所谓“全局配置 directio”是语法错误且逻辑无效——Nginx 不支持在 http 或 server 级别写 directio 1m，该指令仅允许出现在匹配静态文件的 location 块内，且必须满足一整套底层前提才能真正绕过页缓存。

只对特定 location 生效，不作用于 proxy_pass 或动态内容

directio 只在使用 root 或 alias 指向真实磁盘路径的静态文件服务 location 中起作用。例如分发 ISO 镜像或视频归档时：

✅ 正确： location ^~ /dl/iso/ { alias /data/mirror/; directio 4m; }
❌ 错误：放在 location /api/、location ~ \.php$ 或任何含 proxy_pass 的块里——完全不触发
❌ 错误：http { directio 1m; } —— Nginx 启动会报错或静默忽略

必须满足四类硬性前提，缺一即失效

即使 location 写对了，只要以下任一条件不满足，directio 就会静默退回到普通 buffered 读（无日志、无报错、但毫无优化效果）：

Synthesys

Synthesys是一款提供 AI 配音、数字人视频和图像生成的内容创作平台。

下载

文件系统支持：XFS 原生稳定；ext4 需内核 ≥5.8 + 挂载参数 dioread_nolock 或启用 DAX
块设备对齐：用 cat /sys/block/sda/queue/logical_block_size 查得逻辑块大小（常见 512B 或 4KB），Nginx 的 directio 值（如 4m）必须是其整数倍
Nginx 编译与配置配套：必须含 --with-file-aio，且配置中 aio on; 与 directio N; 必须成对出现
文件大小达标：只有 ≥ 设定阈值（如 directio 4m）的文件才走 direct I/O，小文件仍用 page cache

关键配套参数一个都不能少

单独开启 directio 不仅无效，反而可能拖慢甚至失败。必须同步关闭冲突机制并补全响应头：

sendfile off; —— sendfile 依赖 page cache，二者互斥
gzip off; —— 压缩需用户态完成，无法与 O_DIRECT 流水线协同
add_header Content-Length $sent_http_content_length; —— 若后端未返回该头，Nginx 必须能自行计算长度，否则 fallback 到低效 buffered 读
open_file_cache off; —— 防止为 GB 级文件长期持有大量 fd，避免耗尽