sendfile 是内核零拷贝传输的启动信号,需 tcp_nopush on、tcp_nodelay off 及真实本地静态文件三者同时满足才生效,否则自动回退至 read/write 模式。

sendfile 不是简单开关,而是整条内核直传路径的启动信号。它只在满足全部前提时才真正生效,否则自动回退到低效的 read/write 模式。
三个指令必须同时启用
单独写 sendfile on 没有意义,必须与另外两个指令协同:
- tcp_nopush on:让响应头和文件开头数据合并进同一个 TCP 报文段,避免小包泛滥
- tcp_nodelay off:关闭 Nagle 算法,允许内核暂存数据等待凑满 MSS;设为 on 会立即发包,直接抵消 tcp_nopush 效果
仅对真实本地静态文件有效
以下任一情况都会导致 sendfile 自动失效,Nginx 会悄悄切回用户态搬运:
- 使用 proxy_pass、fastcgi_pass 或 grpc_pass
- 启用了 gzip on、gzip_static on(但 .gz 文件缺失时)或 gunzip on
- 响应被 Lua 脚本、sub_filter、add_before_body 等改写
- 文件位于 NFSv3、FUSE、部分容器存储驱动挂载点等不支持 sendfile() 的文件系统
- 响应缺少 Content-Length 头(如 chunked 编码或动态生成内容)
推荐按资源类型做 location 级精准配置
不要在 http 块全局开启,应针对不同后缀分别控制:
- 图片类:location ~* \.(jpg|jpeg|png|webp|gif|avif|svg)$ 中启用 sendfile,并关闭 gzip
- 大文件类:location ~ \.(mp4|zip|iso|tar\.gz|dmg)$ 中额外加 sendfile_max_chunk 512k,防止单次传输阻塞事件循环
- 所有静态 location 建议加上 access_log off 和 expires,减少 I/O 干扰与重复请求
配套机制决定实际效果上限
核心三指令只是起点,还需加固底层支撑:
- 在 http 块中配置 open_file_cache max=10000 inactive=60s,缓存句柄与元信息,减少 stat()/open() 开销
- 确保 root 指向顶层目录,避免路径嵌套歧义(例如
location /static/ { root /data; }正确,root /data/static易出 404) - 用 strace -p $(pgrep nginx) -e trace=sendfile64 观察 worker 进程是否持续调用该系统调用,而非仅看配置是否加载成功











