• 运行和控制Nginx
  • nginx命令行参数
  • nginx控制信号
  • nginx 启动、停止、重启命令
  • 使用信号加载新的配置
  • 平滑升级到新的二进制代码

    运行和控制Nginx

    nginx命令行参数

    不像许多其他软件系统,Nginx 仅有几个命令行参数,完全通过配置文件来配置

    -c </path/to/config> 为 Nginx 指定一个配置文件,来代替缺省的。

    -t 不运行,而仅仅测试配置文件。nginx 将检查配置文件的语法的正确性,并尝试打开配置文件中所引用到的文件。

    -v 显示 nginx 的版本。

    -V 显示 nginx 的版本,编译器版本和配置参数。

    nginx控制信号

    可以使用信号系统来控制主进程。默认,nginx 将其主进程的 pid 写入到 /usr/local/nginx/nginx.pid 文件中。通过传递参数给 ./configure 或使用 pid 指令,来改变该文件的位置。

    主进程可以处理以下的信号:

    |TERM, INT|快速关闭
    |QUIT|从容关闭
    |HUP|重载配置 用新的配置开始新的工作进程 从容关闭旧的工作进程
    |USR1|重新打开日志文件
    |USR2|平滑升级可执行程序。
    |WINCH|从容关闭工作进程

    尽管你不必自己操作工作进程,但是,它们也支持一些信号:

    TERM, INT 快速关闭
    QUIT 从容关闭
    USR1 重新打开日志文件

    nginx 启动、停止、重启命令

    nginx启动

    sudo /usr/local/nginx/nginx (nginx二进制文件绝对路径,可以根据自己安装路径实际决定)

    nginx从容停止命令,等所有请求结束后关闭服务

    ps -ef |grep nginx

    kill -QUIT nginx主进程号

    nginx 快速停止命令,立刻关闭nginx进程

    ps -ef |grep nginx

    kill -TERM nginx主进程号

    如果以上命令不管用,可以强制停止

    kill -9 nginx主进程号

    如果嫌麻烦可以不用查看进程号,直接使用命令进行操作 其中/usr/local/nginx/nginx.pid 为nginx.conf中pid命令设置的参数,用来存放nginx主进程号的文件kill -信号类型(HUP|TERM|QUIT) cat /usr/local/nginx/nginx.pid例如

    1. kill -QUIT `cat /usr/local/nginx/nginx.pid`

    nginx重启命令

    nginx重启可以分成几种类型

    1.简单型,先关闭进程,修改你的配置后,重启进程。kill -QUIT cat /usr/local/nginx/nginx.pidsudo /usr/local/nginx/nginx 2.重新加载配置文件,不重启进程,不会停止处理请求 3.平滑更新nginx二进制,不会停止处理请求

    使用信号加载新的配置

    Nginx 支持几个信号,能在它运行时控制其操作。其中最普通的是 15 ,用来中止运行的进程:

    1. # <strong>ps aux | egrep '(PID|nginx)'</strong>
    2. USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
    3. root 2213 0.0 0.0 6784 2036 ? Ss 03:01 0:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
    4. # <strong>kill -15 2213</strong>

    而最有趣的是能平滑改变 nginx 配置的选项(请注意,在重载前,要先测试一下配置文件):

    1. #<strong> nginx -t -c /etc/nginx/nginx.conf</strong>
    2. 2006/09/16 13:07:10 [info] 15686#0: the configuration file /etc/nginx/nginx.conf syntax is ok
    3. 2006/09/16 13:07:10 [info] 15686#0: the configuration file /etc/nginx/nginx.conf was tested successfully
    4. #<strong> ps aux | egrep '(PID|nginx)'</strong>
    5. USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
    6. root 2213 0.0 0.0 6784 2036 ? Ss 03:01 0:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
    7. <strong># kill -HUP 2213</strong>

    当 nginx 接收到 HUP 信号,它会尝试先解析配置文件(如果指定配置文件,就使用指定的,否则使用默认的),成功的话,就应用新的配置文件(例如:重新打开日志文件或监听的套接 字)。之后,nginx 运行新的工作进程并从容关闭旧的工作进程。通知工作进程关闭监听套接字但是继续为当前连接的客户提供服务。所有客户端的服务完成后,旧的工作进程被关闭。 如果新的配置文件应用失败,nginx 将继续使用旧的配置进行工作。

    平滑升级到新的二进制代码

    你可以在不中断服务的情况下 - 新的请求也不会丢失,使用新的 nginx 可执行程序替换旧的(当升级新版本或添加/删除服务器模块时)。

    首先,使用新的可执行程序替换旧的(最好做好备份),然后,发送 USR2 (kill -USR2 pid)信号给主进程。主进程将重命名它的 .pid 文件为 .oldbin (比如:/usr/local/nginx/logs/nginx.pid.oldbin),然后执行新的可执行程序,依次启动新的主进程和新的工作进程:

    1. PID PPID USER %CPU VSZ WCHAN COMMAND
    2. 33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
    3. 33134 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
    4. 33135 33126 nobody 0.0 1380 kqread nginx: worker process (nginx)
    5. 33136 33126 nobody 0.0 1368 kqread nginx: worker process (nginx)
    6. 36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
    7. 36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
    8. 36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
    9. 36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)

    在这时,两个 nginx 实例会同时运行,一起处理输入的请求。要逐步停止旧的实例,你必须发送 WINCH 信号给旧的主进程,然后,它的工作进程就将开始从容关闭:

    1. PID PPID USER %CPU VSZ WCHAN COMMAND
    2. 33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
    3. 33135 33126 nobody 0.0 1380 kqread nginx: worker process is shutting down (nginx)
    4. 36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
    5. 36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
    6. 36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
    7. 36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)

    一段时间后,旧的工作进程处理了所有已连接的请求后退出,就仅由新的工作进程来处理输入的请求了:

    1. PID PPID USER %CPU VSZ WCHAN COMMAND
    2. 33126 1 root 0.0 1164 pause nginx: master process /usr/local/nginx/sbin/nginx
    3. 36264 33126 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
    4. 36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
    5. 36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
    6. 36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)

    这时,因为旧的服务器还尚未关闭它监听的套接字,所以,通过下面的几步,你仍可以恢复旧的服务器:

    • 发送 HUP 信号给旧的主进程 - 它将在不重载配置文件的情况下启动它的工作进程
    • 发送 QUIT 信号给新的主进程,要求其从容关闭其工作进程
    • 发送 TERM 信号给新的主进程,迫使其退出
    • 如果因为某些原因新的工作进程不能退出,向其发送 KILL 信号
      新的主进程退出后,旧的主进程会由移除 .oldbin 前缀,恢复为它的 .pid 文件,这样,一切就都恢复到升级之前了。

    如果尝试升级成功,而你也希望保留新的服务器时,发送 QUIT 信号给旧的主进程使其退出而只留下新的服务器运行:

    1. PID PPID USER %CPU VSZ WCHAN COMMAND
    2. 36264 1 root 0.0 1148 pause nginx: master process /usr/local/nginx/sbin/nginx
    3. 36265 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
    4. 36266 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)
    5. 36267 36264 nobody 0.0 1364 kqread nginx: worker process (nginx)

    原文: https://wizardforcel.gitbooks.io/nginx-doc/content/Text/1.4_nginxchscommandline.html