控制 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)
需要注意的是，旧的主进程不会关闭其监听套接字，并且可以对其进行管理以在需要时重新启动其工作进程。如果由于某种原因新的可执行文件无法正常工作，可以执行以下操作之一
-
向旧的主进程发送 HUP 信号。旧的主进程将在不重新读取配置的情况下启动新的工作进程。之后，可以通过向新的主进程发送 QUIT 信号来优雅地关闭所有新进程。
-
向新的主进程发送 TERM 信号。然后，它将向其工作进程发送一条消息，要求它们立即退出，并且它们都将几乎立即退出。（如果由于某种原因新进程没有退出，则应向它们发送 KILL 信号以强制它们退出。）当新的主进程退出时，旧的主进程将自动启动新的工作进程。
如果新的主进程退出，则旧的主进程将从具有进程 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)