修改 Nginx 配置後如何讓新設定生效且不中斷服務?本文總結從暴力 kill 到優雅平滑重啟的多種方式,並提供生產環境可用的健全腳本。
| 指令 | 信號 | 行為 | 適用場景 |
|---|---|---|---|
nginx -s reload | SIGHUP | Master 重讀配置、啟動新 Worker、舊 Worker 處理完現有連線後優雅退出 | **生產環境首選** |
nginx -s reopen | SIGUSR1 | 重新打開日誌檔(配合 logrotate) | 日誌切割 |
nginx -s stop | SIGTERM | 快速關閉,立即終止所有 Worker | 緊急停機 |
nginx -s quit | SIGQUIT | 優雅關閉,處理完當前請求再退出 | 計畫性維護 |
| SIGHUP | 同上 reload,適用無 systemd 環境 | 容器/嵌入式 | |
systemctl reload nginx | - | systemd 管理單元標準重載 | Systemd 系統 |
過程中**零停機**、連線不中斷、記憶體短暫雙倍(舊+新 Worker 共存)。
/usr/local/sbin/nginx-reload.sh#!/bin/bash
set -euo pipefail
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/reload.log"
log() { echo "[$(date '+%F %T')] $*" | tee -a "$LOG_FILE"; }
# 1. 語法檢查
log "測試配置語法..."
if ! $NGINX_BIN -t -c "$NGINX_CONF" 2>&1 | tee -a "$LOG_FILE"; then
log "❌ 配置語法錯誤,中止重啟"
exit 1
fi
log "✅ 語法檢查通過"
# 2. 判斷 Master 進程是否存在
if [[ -f "$PID_FILE" ]] && kill -0 "$(cat "$PID_FILE")" 2>/dev/null; then
log "執行平滑重啟 (SIGHUP)..."
kill -HUP "$(cat "$PID_FILE")"
sleep 2
# 驗證新 Worker 是否啟動
NEW_PID=$(cat "$PID_FILE" 2>/dev/null || echo "")
if [[ -n "$NEW_PID" ]] && kill -0 "$NEW_PID" 2>/dev/null; then
log "✅ 平滑重啟成功,新 Master PID: $NEW_PID"
else
log "⚠️ PID 檔異常,嘗試強制重啟..."
$NGINX_BIN -s stop 2>/dev/null; sleep 1
$NGINX_BIN -c "$NGINX_CONF"
fi
else
log "Master 進程不存在,執行冷啟動..."
$NGINX_BIN -c "$NGINX_CONF"
log "✅ 冷啟動完成"
fi
chmod +x /usr/local/sbin/nginx-reload.sh # sudoers 免密(可選) echo "www ALL=(root) NOPASSWD: /usr/local/sbin/nginx-reload.sh" > /etc/sudoers.d/nginx-reload
| 現象 | 原因 | 解決 |
|---|---|---|
| reload 後配置未生效 | 語法錯誤被靜默忽略 | **必須先執行 nginx -t**,檢查錯誤輸出 |
| 80/443 埠被佔用 | 舊進程未釋放/其他程序佔用 | ss -ltnp | grep :80 找出佔用者,或 nginx -s quit 後再啟動 |
| 日誌目錄不存在 | logrotate 刪除目錄未重建 | 配置 create 0640 nginx nginx 或 systemd ExecStartPre=mkdir -p /var/log/nginx |
| Worker 數異常 | worker_processes auto 在容器中誤判 | 容器中顯式設定 worker_processes 2 |
# Dockerfile FROM nginx:alpine COPY nginx.conf /etc/nginx/nginx.conf # 使用 docker kill -s HUP觸發平滑重啟 # 或採用 nginxinc/nginx-unprivileged 非 root 映像
黃金法則: **永遠先 nginx -t 再重載**,將語法檢查納入 CI/CD 流程,杜絕配置錯誤導致服務中斷。