在 Linux 中,我们必须使用命令行来控制 Nginx 服务器行为。
- Nginx 默认安装目录为 /usr/local/nginx/ 。
- 执行文件默认路径为 /usr/local/nginx/sbin/nginx;
- 配置文件默认路径为 /usr/local/nginx/conf/nginx.conf。
这些默认路径,都可以在 configure 执行时进行配置。
1 启动
调用 Nginx 执行文件程序,它会读取默认路径下的配置文件 /usr/local/nginx/conf/nginx.conf,然后启动服务:
/usr/local/nginx/sbin/nginx
通过 ps 命令可以看到运行中的 nginx 进程:
ps -ef|grep nginx
运行结果:
也可以通过 -c 参数来指定 nginx 配置文件,形如:/usr/local/nginx/sbin/nginx -c xxx.conf
,这里的 c 是 configure 的简写。
2 检测配置文件中的信息是否正确
/usr/local/nginx/sbin/nginx -t
运行结果:
nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful
这里的 t 是 test 的简写形式。
3 显示 nginx 版本信息
/usr/local/nginx/sbin/nginx -v
运行结果:
nginx version: nginx/1.17.7
这里的 v 是 vertion 的简写形式。
还可以使用 -V 参数,显示更详细的版本信息,比如 GCC 编译器的版本,执行 configure 时的参数等内容:
/usr/local/nginx/sbin/nginx -V
运行结果:
nginx version: nginx/1.17.7
built by gcc 4.8.5 20150623 (Red Hat 4.8.5-39) (GCC)
configure arguments:
4 停止服务
停止服务分为快速与安全两种方式。
4.1 快速停止服务
/usr/local/nginx/sbin/nginx -s stop
-s stop 参数可以强制停止 Nginx 服务 。-s 参数其实让 Nginx 程序向正在运行的 Nginx 服务发送信号(s 是 send 的简写), Nginx 程序通过 nginx.pid 文件中得到 master 进程的进程 ID ,再向运行中的 master 进程发送 TERM 信号实现快速关闭 Nginx 服务。
执行前:
执行后:
可以看到,该命令执行后,nginx 的相关进程就消失了。
也可以通过 kill 命令直接向 nginx 的 master 进程发送 TERM 或者 INT 信号,但必须先通过 ps 指令得到 master process 的 PID。然后执行以下任意一个指令:
kill -s SIGTERM 5296
或
kill -s SIGINT 5296
这里的 5296 是 nginx master process 的 PID。
4.2 安全停止服务
当快速停止服务时, Nginx 的 worker 进程与 master 进程会在收到信号后立刻退出进程。而安全停止服务会先关闭监听端口,避免接收新的连接,然后处理完当前的连接,最后再退出进程。
/usr/local/nginx/sbin/nginx -s quit
也可以直接在 kill 指令发送 QUIT 信号给 Nginx master 进程来安全地停止服务:
首先通过 ps 指令找到 Nginx master 进程的 pid:
然后执行:
kill -s SIGQUIT 4426
还可以通过发送 WINCH 信号,来安全停止 Nginx worker 进程:
kill -s SIGWINCH 4488
5 重新加载配置
使用该命令,就可以使 Nginx 服务在不重启的情况下,重新加载 nginx.conf 文件:
/usr/local/nginx/sbin/nginx -s reload
内部实现过程是这样的: Nginx 会先检查新的配置是否正确,如果验证通过就以安全的方式停止服务,然后再重新启动服务。
类似的,也可以用 kill 命令发送 HUP 信号来达到相同的效果。
kill -s SIGHUP 4476
6 生成新的日志文件
我们可以先把当前日志文件(比如 logs/error.log)改名或备份到其它目录, 然后执行以下命令,这样 Nginx 生成新的日志文件。 通过这个功能可以避免日志文件过大。
/usr/local/nginx/sbin/nginx -s reopen
7 显示命令帮助说明
通过 -? 或者 -h 可以显示 Nginx 的命令帮助说明:
/usr/local/nginx/sbin/nginx -?