Nginx命令速查手册:从配置检查到平滑升级,一键收藏备用
Nginx 作为现代架构的核心组件,其命令的熟练使用直接影响运维效率与系统稳定性。本文将按照基础操作、配置管理、进程控制、监控日志、故障排查及自动化实战的逻辑,系统梳理 Nginx 的核心命令与使用技巧,旨在为运维人员提供一份快速查阅的实操指南。
01基础控制操作
- 启动 Nginx
默认启动:nginx
指定配置文件:nginx -c /path/to/nginx.conf
指定工作目录:nginx -p /usr/local/nginx/ - 停止 Nginx
快速停止(可能丢失请求):nginx -s stop
优雅停止(推荐):nginx -s quit
区别:stop 立即终止进程,quit 等待请求处理完成 - 重载与重启
配置重载(无中断):nginx -s reload
完整重启(会中断):nginx -s stop && nginx
重载流程:Master 检查配置 -> 启动新 Worker -> 旧 Worker 优雅退出
02配置检查与调试
- 语法检查
检查默认配置:nginx -t
检查指定配置:nginx -t -c /etc/nginx/nginx.conf
输出完整生效配置:nginx -T - 调试技巧
查看最终配置:nginx -T | less
筛选特定配置段:nginx -T | grep 'server_name'
检查监听端口:nginx -T | grep 'listen'
03进程控制与信号管理
Nginx 支持通过信号对进程进行精细控制,以下是常用的信号类型及其对应的操作场景:
| 信号类型 | 操作命令 | 功能说明 |
|---|---|---|
| TERM, INT | nginx -s stop | 快速关闭服务,立即终止 worker 进程 |
| QUIT | nginx -s quit | 优雅关闭,处理完当前请求后退出 |
| HUP | nginx -s reload | 重载配置,平滑启动新的 worker 进程 |
| USR1 | kill -USR1 $(cat /var/run/nginx.pid) | 重新打开日志文件,用于日志切割 |
| USR2 | kill -USR2 $(cat /var/run/nginx.pid) | 平滑升级可执行程序,启动新 Master 进程 |
| WINCH | kill -WINCH $(cat /var/run/nginx.pid.oldbin) | 优雅关闭旧 worker 进程,配合升级使用 |
平滑升级流程通常包含:备份旧版本二进制文件 -> 替换新版本 -> 发送 USR2 信号启动新进程 -> 发送 WINCH 信号关闭旧 Worker。如需回滚,可向旧 Master 发送 HUP 信号。
04状态监控与日志分析
- 进程监控
查看进程树:ps auxf | grep nginx
查看 Master/Worker:ps -ef | grep nginx | grep -v grep
实时监控资源:top -p $(pgrep -d',' nginx) - 连接与端口
查看监听:netstat -tunlp | grep nginx (或 ss -tunlp)
统计连接数:netstat -an | grep :80 | wc -l
监控并发连接:watch "netstat -an | grep :80 | wc -l" - 日志分析
实时跟踪:tail -f /var/log/nginx/access.log
过滤错误:tail -f /var/log/nginx/error.log | grep '500'
IP 统计:awk '{print $1}' access.log | sort | uniq -c | sort -nr
05故障排查与性能调优
在遇到故障时,应首先通过版本信息和配置摘要定位问题,随后检查网络连接状态。
- 信息获取
查看版本及编译参数:nginx -V
查看生效配置摘要:nginx -T | grep -E '(server_name|listen|root)' - 网络诊断
检查端口冲突:netstat -tunlp | grep :80
检查上游服务器:curl -I http://upstream-server:port
检查 DNS 解析:nslookup your-domain.com - 性能检查
Worker 内存占用:ps -o pid,user,%mem,command ax | grep nginx
打开文件数:lsof -p $(cat /var/run/nginx.pid) | wc -l
TCP 连接状态统计:netstat -n | awk '/^tcp/ {++S[$NF]} END {for(a in S) print a, S[a]}'
06自动化运维脚本
以下脚本可用于日常健康检查与自动化部署,提升运维效率并减少人为失误。
- 健康检查脚本
#!/bin/bash
CONFIG_FILE="/etc/nginx/nginx.conf"
LOG_DIR="/var/log/nginx"
PID_FILE="/var/run/nginx.pid"
echo "=== Nginx健康检查 ==="
echo "检查时间: $(date)"
echo -n "配置语法检查: "
nginx -t -c $CONFIG_FILE >/dev/null && echo "✓ 正常" || echo "✗ 异常"
echo -n "主进程状态: "
[ -f $PID_FILE ] && ps -p $(cat $PID_FILE) >/dev/null && echo "✓ 运行中" || echo "✗ 未运行"
echo -n "80端口监听: "
netstat -tunlp | grep -q ':80 ' && echo "✓ 正常" || echo "✗ 异常" - 自动化部署脚本
#!/bin/bash
NGINX_CMD="nginx"
CONFIG_DIR="/etc/nginx/conf.d"
BACKUP_DIR="/backup/nginx/$(date +%Y%m%d)"
mkdir -p $BACKUP_DIR
echo "备份现有配置..."
cp -r $CONFIG_DIR $BACKUP_DIR/
echo "检查新配置语法..."
if ! $NGINX_CMD -t; then echo "配置语法检查失败,部署中止"; exit 1; fi
echo "重载Nginx配置..."
$NGINX_CMD -s reload
echo "验证服务状态..."
sleep 3
if systemctl is-active --quiet nginx; then echo "✓ Nginx部署成功"
else echo "✗ Nginx部署失败,开始回滚..."; cp -r $BACKUP_DIR/* $CONFIG_DIR/; $NGINX_CMD -s reload; exit 1; fi
07最佳实践总结
- 运维原则
修改配置前务必使用 nginx -t 测试语法
生产环境优先使用 reload 而非 restart
日志切割后使用 USR1 信号重新打开日志文件
版本升级使用 USR2/WINCH 信号实现平滑过渡 - 监控建议
设置基于错误日志和进程状态的监控报警
定期检查 worker 进程的资源占用与打开文件数
关注 TCP 连接状态分布,识别潜在网络问题
当前文章无评论,是时候发表评论了