Nginx Master 进程不重启,而是通过信号协同调度新旧 Worker:校验配置后 fork 新 Worker 复用监听 socket 接管新连接,旧 Worker 收到 QUIT 后停止 accept 但继续处理已有请求,超时或完成后退出,全程服务不中断。

Nginx 的 Master 进程本身并不“重启”,而是通过信号协同、进程生命周期管理和内核能力,驱动整个服务实现无缝配置更新——也就是常说的“平滑重启”。它的核心不是销毁再重建自己,而是调度新旧 Worker 协同工作,让服务始终在线。
Master 接收信号并校验配置
当执行 nginx -s reload 或向 Master 发送 SIGHUP 时,Master 不会退出,而是立即做两件事:
- 重新读取并语法校验
nginx.conf及所有include文件; - 若校验失败(如语法错误、路径不存在),直接报错退出 reload 流程,旧 Worker 继续运行,服务不受影响;
- 若校验通过,进入 fork 新 Worker 阶段,同时保持对旧 Worker 的全程管控。
复用监听 socket,避免端口冲突
新 Worker 能立刻处理请求的关键,在于它无需 bind/listen 就能接收新连接:
- Linux 内核支持
SO_REUSEPORT(现代系统默认启用),允许多个进程监听同一端口; - 更早版本中,Master 通过文件描述符继承机制,把已打开的监听 socket(如 fd=6、fd=7)直接传给新 Worker;
- 因此新旧 Worker 共享同一组 listen socket,客户端新建连接由内核负载均衡分发,自然落到新 Worker;
- 旧连接(如长轮询、WebSocket、大文件下载)仍由原 Worker 持有并完成,不被中断。
优雅终止旧 Worker,不丢请求
Master 在启动新 Worker 后,并不会立刻杀掉旧 Worker:
- 向旧 Worker 发送
QUIT信号,使其进入“优雅关闭”状态; - 旧 Worker 立即停止 accept 新连接,但继续处理所有已建立连接上的未完成请求;
- 若设置了
worker_shutdown_timeout 10s;,则最多等待 10 秒,超时后强制关闭剩余连接; - 若未设置该指令,旧 Worker 会一直等到所有活跃请求自然结束才退出。
全程可控,故障自动降级
Master 始终是唯一控制中心,确保过程可靠:
- 新 Worker 启动失败(如配置引用了不存在的 upstream),Master 记录 error.log,但不会杀旧 Worker;
- 旧 Worker 退出后,Master 将其从内部进程表移除,只保留健康的新 Worker;
-
nginx.pid文件内容不变(Master PID 不变),但内部 worker 数组已刷新,对外表现为“配置已生效”; - 可通过
ps aux | grep nginx观察到exiting与running并存的状态,这是平滑切换的典型特征。
本质上,无缝重启不是靠单个进程重启实现的,而是 Master 主导的一次协同交接:新 Worker 上岗、旧 Worker 安心收尾。只要配置正确、内核支持 socket 复用,这个过程就是确定且无感的。


















