Nginx 服务启停方式

1. 前言

---

nginx 安装后，接下来我们就要学习如何启动、停止、重启 nginx 的服务

对于 nginx 服务的启停控制，在 linux 系统中也有多种方式，比如：信号控制、命令行控制

信号控制：使用 nginx 服务的信号来控制，这种方式里面涉及到一些信号，重点是理解这些信号所代表的含义

命令行控制：使用 sbin 目录下的 nginx 可执行的二进制文件来控制，这种方式日常开发中使用的比较多，非常重要

2. 信号控制

---

信号控制：只需要给 master 进程发送信号就可以来控制 nginx，在学习日志分割、服务升级时会用到信号控制这种方式

想要操作 nginx 的 master 进程，就需要获取到 master 进程的进程 ID（PID）

a. 查看主进程 ID

方式一：运行以下命令查看 nginx 进程

1. ps -ef | grep nginx

方式二：通过 nginx.pid 文件查看 master 进程 PID

在使用 ./configure 命令预编译时，有两个参数 --prefix=PATH 用于指定 nginx 安装目录，--pid-path=PATH 用于指定 nginx 主进程 IP 存放位置，默认存放位置是 nginx 安装目录下的 logs/nginx.pid 文件中

运行以下命令查看 nginx 安装信息

1. /usr/local/nginx/sbin/nginx -V

发现安装目录为 /usr/local/nginx，未指定 pid 存放目录，则主进程 ID 存放位置为 /usr/local/nginx/logs/nginx.pid

运行以下命令查看文件内容，也就是 nginx 的 master 进程 ID

1. cat /usr/local/nginx/logs/nginx.pid

b. 信号控制用法

获取到 nginx 的主进程 ID 之后，能干什么

信号	作用	等同于
TERM/INT	立即关闭整个服务	nginx -s stop
QUIT	“优雅” 的关闭整个服务，worker 进程处理完当前用户请求再关闭	nginx -s quit
HUP	重读配置文件并使用服务对新配置项生效	nginx -s reload
USR1	重新打开日志文件，可以用来进行日志切割	nginx -s reopen
USR2	平滑升级到最新版的 nginx	-
WINCH	所有子进程不在接收处理新连接，相当于给 worker 进程发送 QUIT 指令	-

调用命令：

1. # signal：信号
2. # PID：nginx 的 master 线程 ID
3. kill -[signal] PID

使用示例：

1. # TERM：立即关闭 nginx 服务，1294 是 master 进程 ID
2. kill -TERM 1294
3. # QUIT：优雅的关闭 nginx 服务，1294 是 master 进程 ID
4. kill -QUIT 1294

也可以使用下面这种写法，将 master 进程的 ID 改为命令输出结果，就不需要查看进程 ID 值了

1. kill -TERM `cat /usr/local/nginx/logs/nginx.pid`

USR1 信号：发送该信号给 master 进程，告诉 nginx 重新开启日志文件

1. # 删除日志文件
2. rm -rf /usr/local/nginx/logs/access.log /usr/local/nginx/logs/error.log
3. # 运行以下命令会重新创建 access.log、error.log
4. kill -USR1 `cat /usr/local/nginx/logs/nginx.pid`

USR2信号：告诉 master 进程要平滑升级，将 nginx 从低版本升级到高版本，无需重启 nginx 服务，不影响用户访问

通过这两步操作之后，运行在服务器上的就是最新开启的 master 进程，具体怎么实现我们通过实例看下效果

给 master 进程发送 USR2 信号，可以看到打开了一份新的 master、worker 进程

1. kill -USR2 `cat /usr/local/nginx/logs/nginx.pid`

如下图所示，USR2 信号会生成 nginx.pid.oldbin 文件，用于记录旧的 master 进程 ID

假设我们确保 nginx 服务器已经升级成功，接下来运行以下命令

它的作用是等待旧的 worker 进程处理完用户请求后，将旧的 worker 进程和 master 进程都关闭掉

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

执行完命令之后，就可以发现只剩下新的 master、worker 进程

WINCH 信号：所有子进程不在接收处理新连接，只关闭 woker 进程，不关闭 master 进程

