nginx 的 sendfile 需满足“三开一避”才真正生效:必须同时启用 sendfile on、tcp_nopush on、tcp_nodelay off,并避开 gzip、内容改写、非本地文件系统、缺失 content-length、range 请求、动态响应头等退化条件。

要让 Nginx 的 sendfile 在静态文件传输中真正起效,不是加一行 sendfile on; 就完事。它是一套协同机制,必须满足“三开一避”——三个指令同时启用、所有退化条件全部避开,否则会悄无声息地回退到低效的 read()+write() 模式。
必须成对启用的核心指令
单独配置任意一项都无效,三者缺一不可:
- sendfile on;:激活内核零拷贝能力,跳过用户态缓冲区
- tcp_nopush on;:依赖 sendfile 路径,把响应头和文件起始数据合并进同一个 TCP 报文段,减少小包数量
-
tcp_nodelay off;:关闭 Nagle 算法;若设为
on,会强制立即发包,直接破坏tcp_nopush的攒包逻辑
哪些情况会让 sendfile 自动失效
即使配置全对,只要出现以下任一情形,Nginx 就会自动降级:
- 启用了
gzip on(运行时压缩必须进用户态) - 使用了
sub_filter、add_before_body等内容改写指令 - 文件位于 NFSv3、FUSE 或某些容器存储驱动挂载点(不支持
sendfile()系统调用) - 响应缺少
Content-Length(如代理后端未返回该头) - 客户端发起 Range 请求(如视频拖拽)
- 配置了
etag或动态expires(需运行时计算响应头)
按资源类型精准配置 location
不建议在全局 http 块盲目开启,应针对真实静态文件路径做细粒度控制:
-
图片类:
location ~* \.(jpg|jpeg|png|webp|gif|avif|svg)$ { root /var/www; sendfile on; tcp_nopush on; tcp_nodelay off; gzip off; } -
大文件类:
location ~ \.(mp4|zip|iso|tar\.gz|dmg)$ { sendfile on; tcp_nopush on; tcp_nodelay off; sendfile_max_chunk 512k; expires 7d; }(sendfile_max_chunk防止单次传输阻塞事件循环)
辅助优化项提升稳定性
这些不改变零拷贝路径,但能降低干扰、释放性能:
-
access_log off;:静态资源 location 中关闭访问日志,避免高并发 I/O 成瓶颈 -
open_file_cache max=10000 inactive=60s;:缓存文件句柄和元信息,减少重复 open/stat -
gzip_static on;:配合预压缩的.gz文件(如app.js.gz),仍走 sendfile 路径,比运行时压缩更高效 -
expires或Cache-Control:配合浏览器缓存,减少重复请求











