萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 網路安全 >  >> 網路應用技術 >> 應用程式教學

Nginx 平滑重啟與熱加載完整指令大全

修改 Nginx 配置後如何讓新設定生效且不中斷服務?本文總結從暴力 kill 到優雅平滑重啟的多種方式,並提供生產環境可用的健全腳本。

核心指令對照表

kill -HUP $(cat /var/run/nginx.pid)
指令信號行為適用場景
nginx -s reloadSIGHUPMaster 重讀配置、啟動新 Worker、舊 Worker 處理完現有連線後優雅退出**生產環境首選**
nginx -s reopenSIGUSR1重新打開日誌檔(配合 logrotate)日誌切割
nginx -s stopSIGTERM快速關閉,立即終止所有 Worker緊急停機
nginx -s quitSIGQUIT優雅關閉,處理完當前請求再退出計畫性維護
SIGHUP同上 reload,適用無 systemd 環境容器/嵌入式
systemctl reload nginx-systemd 管理單元標準重載Systemd 系統

平滑重啟原理深度解析

  1. Master 收到 SIGHUP
  2. 解析新配置檔,**語法錯誤則拒絕重載、舊配置繼續生效**(關鍵安全機制)
  3. 啟動新 Worker 進程組(新 PID)
  4. 舊 Worker 收到關閉通知,停止接受新連線,處理完 Keep-Alive 連線後退出
  5. 新 Worker 全面接管,Master 更新 PID 檔

過程中**零停機**、連線不中斷、記憶體短暫雙倍(舊+新 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 流程,杜絕配置錯誤導致服務中斷。

copyright © 萬盛學電腦網 all rights reserved