Nginx重启脚本

Nginx重启脚本

Nginx 作为高性能 Web 服务器，在配置调整或版本升级后通常需要重启才能生效。直接执行 `nginx -s reload` 虽然方便，但在生产环境中推荐使用脚本封装，以便统一管理、避免误操作，并记录操作日志。下面提供一套经过实践检验的 Nginx 重启脚本方案，覆盖编写、部署与验证流程。

脚本功能设计

一个稳健的重启脚本应包含以下能力：

• 检测 Nginx 配置文件语法是否正确
• 判断 Nginx 进程是否已在运行
• 支持启动、停止、重启、重载等操作
• 输出清晰的状态信息并记录日志
• 防止重复执行或误杀无关进程

编写基础脚本

以下是一个兼容 CentOS 7+ 与 Ubuntu 18.04+ 的 Nginx 管理脚本，假设 Nginx 安装在 `/usr/local/nginx`，并已配置 `nginx` 命令环境变量。您可根据实际路径调整。 bash #!/bin/bash

Description: Nginx start/stop/restart/reload script

Path: /usr/local/bin/nginx-ctl

NGINX_BIN=/usr/local/nginx/sbin/nginx NGINX_CONF=/usr/local/nginx/conf/nginx.conf PID_FILE=/usr/local/nginx/logs/nginx.pid LOG_FILE=/var/log/nginx-ctl.log

日志函数

log() { echo "$(date '+%Y-%m-%d %H:%M:%S') - $1" >> "$LOG_FILE" }

检查配置语法

check_config() { if $NGINX_BIN -t -c "$NGINX_CONF"; then log "配置检查通过" return 0 else log "配置检查失败" return 1 fi }

获取进程状态

status() { if [ -f "$PID_FILE" ] && kill -0 $(cat "$PID_FILE") 2>/dev/null; then echo "Nginx 正在运行 (PID: $(cat "$PID_FILE"))" return 0 else echo "Nginx 未运行" return 1 fi } start() { if status; then echo "Nginx 已启动，无需重复操作" return 0 fi check_config || exit 1 $NGINX_BIN -c "$NGINX_CONF" if status; then log "启动成功" echo "启动成功" else log "启动失败" echo "启动失败，请检查错误日志" exit 1 fi } stop() { if ! status; then echo "Nginx 未运行" return 0 fi $NGINX_BIN -s stop sleep 1 if status; then log "停止失败" echo "停止失败" exit 1 else log "停止成功" echo "停止成功" fi } restart() { stop start } reload() { if ! status; then echo "Nginx 未运行，执行启动" start return fi check_config || exit 1 $NGINX_BIN -s reload if [ $? -eq 0 ]; then log "重载成功" echo "重载成功" else log "重载失败" echo "重载失败" fi }

帮助信息

usage() { echo "用法: $0 {start|stop|restart|reload|status|help}" } case "$1" in start) start ;; stop) stop ;; restart) restart ;; reload) reload ;; status) status ;; help|"") usage ;; *) usage; exit 1 ;; esac

设置脚本权限

将脚本保存为 `/usr/local/bin/nginx-ctl` 后，执行： bash chmod +x /usr/local/bin/nginx-ctl 如果系统启用了 SELinux，请确认策略允许执行，或使用 `restorecon -v` 更新上下文。

使用场景示例

日常运维中，您可能需要：

• 重载配置文件（如修改了 gzip 或 server 块）
• 重启 Nginx（如升级了二进制或调整了核心模块）
• 快速查看状态

分别执行： bash nginx-ctl reload nginx-ctl restart nginx-ctl status 对于需要平滑重载的场景，`reload` 不会中断现有连接，推荐优先使用。只有在修改了监听端口或需要加载新模块时才执行 `restart`。

验证方法

任何脚本修改或 Nginx 配置变更后，建议按以下顺序验证： bash nginx-ctl status # 观察当前状态 nginx-ctl reload # 触发重载 nginx -T # 打印完整配置，进一步确认 tail -n 20 /var/log/nginx/error.log # 检查启动日志 如果出现异常，可快速使用 `nginx-ctl stop` 停止服务，然后手动启动排查。

注意事项

1. 脚本中的 `NGINX_BIN` 和 `NGINX_CONF` 路径必须与您的 Nginx 编译参数或安装位置一致，可通过 `nginx -V` 查看实际路径。
2. 生产环境建议在脚本中使用 `nginx -t` 做强制校验，避免因配置错误导致正在运行的服务不可用。
3. 停止操作使用 `nginx -s stop` 是快速关闭，如需等待请求处理完毕可使用 `nginx -s quit`。若需要优雅退出，可将 `stop()` 函数中的信号改为 `quit`。
4. 脚本日志文件需提前创建并赋予写权限，否则脚本会静默失败。推荐使用 `install -m 644 /dev/null /var/log/nginx-ctl.log` 创建空日志。
5. 若 Nginx 由 systemd 管理，建议直接使用 `systemctl reload nginx`，并将本脚本纳入运维应急通道，防止因手动启动与 systemd 状态不一致而出现管理混乱。
6. 每次修改脚本后，务必使用 `bash -n /usr/local/bin/nginx-ctl` 做语法检查。

回滚方式

当重载或重启后出现配置错误，导致服务失败时，迅速恢复：

1. 保存当前备用配置：`cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak`
2. 用已知正常的备份覆盖：`cp /etc/nginx/nginx.conf.bak /etc/nginx/nginx.conf`
3. 然后执行 `nginx-ctl reload` 或 `nginx-ctl start` 恢复正常。

建议在每周维护时段内对当前配置做一次全量备份，并将脚本纳入配置管理工具（如 Ansible）的发布流程中。 如有进一步需求，随时告诉我。