nginx可以通过signals控制。默认,nginx主进程的进程ID写入“/usr/local/nginx/logs/nginx.pid”文件中。在配置阶段,这个名字可以被修改,或者在“nginx.conf”配置文件中,使用“pid”指令。

主进程支持下面的signals:

  • TERM, INT - 快速关闭
  • QUIT - 友好的关闭
  • HUP - 修改配置,保持一个时区的改变(仅FreeBSD&Linux),友好的关闭旧的工作进程,使用新配置创建新的工作进程
  • USR1 - 重新打开日志文件
  • USR2 - 升级可执行文件(nginx主程序)
  • WINCH - 友好的关闭所有的工作进程

单个的工作进程也可以通过signals控制,虽然并不需要,支持的signals有:

  • TERM, INT - 快速关闭
  • QUIT - 友好的关闭
  • USR1 - 重新打开日志文件
  • WINCH - 调试异常终止(需要开启debug_points指令)

改变配置

为了让nginx重新读取配置,”HUP“signal应该被发送给主进程。主进程首先对配置文件进行语法检测,之后尝试应用新的配置。打开日志文件,以及新的监听sockets。如果失败,回滚配置并继续使用旧的配置工作。如果生效,则开启新的工作进程,并发送消息给旧的工作进程,请求它们友好的关闭。旧的工作进程关闭监听的sockets并继续给旧的客户端提供服务,直到所有的客户端服务完毕,旧的工作进程关闭。

用下面的例子进行说明,假设nginx运行在 ”FreeBSD 4.x“,使用命令:


ps axw -o pid,ppid,user,%cpu,vsz,wchan,command | egrep '(nginx|PID)'

输出如下:



PID PPID USER %CPU VSZ WCHAN COMMAND




33126 1 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx




33127 33126 nobody 0.0 1380 kqread nginx: worker process (nginx)




33128 33126 nobody 0.0 1364 kqread nginx: worker process (nginx)




33129 33126 nobody 0.0 1364 kqread nginx: worker process (nginx)


当”HUP“signal发送给nginx主进程,输出如下:



PID PPID USER %CPU VSZ WCHAN COMMAND




33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx




33129 33126 nobody 0.0 1380 kqread nginx: worker process is shutting down (nginx)




33134 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)




33135 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)




33136 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)


上面可以发现,33129的工作进程,仍然在继续工作。一段时间后,输出如下:



PID PPID USER %CPU VSZ WCHAN COMMAND




33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx




33134 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)




33135 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)




33136 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)


此时,所有的旧的工作进程,都已经全部关闭。

日志文件轮询

为了轮询日志文件,这些日志文件首先应该被重命名(轮询的日志文件命名有一定的规律)。接着,发送”USR1“signal给主进程。主进程将重新打开所有当前打开的日志文件,并且分配给它们一个没有特权的用户作为owner用户(工程进行的运行用户,例如上节中的nobody)。重新打开成功后,主进程关闭所有打开的文件,并发送消息给工作进程,要求它们去重新打开日志文件。工作进程打开新文件,并马上关闭旧文件。结果,旧文件几乎立马可用于后处理,例如:压缩。

在线升级可执行文件

为了升级服务器,新的可执行文件应该首先被写入到旧文件中。接着,发送”USR2“signal给主进程。主进程首先重命名 ”存储进程ID的文件“(/usr/local/nginx/logs/nginx.pid)为一个新文件,后缀是”.oldbin“(/usr/local/nginx/logs/nginx.pid.oldbin),接着,启动一个新的可执行文件,反过来,再启动新的工作进程:



PID PPID USER %CPU VSZ WCHAN COMMAND




33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx




33134 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)




33135 33126 nobody 0.0 1380 kqread nginx: worker process (nginx)




33136 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)




36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx




36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)




36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)




36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)


之后,所有的工作进程(新的&旧的)继续接收请求。如果 ”WINCH“ signal发送给第一个主进程,它将发送消息给它的子工作进程,请求它们友好的关闭,然后子工作进程开始关闭:

一段时间后,只有新的工作进程来处理请求:

注意:旧的主进程并没有关闭它监听的sockets,当需要时,它仍然能够开启它的子工作进程。如果,由于某些原因,新的可执行文件工作不正常,可执行下面的一个:

  • 发送”HUP“signal给旧的主进程。旧的主进程,不用重新读取配置,并开启新的工作进程。之后,发送”QUIT“signal给新的主进程,新的进程将被友好的关闭。
  • 发送”TERM“signal给新的主进程。将发送消息给它的工作进程,要求它们迅速退出,新的工作进程迅速退出(如果因为某些原因,新的进程并未退出,应该发送”KILL“signal,强制它们退出)。当新的主进程退出,旧的主进程将自动的开启新的工作进程。

如果新的主进程退出,然后旧的主进程忽略 ”.oldbin“ 后缀文件。

如果升级成功,之后应该发送”QUIT“signal给旧的主进程,最后,只有新的进程会被保留下来:



PID PPID USER %CPU VSZ WCHAN COMMAND




36264 1 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx




36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)




36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)




36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)