Nginx 是一款高性能的 HTTP 和反向代理服务器，同时也提供了 IMAP/POP3/SMTP 代理服务，其灵活的配置和高效的性能使其成为互联网基础设施中的重要组成部分，掌握 Nginx 的常用命令是运维和开发人员必备的技能，以下将详细介绍 Nginx 的核心命令及其使用场景。
Nginx 的启动命令是 nginx，直接在终端输入该命令即可启动 Nginx 服务，默认情况下，Nginx 会加载配置文件 nginx.conf，该文件通常位于 /usr/local/nginx/conf/ 或 /etc/nginx/ 目录下，启动后，可以通过 ps -ef | grep nginx 命令查看 Nginx 进程是否成功运行，如果需要指定配置文件，可以使用 -c 参数，nginx -c /path/to/custom.conf。-g 参数允许在命令行中设置配置指令的值，如 nginx -g 'worker_processes 4;',但这种方式通常仅用于临时调整。
停止 Nginx 服务有三种方式，分别适用于不同场景，第一种是快速停止，使用 nginx -s stop 命令，该命令会立即终止所有 Nginx 进程，可能会导致正在处理的请求中断，适用于紧急情况，第二种是优雅停止，使用 nginx -s quit 命令，该命令会等待所有请求处理完成后再关闭进程，是生产环境中推荐的停止方式，第三种是通过进程号停止，首先使用 ps -ef | grep nginx 找到主进程号（通常为 root 用户下的进程），然后通过 kill -QUIT 主进程号 命令停止，这种方式与 nginx -s quit 效果相同。
重新加载配置文件是 Nginx 运维中常用的操作，使用 nginx -s reload 命令，该命令会检测配置文件的语法是否正确，如果语法无误，则启动新的工作进程并优雅地关闭旧的工作进程，实现平滑升级，如果配置文件存在语法错误，Nginx 会输出错误信息并保持旧配置运行，此时需要修复配置后重新加载，重新加载过程中，服务不会中断,适合线上环境的热更新需求。
检查配置文件的语法是否正确可以使用 nginx -t 命令，该命令会测试配置文件的语法并尝试打开配置文件中定义的文件，检查路径是否有效。nginx -t -c /path/to/conf 可以指定测试特定的配置文件，如果配置正确，命令会输出 syntax is ok 和 test is successful；如果存在错误，会显示具体的错误行号和原因,便于快速定位问题。
查看 Nginx 的版本信息可以使用 nginx -v 命令，该命令仅显示 Nginx 的版本号；而 nginx -V 命令则会显示详细的版本信息，包括编译参数、模块支持等，这对于排查兼容性问题或确认功能支持非常有用，输出中可能包含 nginx version: nginx/1.21.0 和 configure arguments: --with-http_ssl_module 等信息。
日志管理是 Nginx 运维的重要环节，Nginx 提供了 nginx -s reopen 命令用于重新打开日志文件，通常用于日志轮转（logrotate）场景，当日志文件被移动或重命名后，通过该命令可以让 Nginx 生成新的日志文件，避免日志写入到旧的文件中，可以通过修改配置文件中的 access_log 和 error_log 指令来调整日志的路径和级别，error_log /var/log/nginx/error.log warn;。
以下是 Nginx 常用命令的总结表格：
| 命令 | 功能 | 示例 | 适用场景 |
|---|---|---|---|
nginx |
启动 Nginx 服务 | nginx |
初始启动服务 |
nginx -s stop |
快速停止服务 | nginx -s stop |
紧急情况，立即终止进程 |
nginx -s quit |
优雅停止服务 | nginx -s quit |
生产环境，等待请求完成 |
nginx -s reload |
重新加载配置 | nginx -s reload |
平滑更新配置，不中断服务 |
nginx -t |
测试配置文件语法 | nginx -t |
修改配置后检查语法 |
nginx -V |
显示详细版本信息 | nginx -V |
查看编译参数和模块支持 |
nginx -s reopen |
重新打开日志文件 | nginx -s reopen |
日志轮转时使用 |
在实际使用中，Nginx 的命令通常需要结合系统权限操作，例如在 Linux 系统中可能需要使用 sudo 提升权限，Nginx 的配置文件结构复杂，修改前建议备份原配置，避免因配置错误导致服务异常，对于生产环境，建议使用 systemctl 或 service 命令来管理 Nginx 服务，systemctl start nginx 和 systemctl reload nginx，这样可以更好地与系统集成，实现开机自启、日志管理等功能。
相关问答FAQs：
-
问：执行
nginx -s reload后，为什么配置没有生效？
答：可能的原因有两个：一是配置文件存在语法错误，导致 Nginx 未重新加载，可通过nginx -t检查语法；二是修改的配置指令需要 Nginx 重启才能生效，worker_processes等核心参数，而location或server块的修改通常支持热重载，确保修改的是正确的配置文件，并检查 Nginx 进程是否有权限读取新配置。 -
问：如何查看 Nginx 的错误日志？
答：Nginx 的错误日志路径由配置文件中的error_log指令定义，默认通常为/var/log/nginx/error.log，可以通过tail -f /var/log/nginx/error.log命令实时查看日志内容，或使用grep过滤特定错误信息，grep "invalid parameter" /var/log/nginx/error.log，如果日志路径未在默认位置，可通过nginx -T命令查看完整的配置信息,包括所有日志路径。
