nginx多进程控制由master统一接收信号并经channel下发指令:master注册sighup等信号,worker忽略外部信号,仅轮询socketpair接收ngx_channel_t命令(如ngx_cmd_quit),实现有序优雅退出与配置重载。

Nginx 的多进程控制不靠 Worker 直接响应信号,而是由 Master 进程统一接收、解析并分发指令。整个机制围绕“信号入口唯一化 + channel 下发有序化”设计,既避免竞态,又保障优雅性。
Master 是唯一的信号接收者
只有 Master 进程注册了信号处理器(如 SIGHUP、SIGQUIT、SIGUSR1 等),Worker 进程在启动时主动忽略绝大多数外部信号。这种隔离防止多个 Worker 同时处理同一信号导致状态混乱。
- 执行 nginx -s reload 实际等价于 kill -SIGHUP $(cat nginx.pid),信号只发给 Master
- Worker 不会因收到 SIGHUP 而重启,也不会因 SIGUSR1 重开日志——这些动作全由 Master 主动协调
- 系统级强制终止(如 kill -9)虽可杀死任意进程,但会破坏优雅性,应避免用于 Worker
Worker 通过 channel socket 接收控制指令
每个 Worker 启动前,Master 用 socketpair() 创建一对 Unix 域套接字,父子进程各持一端,构成专属通信通道。Worker 持续轮询该 socket,等待 Master 发来的 ngx_channel_t 格式命令。
- 收到 NGX_CMD_QUIT 后,Worker 将 ngx_quit = 1,随后在事件循环中逐步关闭监听、拒绝新连接、完成存量请求后退出
- 收到 NGX_CMD_OPEN_CHANNEL 或 NGX_CMD_REOPEN 时,执行对应动作(如重开日志文件句柄)
- 该机制不依赖信号传递,避免信号丢失或排队延迟,确保指令必达、顺序执行
典型操作背后的信号与 channel 协同流程
每种常用命令都不是单一信号的简单转发,而是 Master 触发一连串内部动作,并通过 channel 与 Worker 配合完成。
- 重载配置(-s reload):Master 解析新配置 → fork 新 Worker → 通过 channel 向旧 Worker 发 QUIT → 旧 Worker 自主决定退出时机
- 优雅停止(-s quit):Master 关闭监听套接字 → 向所有 Worker 发 QUIT → Worker 进入 ngx_exiting = 1 状态,服务完当前连接后退出
- 平滑升级(-s upgrade):Master 收到 SIGUSR2 → 启动新版本 Master + Worker → 再发 SIGWINCH 给旧 Master → 旧 Master 通知旧 Worker 逐个退出
- 日志轮转(-s reopen):Master 收到 SIGUSR1 → 通过 channel 通知各 Worker 关闭并重新 open access/error 日志文件
不推荐也不需手动干预的 IPC 方式
Nginx 的 IPC 是内建且封闭的,用户无需、也不应自行调用底层机制。
- 不要尝试用 pthread_mutex 或 sem_wait 在 Worker 中做同步——这会阻塞事件循环,破坏并发能力
- 不要直接向 Worker 进程发信号(如 kill -QUIT $worker_pid),它大概率被忽略,且绕过 Master 状态管理
- 共享内存(如 limit_req_zone)用于数据共享,不是控制通道;UDS 或 Lua socket 可扩展通信,但属高级定制,非默认路径











