worker_rlimit_nofile用于设置每个Nginx worker进程最大文件描述符数,须置于main上下文,值需≤系统硬限制并匹配worker_connections及内核参数以保障高并发稳定。

要让 Nginx 在单机反向代理高并发场景下稳定运行,worker_rlimit_nofile 不是孤立配置项,它必须和系统级限制、内核参数、Nginx 自身连接模型协同调整。否则容易出现“502 Bad Gateway”、“Too many open files”或连接建立快但失败率高的问题。
明确 worker_rlimit_nofile 的作用和位置
这个指令设的是每个 worker 进程能打开的最大文件描述符数,不是全局总数,也不是连接数上限。它必须放在 main 上下文(即 nginx.conf 最外层),例如:
worker_rlimit_nofile 262144;不能写在 http、server 或 location 块里,否则启动报错“unknown directive”。它的值不能超过系统硬限制(ulimit -Hn),建议设为硬限制的 90% 左右,预留空间给日志、临时文件、上游 socket 等。
同步调整系统级资源限制
Nginx 启动时继承父进程的 ulimit,而 systemd 环境下默认不读取 /etc/security/limits.conf。所以需三步并行:
- 在 /etc/security/limits.conf 中添加(假设 Nginx 以 nginx 用户运行):
nginx soft nofile 262144
nginx hard nofile 262144 - 在 /etc/systemd/system/nginx.service.d/override.conf 中补充:
[Service]
LimitNOFILE=262144 - 执行 systemctl daemon-reload && systemctl restart nginx 生效(注意:reload 不重置 fd 限制,必须 restart)
匹配 events 块中的 worker_connections
worker_connections 是每个 worker 实际可处理的并发连接数,它必须 ≤ worker_rlimit_nofile,且建议保留 20%~30% 余量。例如:
worker_rlimit_nofile 262144;events {
worker_connections 200000;
use epoll;
multi_accept on;
}
若反向代理后端服务,每个客户端连接 + 每个 upstream 连接各占一个 fd,因此真实消耗远高于 client 数。设 20 万 connections 是较稳妥的上限。
调优关键内核参数
仅调 Nginx 和用户限制还不够,网络栈瓶颈会提前暴露。需在 /etc/sysctl.conf 中追加:
- fs.file-max = 3000000 —— 全局最大文件句柄数,应 ≥ 所有进程总和
- net.core.somaxconn = 65535 —— listen 队列长度,避免新连接被丢弃
- net.ipv4.ip_local_port_range = 1024 65535 —— 扩大临时端口范围,支撑大量 outbound 连接
- net.core.netdev_max_backlog = 5000 —— 网卡接收队列,防突发流量丢包
生效命令:sysctl -p
验证是否真正生效
重启后不要只看配置文件,要查运行时状态:
- 找一个 worker 进程 PID:ps -eo pid,comm | grep 'nginx: worker'
- 查看其实际限制:cat /proc/
/limits | grep "Max open files" —— Soft Limit 应等于你设的 worker_rlimit_nofile 值 - 检查内核参数:sysctl fs.file-max net.core.somaxconn
- 压测时观察 error.log 是否还有 “Too many open files” 或 “connect() failed (111: Connection refused)” 类错误
不复杂但容易忽略。










