控制 nginx

更改配置
轮换日志文件
动态升级可执行文件

nginx 可通过信号进行控制。默认情况下，主进程的进程 ID 会写入文件 /usr/local/nginx/logs/nginx.pid。此名称可在配置时或在 nginx.conf 中使用 pid 指令进行更改。主进程支持以下信号

TERM、INT快速关闭
QUIT正常关闭
HUP更改配置、与更改的时区保持同步（仅适用于 FreeBSD 和 Linux）、使用新配置启动新工作进程、正常关闭旧工作进程
USR1重新打开日志文件
USR2升级可执行文件
WINCH正常关闭工作进程

单个工作进程也可以通过信号进行控制，但这不是必需的。支持的信号有

TERM、INT快速关闭
QUIT正常关闭
USR1重新打开日志文件
WINCH异常终止以进行调试（需要启用 debug_points）

更改配置

为了让 nginx 重新读取配置文件，应向主进程发送 HUP 信号。主进程首先检查语法有效性，然后尝试应用新配置，即打开日志文件和新的监听套接字。如果失败，它会回滚更改并继续使用旧配置工作。如果成功，它会启动新工作进程，并向旧工作进程发送消息，要求它们正常关闭。旧工作进程会关闭监听套接字并继续为旧客户端提供服务。在为所有客户端提供服务后，旧工作进程会关闭。

我们通过一个示例来说明这一点。假设 nginx 在 FreeBSD 上运行，并且命令 

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，输出将变为 

  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)

PID 为 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 信号。然后，主进程将重新打开所有当前打开的日志文件，并将它们分配给一个非特权用户，该用户是工作进程运行的所有者。重新打开成功后，主进程关闭所有打开的文件，并向工作进程发送消息，要求它们重新打开文件。工作进程也会立即打开新文件并关闭旧文件。因此，旧文件几乎可以立即用于后处理，例如压缩。

动态升级可执行文件

为了升级服务器可执行文件，应首先将新可执行文件放在旧文件的位置。之后，应向主进程发送 USR2 信号。主进程首先将其具有进程 ID 的文件重命名为具有 .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 信号，它将向其工作进程发送消息，要求它们正常关闭，并且它们将开始退出 

  PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
33135 33126 nobody   0.0  1380 kqread nginx: worker process is shutting down (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)

一段时间后，只有新的工作进程将处理请求 

  PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/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)

应注意，旧主进程不会关闭其侦听套接字，并且可以管理它以在需要时重新启动其工作进程。如果由于某种原因新可执行文件无法正常工作，可以执行以下操作之一

如果新主进程退出，则旧主进程会从带有进程 ID 的文件名中丢弃 .oldbin 后缀。

如果升级成功，则应向旧主进程发送 QUIT 信号，并且只有新进程会保留 

  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)