Nginx的命令行控制

简介

本文内容摘自《深入理解Nginx》第二版 1.6节。

命令行控制

默认路径

默认安装路径是/usr/local/nginx，二进制文件路径为/usr/local/nginx/sbin/nginx，配置文件路径为
/usr/local/nginx/conf/nginx.conf。通过./configure选项可以修改，但这里以默认路径为准进行介绍。

显示帮助

/usr/local/nginx/sbin/nginx -h

或者 /usr/local/nginx/sbin/nginx -?

查看进程

ps -ef | grep nginx

版本与配置测试

显示版本信息：

/usr/local/nginx/sbin/nginx -v

显示版本信息与编译阶段的参数：

/usr/local/nginx/sbin/nginx -V

测试配置文件是否有误：

/usr/local/nginx/sbin/nginx -t

在测试配置阶段不输出错误级别以下的信息：

/usr/local/nginx/sbin/nginx -t -q

几种启动方式

默认启动：

/usr/local/nginx/sbin/nginx

指定配置文件启动：

/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf

另行指定安装目录启动：

/usr/local/nginx/sbin/nginx -p /usr/local/nginx/

另行指定全局配置项的启动方式：

/usr/local/nginx/sbin/nginx -g “pid /var/nginx/test.pid;”

注意：
    1. -g 后面的参数不能与默认路径下的 nginx.conf 中的配置项相冲突；
    2. 执行其他命令行时，需要把 -g 参数 也带上，否则可能出现配置项不匹配的情形；

停止服务

快速停止服务（直接向master进程发送TERM或者INT信号）：

/usr/local/nginx/sbin/nginx -s stop

或者 kill -s SIGTERM 

或者 kill -s SIGINT 

优雅地停止服务：

/usr/local/nginx/sbin/nginx -s quit

或者 kill -s SIGQUIT 

优雅地停止某个worker进程：

kill -s SIGWINCH 

重新加载配置项并生效

使运行中的Nginx重新加载nginx.conf文件：

/usr/local/nginx/sbin/nginx -s reload

或者 kill -s SIGHUP 

说明：Nginx会先检查配置项是否错误，如果全部正确，就优雅关闭再重启；

平滑升级

当Nginx服务升级到新版本时，必须要将旧的二进制文件nginx替换掉，通常情况下是需要重启服务的，但是Nginx
支持不重启服务来完成新版本的平滑升级。步骤如下：

第一步：通知正在运行的旧版本Nginx准备升级：

kill -s SIGUSR2 

第二步：启动新版本的Nginx

<上述中的任意一种启动方式均可>

注意：
    这时可以通过 ps 命令看到新旧版本的Nginx同时在运行。实际上第一步之后已经有两个Nginx同时运行;
    如果新旧nginx配置时的prefix参数不同，可能出现新nginx无法启动的现象；

第三步：通过kill命令向旧版本的master进程发送SIGQUIT信号，优雅关闭旧的Nginx。随后只有新版的Nginx在运行
，此时完成平滑升级。

kill -s SIGQUIT 

日志文件回滚

可以先将日志文件改名或转移到其他目录中（备份），使用如下命令重新打开日志时就会生成新的日志文件（使得
日志文件不至于过大）：

/usr/local/nginx/sbin/nginx -s reopen

或者 kill -s SIGUSR1 

阅读原文 | 作者官网 | 公众号 | Feed | 订阅 | 发私信