Nginx重启脚本

Nginx重启脚本

在日常运维中，Nginx 作为高性能 Web 服务器，经常需要调整配置、更新证书或排查故障。传统的重启方式往往是先 `kill` 主进程再启动，但这种方式可能导致请求丢失或配置错误未及时暴露。一个规范的重启脚本能帮助您安全、平滑地管理 Nginx 生命周期，尤其适合多实例或自动化部署场景。

为什么需要重启脚本

• 避免误操作：手动查找 PID 并发送信号容易出错，特别是在容器或虚拟环境中。
• 保证配置正确性：重启前自动执行 `nginx -t` 检查语法，防止无效配置导致服务中断。
• 平滑过渡：使用 reload 而不是 restart，可做到不关闭监听端口，优雅地加载新配置。
• 统一管理：脚本可集成到持续交付流程，实现一键重载或滚动更新。

Nginx 信号控制基础

Nginx 主进程支持多种信号，脚本主要依赖以下几个：

• `HUP`：重载配置，启动新 worker，平滑退出旧 worker。
• `USR2`：平滑升级二进制文件。
• `WINCH`：优雅关闭旧 worker（配合升级）。
• `TERM`：快速退出。
• `QUIT`：优雅退出。

对于常规配置变更，推荐使用 reload（HUP 信号），而不是完全重启。只有更换二进制文件或修改监听端口等内核级变更时，才需要真正的 restart。

编写安全的重启脚本

以下是一个基于 Bash 的参考脚本，具备配置检查、进程检测、选择执行 reload 或 restart 的功能。 bash #!/bin/bash

Nginx 安全重启/重载脚本

支持命令：./nginx_restart.sh {reload|restart|status}

NGINX_BIN="/usr/sbin/nginx" NGINX_CONF="/etc/nginx/nginx.conf" PID_FILE="/run/nginx.pid" usage() { echo "用法: $0 {reload|restart|status}" exit 1 }

检查 Nginx 配置

config_test() { $NGINX_BIN -t -c $NGINX_CONF if [ $? -ne 0 ]; then echo "配置错误，请先修复后再执行操作。" exit 1 fi }

检查进程是否在运行

is_running() { if [ -f $PID_FILE ] && kill -0 $(cat $PID_FILE) 2>/dev/null; then return 0 else return 1 fi }

平滑重载配置

reload() { config_test if is_running; then kill -HUP $(cat $PID_FILE) echo "Nginx 配置已平滑重载。" else echo "Nginx 未运行，尝试启动..." $NGINX_BIN -c $NGINX_CONF fi }

完全重启（先停止再启动）

restart() { config_test if is_running; then kill -QUIT $(cat $PID_FILE) sleep 1 fi $NGINX_BIN -c $NGINX_CONF echo "Nginx 已重启。" }

查看状态

status() { if is_running; then echo "Nginx 运行中 (PID: $(cat $PID_FILE))" else echo "Nginx 未运行" fi } case "$1" in reload) reload ;; restart) restart ;; status) status ;; *) usage ;; esac 将以上内容保存为 `/usr/local/bin/nginx_restart.sh`，并赋予执行权限： bash chmod +x /usr/local/bin/nginx_restart.sh

使用说明

| 命令 | 适用场景 | |------|---------| | `./nginx_restart.sh reload` | 修改站点配置、添加虚拟主机、调整 proxy 参数后执行 | | `./nginx_restart.sh restart` | 升级 Nginx 版本、编译新模块、修改核心 listen 端口时执行 | | `./nginx_restart.sh status` | 查看运行状态及 PID |

示例输出

bash $ sudo /usr/local/bin/nginx_restart.sh reload nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful Nginx 配置已平滑重载。

注意事项

• 使用前请备份配置：即使脚本已做语法检查，仍建议在改动前 `cp nginx.conf nginx.conf.bak`。
• 确认 PID 文件路径：不同系统或包管理器可能将 PID 文件放在 `/var/run/nginx.pid` 或 `logs/nginx.pid`，请根据实际情况调整。
• 避免频繁重启：业务高峰期使用 reload，不要无意义地 restart，以免连接中断。
• 权限控制：脚本可能需要 root 权限来执行 `kill` 或启动进程，建议通过 sudo 调用，而非直接以 root 运行守护任务。
• 日志追踪：若 reload 后出现异常，通过 `systemctl status nginx` 或 `/var/log/nginx/error.log` 排查。

回滚方式

如果新配置引发故障，您可以利用备份文件快速回滚并重载： bash

恢复备份

cp /etc/nginx/nginx.conf.bak /etc/nginx/nginx.conf

重新执行脚本

/usr/local/bin/nginx_restart.sh reload 若不幸无法连接服务，可强制停止并启动： bash kill -TERM $(cat /run/nginx.pid) /usr/sbin/nginx 编写和使用重启脚本并不复杂，但它能显著降低人为失误风险。推荐您根据实际环境调整上述代码，将其集成到变更管理流程中，让每一次重载都有迹可循。如有进一步需求，随时告诉我。