1. kill -WINCH `cat /usr/local/nginx/logs/nginx.pid`

QUIT 信号 和 WINCH 信号的区别？

都是等 worker 进程处理完当前用户请求再将 worker 进程关闭掉，WINCH 信号到此就结束了，而不会关闭 master 进程，但是 QUIT 信号会将 master 进程也关闭掉

3. 命令行控制

---

命令行控制：这种方式是使用 sbin 目录下的 nginx 可执行的二进制文件来进行 nginx 状态的控制

执行二进制文件的写法示例

1. # 相对路径
2. cd /usr/local/nginx/sbin
3. ./nginx -s reload
4. # 绝对路径
5. /usr/local/nginx/sbin/nginx -s reload
6. # 定义了环境变量或命令别名
7. nginx -s reload

运行以下命令查看都有哪些参数可用

1. nginx -h

参数	描述
-? 和 -h	显示帮助信息
-v	查看 nginx 版本号
-V	查看 nginx 版本号和配置信息
-t	测试配置文件语法是否正确
-T	测试配置文件语法是否正确，并输出用到的配置文件
-q	配置测试期间不显示非错误消息
-p	指定 nginx 的 prefix 路径，默认为：/usr/local/nginx
-c	指定 nginx 的 配置文件路径，默认为：conf/nginx.conf
-g	用于补充 nginx 配置，向 nginx 服务指定启动时应用全局的配置

-h

1. # 下面两个命令作用是一样的
2. nginx -?
3. nginx -h

-v

1. # 查看版本号
2. nginx -v
3. # 查看版本号和配置信息
4. nginx -V

-q

1. # 检测配置文件语法，运行命令可以看到没有错误信息，是正常的提示
2. nginx -t
3. # 因为没有错误信息，所以什么也没有输出（不显示非错误信息）
4. nginx -tq

当有错误信息时，才会输出内容

-s

给 master 进程发送信号控制 nginx 的状态，可用的信号：stop, quit, reopen, reload

1. # 快速关闭，类似于 TERM/INT 信号的作用，直接关闭 master、worker 进程
2. nginx -s stop
3. # 优雅关闭，类似于 QUIT 信号的作用，等待 worker 进程处理完请求再关闭 master、worker 进程
4. nginx -s quit
5. # 重新打开日志文件，类似于 USR1 信号的作用
6. nginx -s reopen
7. # 重载配置文件，类似于 HUP 信号的作用
8. nginx -s reload

-c

-c 参数用于指定 nginx 使用的配置文件，默认使用的是 nginx 安装目录下的 conf/nginx.conf

接下来，我们看下具体效果

首先，我们使用默认的 nginx.conf 创建出一个新的配置文件，用于测试使用

1. # 拷贝 nginx.conf 得到新的配置文件 abc.conf
2. cp /usr/local/nginx/conf/nginx.conf /usr/local/abc.conf

为了区分两个配置文件，我们修改一下 abc.conf，故意造成语法错误

运行以下命令进行语法检测，查看命令输出就可以发现读取的配置文件不同

1. # 没有指定配置文件，默认使用的是 /usr/local/nginx/conf/nginx.conf
2. nginx -t
3. # 检测 /usr/local/abc.conf 文件语法是否正常
4. nginx -tc /usr/local/abc.conf

当前，也可以在启动的时候指定配置文件，这种写法你可能在很多地方看到过

1. nginx -c /usr/local/abc.conf

-g

在 nginx.conf 中可以看到有个配置项用于指定 master 进程 ID 存放位置，默认是注释掉的

1. # pid logs/nginx.pid；

我们可以在启动 nginx 时使用 -g 参数补充配置，如：指定 master 进程 ID 存放位置

但是，一般情况下这些内容我们都会在 nginx.conf 中指定，很少通过 -g 参数指定配置

1. nginx -g "pid logs/abc.pid;"

使用 -g 参数指定 master 进程 ID 存放位置后，停止 nginx 服务会出现问题

1. nginx -s stop

可以发现并没有从 abc.pid 查找进程 ID，此时没有办法使用命令行关闭的

但可以使用信号控制关闭

1. kill -TERM `cat /usr/local/nginx/logs/abc.pid`